diff --git a/apps/docs/content/docs/de/tools/stagehand.mdx b/apps/docs/content/docs/de/tools/stagehand.mdx index 9e9a1d9215..2a1ffd0f31 100644 --- a/apps/docs/content/docs/de/tools/stagehand.mdx +++ b/apps/docs/content/docs/de/tools/stagehand.mdx @@ -1,6 +1,6 @@ --- -title: Stagehand Extract -description: Extract data from websites +title: Stagehand +description: Web-Automatisierung und Datenextraktion --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -11,43 +11,73 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" /> {/* MANUAL-CONTENT-START:intro */} -[Stagehand](https://stagehand.com) is a tool that allows you to extract structured data from webpages using Browserbase and OpenAI. +[Stagehand](https://stagehand.com) ist ein Tool, das sowohl die Extraktion strukturierter Daten aus Webseiten als auch autonome Web-Automatisierung mittels Browserbase und modernen LLMs (OpenAI oder Anthropic) ermöglicht. -With Stagehand, you can: +Stagehand bietet zwei Hauptfunktionen in Sim: -- **Extract structured data**: Extract structured data from webpages using Browserbase and OpenAI -- **Save data to a database**: Save the extracted data to a database -- **Automate workflows**: Automate workflows to extract data from webpages +- **stagehand_extract**: Extrahiert strukturierte Daten von einer einzelnen Webseite. Sie geben an, was Sie möchten (ein Schema), und die KI ruft die Daten in dieser Form von der Seite ab und analysiert sie. Dies eignet sich am besten zum Extrahieren von Listen, Feldern oder Objekten, wenn Sie genau wissen, welche Informationen Sie benötigen und woher Sie diese bekommen. -In Sim, the Stagehand integration enables your agents to extract structured data from webpages using Browserbase and OpenAI. This allows for powerful automation scenarios such as data extraction, data analysis, and data integration. Your agents can extract structured data from webpages, save the extracted data to a database, and automate workflows to extract data from webpages. This integration bridges the gap between your AI workflows and your data management system, enabling seamless data extraction and integration. By connecting Sim with Stagehand, you can automate data extraction processes, maintain up-to-date information repositories, generate reports, and organize information intelligently - all through your intelligent agents. +- **stagehand_agent**: Führt einen autonomen Web-Agenten aus, der in der Lage ist, mehrstufige Aufgaben zu erledigen, mit Elementen zu interagieren, zwischen Seiten zu navigieren und strukturierte Ergebnisse zurückzugeben. Dies ist viel flexibler: der Agent kann Dinge wie Anmeldungen, Suchen, Ausfüllen von Formularen, Sammeln von Daten aus verschiedenen Quellen durchführen und ein Endergebnis gemäß einem angeforderten Schema ausgeben. + +**Wesentliche Unterschiede:** + +- *stagehand_extract* ist ein schneller “extrahiere diese Daten von dieser Seite” Vorgang. Es funktioniert am besten für direkte, einstufige Extraktionsaufgaben. +- *stagehand_agent* führt komplexe, mehrstufige autonome Aufgaben im Web aus — wie Navigation, Suche oder sogar Transaktionen — und kann Daten dynamisch gemäß Ihren Anweisungen und einem optionalen Schema extrahieren. + +In der Praxis verwenden Sie **stagehand_extract**, wenn Sie wissen, was Sie wollen und woher, und **stagehand_agent**, wenn Sie einen Bot benötigen, der interaktive Arbeitsabläufe durchdenkt und ausführt. + +Durch die Integration von Stagehand können Sim-Agenten die Datenerfassung, -analyse und Workflow-Ausführung im Web automatisieren: Datenbanken aktualisieren, Informationen organisieren und benutzerdefinierte Berichte erstellen — nahtlos und autonom. {/* MANUAL-CONTENT-END */} -## Usage Instructions +## Gebrauchsanweisung -Integrate Stagehand into the workflow. Can extract structured data from webpages. +Integrieren Sie Stagehand in den Workflow. Kann strukturierte Daten aus Webseiten extrahieren oder einen autonomen Agenten ausführen, um Aufgaben zu erledigen. ## Tools ### `stagehand_extract` -Extract structured data from a webpage using Stagehand +Extrahieren Sie strukturierte Daten von einer Webseite mit Stagehand + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `url` | string | Ja | URL der Webseite, aus der Daten extrahiert werden sollen | +| `instruction` | string | Ja | Anweisungen für die Extraktion | +| `provider` | string | Nein | Zu verwendender KI-Anbieter: openai oder anthropic | +| `apiKey` | string | Ja | API-Schlüssel für den ausgewählten Anbieter | +| `schema` | json | Ja | JSON-Schema, das die Struktur der zu extrahierenden Daten definiert | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `data` | object | Extrahierte strukturierte Daten, die dem bereitgestellten Schema entsprechen | + +### `stagehand_agent` + +Führen Sie einen autonomen Web-Agenten aus, um Aufgaben zu erledigen und strukturierte Daten zu extrahieren -#### Input +#### Eingabe -| Parameter | Type | Required | Description | +| Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | -| `url` | string | Yes | URL of the webpage to extract data from | -| `instruction` | string | Yes | Instructions for extraction | -| `apiKey` | string | Yes | OpenAI API key for extraction \(required by Stagehand\) | -| `schema` | json | Yes | JSON schema defining the structure of the data to extract | +| `startUrl` | string | Ja | URL der Webseite, auf der der Agent starten soll | +| `task` | string | Ja | Die zu erledigende Aufgabe oder das zu erreichende Ziel auf der Website | +| `variables` | json | Nein | Optionale Variablen, die in der Aufgabe ersetzt werden sollen (Format: \{key: value\}). Referenzierung in der Aufgabe mit %key% | +| `format` | string | Nein | Keine Beschreibung | +| `provider` | string | Nein | Zu verwendender KI-Anbieter: openai oder anthropic | +| `apiKey` | string | Ja | API-Schlüssel für den ausgewählten Anbieter | +| `outputSchema` | json | Nein | Optionales JSON-Schema, das die Struktur der Daten definiert, die der Agent zurückgeben soll | #### Output -| Parameter | Type | Description | +| Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | -| `data` | object | Extracted structured data matching the provided schema | +| `agentResult` | object | Ergebnis der Stagehand-Agent-Ausführung | -## Notes +## Hinweise -- Category: `tools` -- Type: `stagehand` +- Kategorie: `tools` +- Typ: `stagehand` diff --git a/apps/docs/content/docs/es/tools/stagehand.mdx b/apps/docs/content/docs/es/tools/stagehand.mdx index 47bf4efcb2..47b63c3db7 100644 --- a/apps/docs/content/docs/es/tools/stagehand.mdx +++ b/apps/docs/content/docs/es/tools/stagehand.mdx @@ -1,6 +1,6 @@ --- -title: Stagehand Extract -description: Extrae datos de sitios web +title: Stagehand +description: Automatización web y extracción de datos --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -11,34 +11,42 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" /> {/* MANUAL-CONTENT-START:intro */} -[Stagehand](https://stagehand.com) es una herramienta que te permite extraer datos estructurados de páginas web utilizando Browserbase y OpenAI. +[Stagehand](https://stagehand.com) es una herramienta que permite tanto la extracción de datos estructurados de páginas web como la automatización web autónoma utilizando Browserbase y LLMs modernos (OpenAI o Anthropic). -Con Stagehand, puedes: +Stagehand ofrece dos capacidades principales en Sim: -- **Extraer datos estructurados**: Extraer datos estructurados de páginas web utilizando Browserbase y OpenAI -- **Guardar datos en una base de datos**: Guardar los datos extraídos en una base de datos -- **Automatizar flujos de trabajo**: Automatizar flujos de trabajo para extraer datos de páginas web +- **stagehand_extract**: Extrae datos estructurados de una sola página web. Especificas lo que quieres (un esquema), y la IA recupera y analiza los datos en esa forma desde la página. Esto es mejor para extraer listas, campos u objetos cuando sabes exactamente qué información necesitas y dónde obtenerla. -En Sim, la integración de Stagehand permite a tus agentes extraer datos estructurados de páginas web utilizando Browserbase y OpenAI. Esto permite escenarios de automatización potentes como extracción de datos, análisis de datos e integración de datos. Tus agentes pueden extraer datos estructurados de páginas web, guardar los datos extraídos en una base de datos y automatizar flujos de trabajo para extraer datos de páginas web. Esta integración cierra la brecha entre tus flujos de trabajo de IA y tu sistema de gestión de datos, permitiendo una extracción e integración de datos sin problemas. Al conectar Sim con Stagehand, puedes automatizar procesos de extracción de datos, mantener repositorios de información actualizados, generar informes y organizar información de manera inteligente, todo a través de tus agentes inteligentes. +- **stagehand_agent**: Ejecuta un agente web autónomo capaz de completar tareas de múltiples pasos, interactuar con elementos, navegar entre páginas y devolver resultados estructurados. Esto es mucho más flexible: el agente puede hacer cosas como iniciar sesión, buscar, completar formularios, recopilar datos de múltiples lugares y generar un resultado final según un esquema solicitado. + +**Diferencias clave:** + +- *stagehand_extract* es una operación rápida de “extraer estos datos de esta página”. Funciona mejor para tareas de extracción directas, de un solo paso. +- *stagehand_agent* realiza tareas autónomas complejas de múltiples pasos en la web — como navegación, búsqueda o incluso transacciones — y puede extraer datos dinámicamente según tus instrucciones y un esquema opcional. + +En la práctica, usa **stagehand_extract** cuando sabes qué quieres y dónde, y usa **stagehand_agent** cuando necesitas que un bot piense y ejecute flujos de trabajo interactivos. + +Al integrar Stagehand, los agentes de Sim pueden automatizar la recopilación de datos, el análisis y la ejecución de flujos de trabajo en la web: actualizando bases de datos, organizando información y generando informes personalizados, de manera fluida y autónoma. {/* MANUAL-CONTENT-END */} ## Instrucciones de uso -Integra Stagehand en el flujo de trabajo. Puede extraer datos estructurados de páginas web. Requiere clave API. +Integra Stagehand en el flujo de trabajo. Puede extraer datos estructurados de páginas web o ejecutar un agente autónomo para realizar tareas. ## Herramientas ### `stagehand_extract` -Extrae datos estructurados de una página web utilizando Stagehand +Extraer datos estructurados de una página web usando Stagehand #### Entrada -| Parámetro | Tipo | Requerido | Descripción | +| Parámetro | Tipo | Obligatorio | Descripción | | --------- | ---- | -------- | ----------- | | `url` | string | Sí | URL de la página web de la que extraer datos | | `instruction` | string | Sí | Instrucciones para la extracción | -| `apiKey` | string | Sí | Clave API de OpenAI para la extracción \(requerida por Stagehand\) | +| `provider` | string | No | Proveedor de IA a utilizar: openai o anthropic | +| `apiKey` | string | Sí | Clave API para el proveedor seleccionado | | `schema` | json | Sí | Esquema JSON que define la estructura de los datos a extraer | #### Salida @@ -47,6 +55,28 @@ Extrae datos estructurados de una página web utilizando Stagehand | --------- | ---- | ----------- | | `data` | object | Datos estructurados extraídos que coinciden con el esquema proporcionado | +### `stagehand_agent` + +Ejecutar un agente web autónomo para completar tareas y extraer datos estructurados + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `startUrl` | string | Sí | URL de la página web donde iniciar el agente | +| `task` | string | Sí | La tarea a completar o el objetivo a lograr en el sitio web | +| `variables` | json | No | Variables opcionales para sustituir en la tarea \(formato: \{key: value\}\). Referencia en la tarea usando %key% | +| `format` | string | No | Sin descripción | +| `provider` | string | No | Proveedor de IA a utilizar: openai o anthropic | +| `apiKey` | string | Sí | Clave API para el proveedor seleccionado | +| `outputSchema` | json | No | Esquema JSON opcional que define la estructura de los datos que el agente debe devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `agentResult` | objeto | Resultado de la ejecución del agente Stagehand | + ## Notas - Categoría: `tools` diff --git a/apps/docs/content/docs/fr/tools/stagehand.mdx b/apps/docs/content/docs/fr/tools/stagehand.mdx index 4dc5a7e060..905c35f751 100644 --- a/apps/docs/content/docs/fr/tools/stagehand.mdx +++ b/apps/docs/content/docs/fr/tools/stagehand.mdx @@ -1,6 +1,6 @@ --- -title: Stagehand Extract -description: Extraire des données de sites web +title: Stagehand +description: Automatisation web et extraction de données --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -11,20 +11,27 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" /> {/* MANUAL-CONTENT-START:intro */} -[Stagehand](https://stagehand.com) est un outil qui vous permet d'extraire des données structurées de pages web en utilisant Browserbase et OpenAI. +[Stagehand](https://stagehand.com) est un outil qui permet à la fois l'extraction de données structurées à partir de pages web et l'automatisation web autonome en utilisant Browserbase et les LLM modernes (OpenAI ou Anthropic). -Avec Stagehand, vous pouvez : +Stagehand offre deux capacités principales dans Sim : -- **Extraire des données structurées** : Extraire des données structurées de pages web en utilisant Browserbase et OpenAI -- **Enregistrer des données dans une base de données** : Sauvegarder les données extraites dans une base de données -- **Automatiser des flux de travail** : Automatiser des flux de travail pour extraire des données de pages web +- **stagehand_extract** : Extrait des données structurées d'une seule page web. Vous spécifiez ce que vous voulez (un schéma), et l'IA récupère et analyse les données dans cette forme à partir de la page. C'est idéal pour extraire des listes, des champs ou des objets lorsque vous savez exactement quelles informations vous avez besoin et où les obtenir. -Dans Sim, l'intégration Stagehand permet à vos agents d'extraire des données structurées de pages web en utilisant Browserbase et OpenAI. Cela permet des scénarios d'automatisation puissants tels que l'extraction de données, l'analyse de données et l'intégration de données. Vos agents peuvent extraire des données structurées de pages web, sauvegarder les données extraites dans une base de données et automatiser des flux de travail pour extraire des données de pages web. Cette intégration comble le fossé entre vos flux de travail IA et votre système de gestion de données, permettant une extraction et une intégration de données transparentes. En connectant Sim avec Stagehand, vous pouvez automatiser les processus d'extraction de données, maintenir des référentiels d'informations à jour, générer des rapports et organiser intelligemment les informations - le tout grâce à vos agents intelligents. +- **stagehand_agent** : Exécute un agent web autonome capable d'accomplir des tâches en plusieurs étapes, d'interagir avec des éléments, de naviguer entre les pages et de renvoyer des résultats structurés. C'est beaucoup plus flexible : l'agent peut faire des choses comme se connecter, rechercher, remplir des formulaires, recueillir des données de plusieurs endroits et produire un résultat final selon un schéma demandé. + +**Différences clés :** + +- *stagehand_extract* est une opération rapide “extraire ces données de cette page”. Il fonctionne mieux pour les tâches d'extraction directes en une seule étape. +- *stagehand_agent* effectue des tâches autonomes complexes en plusieurs étapes sur le web — comme la navigation, la recherche, ou même des transactions — et peut extraire dynamiquement des données selon vos instructions et un schéma optionnel. + +En pratique, utilisez **stagehand_extract** lorsque vous savez ce que vous voulez et où, et utilisez **stagehand_agent** lorsque vous avez besoin d'un bot pour réfléchir et exécuter des flux de travail interactifs. + +En intégrant Stagehand, les agents Sim peuvent automatiser la collecte de données, l'analyse et l'exécution de flux de travail sur le web : mise à jour de bases de données, organisation d'informations et génération de rapports personnalisés — de manière transparente et autonome. {/* MANUAL-CONTENT-END */} ## Instructions d'utilisation -Intégrez Stagehand dans le flux de travail. Peut extraire des données structurées à partir de pages web. Nécessite une clé API. +Intégrez Stagehand dans le flux de travail. Peut extraire des données structurées à partir de pages web ou exécuter un agent autonome pour effectuer des tâches. ## Outils @@ -35,17 +42,40 @@ Extraire des données structurées d'une page web en utilisant Stagehand #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | ---------- | ----------- | -| `url` | string | Oui | URL de la page web à partir de laquelle extraire des données | -| `instruction` | string | Oui | Instructions pour l'extraction | -| `apiKey` | string | Oui | Clé API OpenAI pour l'extraction \(requise par Stagehand\) | +| --------- | ---- | -------- | ----------- | +| `url` | chaîne | Oui | URL de la page web à partir de laquelle extraire les données | +| `instruction` | chaîne | Oui | Instructions pour l'extraction | +| `provider` | chaîne | Non | Fournisseur d'IA à utiliser : openai ou anthropic | +| `apiKey` | chaîne | Oui | Clé API pour le fournisseur sélectionné | | `schema` | json | Oui | Schéma JSON définissant la structure des données à extraire | #### Sortie | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `data` | object | Données structurées extraites correspondant au schéma fourni | +| `data` | objet | Données structurées extraites correspondant au schéma fourni | + +### `stagehand_agent` + +Exécuter un agent web autonome pour accomplir des tâches et extraire des données structurées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `startUrl` | chaîne | Oui | URL de la page web sur laquelle démarrer l'agent | +| `task` | chaîne | Oui | La tâche à accomplir ou l'objectif à atteindre sur le site web | +| `variables` | json | Non | Variables optionnelles à substituer dans la tâche (format : \{key: value\}). Référence dans la tâche en utilisant %key% | +| `format` | chaîne | Non | Pas de description | +| `provider` | chaîne | Non | Fournisseur d'IA à utiliser : openai ou anthropic | +| `apiKey` | chaîne | Oui | Clé API pour le fournisseur sélectionné | +| `outputSchema` | json | Non | Schéma JSON optionnel définissant la structure des données que l'agent doit renvoyer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `agentResult` | object | Résultat de l'exécution de l'agent Stagehand | ## Notes diff --git a/apps/docs/content/docs/fr/tools/trello.mdx b/apps/docs/content/docs/fr/tools/trello.mdx index 849f48f1f1..6929893ccf 100644 --- a/apps/docs/content/docs/fr/tools/trello.mdx +++ b/apps/docs/content/docs/fr/tools/trello.mdx @@ -45,8 +45,8 @@ Lister toutes les listes d'un tableau Trello | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `lists` | tableau | Tableau d'objets liste avec id, nom, fermé, pos et idBoard | -| `count` | nombre | Nombre de listes retournées | +| `lists` | array | Tableau d'objets liste avec id, name, closed, pos et idBoard | +| `count` | number | Nombre de listes retournées | ### `trello_list_cards` @@ -63,8 +63,8 @@ Lister toutes les cartes d'un tableau Trello | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `cards` | tableau | Tableau d'objets carte avec id, nom, desc, url, IDs de tableau/liste, étiquettes et date d'échéance | -| `count` | nombre | Nombre de cartes retournées | +| `cards` | array | Tableau d'objets carte avec id, name, desc, url, IDs de tableau/liste, étiquettes et date d'échéance | +| `count` | number | Nombre de cartes retournées | ### `trello_create_card` @@ -86,7 +86,7 @@ Créer une nouvelle carte sur un tableau Trello | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `card` | objet | L'objet carte créé avec id, nom, desc, url et autres propriétés | +| `card` | object | L'objet carte créé avec id, name, desc, url et autres propriétés | ### `trello_update_card` @@ -108,7 +108,7 @@ Mettre à jour une carte existante sur Trello | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `card` | objet | L'objet carte mis à jour avec id, nom, desc, url et autres propriétés | +| `card` | object | L'objet carte mis à jour avec id, name, desc, url et autres propriétés | ### `trello_get_actions` @@ -127,8 +127,8 @@ Obtenir l'activité/les actions d'un tableau ou d'une carte | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `actions` | tableau | Tableau d'objets action avec type, date, membre et données | -| `count` | nombre | Nombre d'actions retournées | +| `actions` | array | Tableau d'objets action avec type, date, member et data | +| `count` | number | Nombre d'actions retournées | ### `trello_add_comment` @@ -145,7 +145,7 @@ Ajouter un commentaire à une carte Trello | Paramètre | Type | Description | | --------- | ---- | ----------- | -| `comment` | objet | L'objet commentaire créé avec id, texte, date et membre créateur | +| `comment` | object | L'objet commentaire créé avec id, text, date et member creator | ## Notes diff --git a/apps/docs/content/docs/ja/tools/stagehand.mdx b/apps/docs/content/docs/ja/tools/stagehand.mdx index 9e9a1d9215..e23b8a2954 100644 --- a/apps/docs/content/docs/ja/tools/stagehand.mdx +++ b/apps/docs/content/docs/ja/tools/stagehand.mdx @@ -1,6 +1,6 @@ --- -title: Stagehand Extract -description: Extract data from websites +title: Stagehand +description: Webの自動化とデータ抽出 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -11,43 +11,73 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" /> {/* MANUAL-CONTENT-START:intro */} -[Stagehand](https://stagehand.com) is a tool that allows you to extract structured data from webpages using Browserbase and OpenAI. +[Stagehand](https://stagehand.com)は、BrowserbaseとモダンなLLM（OpenAIまたはAnthropic）を使用して、Webページからの構造化データの抽出と自律的なWeb自動化の両方を可能にするツールです。 -With Stagehand, you can: +StagehandはSimで2つの主要な機能を提供します： -- **Extract structured data**: Extract structured data from webpages using Browserbase and OpenAI -- **Save data to a database**: Save the extracted data to a database -- **Automate workflows**: Automate workflows to extract data from webpages +- **stagehand_extract**: 単一のWebページから構造化データを抽出します。必要なもの（スキーマ）を指定すると、AIがページからその形式でデータを取得して解析します。これは、必要な情報とその取得場所を正確に把握している場合に、リスト、フィールド、またはオブジェクトを抽出するのに最適です。 -In Sim, the Stagehand integration enables your agents to extract structured data from webpages using Browserbase and OpenAI. This allows for powerful automation scenarios such as data extraction, data analysis, and data integration. Your agents can extract structured data from webpages, save the extracted data to a database, and automate workflows to extract data from webpages. This integration bridges the gap between your AI workflows and your data management system, enabling seamless data extraction and integration. By connecting Sim with Stagehand, you can automate data extraction processes, maintain up-to-date information repositories, generate reports, and organize information intelligently - all through your intelligent agents. +- **stagehand_agent**: 複数ステップのタスクを完了し、要素と対話し、ページ間を移動し、構造化された結果を返すことができる自律型Webエージェントを実行します。これははるかに柔軟で、エージェントはログイン、検索、フォーム入力、複数の場所からのデータ収集、要求されたスキーマに従った最終結果の出力などを行うことができます。 + +**主な違い：** + +- *stagehand_extract*は迅速な“このページからこのデータを抽出する”操作です。直接的な一段階の抽出タスクに最適です。 +- *stagehand_agent*はWeb上で複雑な複数ステップの自律的なタスク（ナビゲーション、検索、さらには取引など）を実行し、指示とオプションのスキーマに従って動的にデータを抽出できます。 + +実際には、何が欲しいのかとその場所を知っている場合は**stagehand_extract**を使用し、インタラクティブなワークフローを考え実行するボットが必要な場合は**stagehand_agent**を使用します。 + +Stagehandを統合することで、Simエージェントはデータ収集、分析、Web上でのワークフロー実行を自動化できます：データベースの更新、情報の整理、カスタムレポートの生成を、シームレスかつ自律的に行います。 {/* MANUAL-CONTENT-END */} -## Usage Instructions +## 使用方法 -Integrate Stagehand into the workflow. Can extract structured data from webpages. +Stagehandをワークフローに統合します。ウェブページから構造化データを抽出したり、タスクを実行する自律型エージェントを実行したりできます。 -## Tools +## ツール ### `stagehand_extract` -Extract structured data from a webpage using Stagehand +Stagehandを使用してウェブページから構造化データを抽出する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `url` | string | はい | データを抽出するウェブページのURL | +| `instruction` | string | はい | 抽出のための指示 | +| `provider` | string | いいえ | 使用するAIプロバイダー：openaiまたはanthropic | +| `apiKey` | string | はい | 選択したプロバイダーのAPIキー | +| `schema` | json | はい | 抽出するデータの構造を定義するJSONスキーマ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `data` | object | 提供されたスキーマに一致する抽出された構造化データ | + +### `stagehand_agent` + +タスクを完了し構造化データを抽出するための自律型ウェブエージェントを実行する -#### Input +#### 入力 -| Parameter | Type | Required | Description | +| パラメータ | 型 | 必須 | 説明 | | --------- | ---- | -------- | ----------- | -| `url` | string | Yes | URL of the webpage to extract data from | -| `instruction` | string | Yes | Instructions for extraction | -| `apiKey` | string | Yes | OpenAI API key for extraction \(required by Stagehand\) | -| `schema` | json | Yes | JSON schema defining the structure of the data to extract | +| `startUrl` | string | はい | エージェントを開始するウェブページのURL | +| `task` | string | はい | ウェブサイトで完了するタスクまたは達成する目標 | +| `variables` | json | いいえ | タスクで置き換えるオプションの変数（形式：\{key: value\}）。タスク内で%key%を使用して参照 | +| `format` | string | いいえ | 説明なし | +| `provider` | string | いいえ | 使用するAIプロバイダー：openaiまたはanthropic | +| `apiKey` | string | はい | 選択したプロバイダーのAPIキー | +| `outputSchema` | json | いいえ | エージェントが返すべきデータの構造を定義するオプションのJSONスキーマ | -#### Output +#### 出力 -| Parameter | Type | Description | +| パラメータ | 型 | 説明 | | --------- | ---- | ----------- | -| `data` | object | Extracted structured data matching the provided schema | +| `agentResult` | object | Stagehandエージェント実行からの結果 | -## Notes +## 注意事項 -- Category: `tools` -- Type: `stagehand` +- カテゴリー: `tools` +- タイプ: `stagehand` diff --git a/apps/docs/content/docs/zh/tools/stagehand.mdx b/apps/docs/content/docs/zh/tools/stagehand.mdx index 3d3f43721e..6f84fc855a 100644 --- a/apps/docs/content/docs/zh/tools/stagehand.mdx +++ b/apps/docs/content/docs/zh/tools/stagehand.mdx @@ -1,6 +1,6 @@ --- -title: Stagehand Extract -description: 从网站提取数据 +title: Stagehand +description: 网页自动化和数据提取 --- import { BlockInfoCard } from "@/components/ui/block-info-card" @@ -11,20 +11,27 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" /> {/* MANUAL-CONTENT-START:intro */} -[Stagehand](https://stagehand.com) 是一款工具，可通过 Browserbase 和 OpenAI 从网页中提取结构化数据。 +[Stagehand](https://stagehand.com) 是一款工具，可以通过 Browserbase 和现代 LLMs（如 OpenAI 或 Anthropic）实现从网页中提取结构化数据以及自主网页自动化。 -使用 Stagehand，您可以： +Stagehand 在 Sim 中提供了两项主要功能： -- **提取结构化数据**：通过 Browserbase 和 OpenAI 从网页中提取结构化数据 -- **将数据保存到数据库**：将提取的数据保存到数据库中 -- **自动化工作流程**：自动化工作流程以从网页中提取数据 +- **stagehand_extract**：从单个网页中提取结构化数据。您可以指定所需内容（一个模式），AI 会从页面中以该格式检索并解析数据。这非常适合在您明确知道需要什么信息以及从哪里获取时，用于提取列表、字段或对象。 -在 Sim 中，Stagehand 集成使您的代理能够通过 Browserbase 和 OpenAI 从网页中提取结构化数据。这为数据提取、数据分析和数据集成等强大的自动化场景提供了可能。您的代理可以从网页中提取结构化数据，将提取的数据保存到数据库中，并自动化工作流程以提取数据。此集成弥合了 AI 工作流程与数据管理系统之间的差距，实现了无缝的数据提取和集成。通过将 Sim 与 Stagehand 连接，您可以自动化数据提取流程，维护最新的信息库，生成报告，并智能地组织信息——这一切都通过您的智能代理完成。 +- **stagehand_agent**：运行一个自主的网页代理，能够完成多步骤任务，与元素交互，在页面之间导航，并返回结构化结果。这更加灵活：代理可以执行登录、搜索、填写表单、从多个地方收集数据，并根据请求的模式输出最终结果。 + +**关键区别：** + +- *stagehand_extract* 是一个快速的“从这个页面提取这些数据”的操作。它最适合直接的、一步完成的提取任务。 +- *stagehand_agent* 执行复杂的、多步骤的自主网页任务，例如导航、搜索，甚至交易，并可以根据您的指示和可选的模式动态提取数据。 + +在实际应用中，当您知道需要什么以及在哪里时，请使用 **stagehand_extract**；当您需要一个机器人思考并执行交互式工作流程时，请使用 **stagehand_agent**。 + +通过集成 Stagehand，Sim 代理可以在网页上自动化数据收集、分析和工作流程执行：更新数据库、组织信息以及生成自定义报告——无缝且自主地完成。 {/* MANUAL-CONTENT-END */} ## 使用说明 -将 Stagehand 集成到工作流程中。可以从网页中提取结构化数据。需要 API 密钥。 +将 Stagehand 集成到工作流程中。可以从网页中提取结构化数据，或运行自主代理执行任务。 ## 工具 @@ -38,14 +45,37 @@ import { BlockInfoCard } from "@/components/ui/block-info-card" | --------- | ---- | -------- | ----------- | | `url` | string | 是 | 要提取数据的网页 URL | | `instruction` | string | 是 | 提取的指令 | -| `apiKey` | string | 是 | 用于提取的 OpenAI API 密钥 \(Stagehand 所需\) | +| `provider` | string | 否 | 要使用的 AI 提供商：openai 或 anthropic | +| `apiKey` | string | 是 | 所选提供商的 API 密钥 | | `schema` | json | 是 | 定义要提取数据结构的 JSON 架构 | #### 输出 | 参数 | 类型 | 描述 | | --------- | ---- | ----------- | -| `data` | object | 提取的与提供的模式匹配的结构化数据 | +| `data` | object | 符合提供架构的提取结构化数据 | + +### `stagehand_agent` + +运行自主网页代理以完成任务并提取结构化数据 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `startUrl` | string | 是 | 启动代理的网页 URL | +| `task` | string | 是 | 在网站上完成的任务或目标 | +| `variables` | json | 否 | 任务中可替换的可选变量（格式：\{key: value\}）。在任务中使用 %key% 引用 | +| `format` | string | 否 | 无描述 | +| `provider` | string | 否 | 要使用的 AI 提供商：openai 或 anthropic | +| `apiKey` | string | 是 | 所选提供商的 API 密钥 | +| `outputSchema` | json | 否 | 定义代理应返回数据结构的可选 JSON 架构 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `agentResult` | object | Stagehand 代理执行的结果 | ## 注意事项 diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index 903e93eb3b..f0ee3ef0c3 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -844,25 +844,35 @@ checksums: content/15: b3f310d5ef115bea5a8b75bf25d7ea9a content/16: a367df5277edf27ed08ff11b03279fdd abf533c0ff218cfc4166a55a9bd3a01f: - meta/title: fa81baef9ba5e794e519b71ad8a0bcf2 - meta/description: a6150e728da734390689627af1a2fd34 + meta/title: 01271b85ff001bf1a4a8d1730f570331 + meta/description: 78b809fd1f5ecde25dab06776f6090d6 content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 content/1: fdd8ecb5e550d9ed729ea0445c3c3ad1 - content/2: a0e89f4efd3f7a0474568bceef251e05 - content/3: c96320b1e7271f8b46b18556cf10f680 - content/4: 0cf4d7d650aec185fb41b3e92f507057 - content/5: 3816dfaf26ed3afd7aff9090710024f1 - content/6: 821e6394b0a953e2b0842b04ae8f3105 - content/7: e47a99fb84a6ba46b2f6bf91c26f842b - content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e - content/9: 0f2701a070121f0abbbf8cc289652330 - content/10: 18e01e99857573a423da69c5b4127487 - content/11: 371d0e46b4bd2c23f559b8bc112f6955 - content/12: d9f2aa90cdfac53f9a3b09225bb67700 - content/13: bcadfc362b69078beee0088e5936c98b - content/14: cca5bb45df434d1dd843d94eb9ac3f76 - content/15: b3f310d5ef115bea5a8b75bf25d7ea9a - content/16: c5ce52e3a765ca8ed0be639afb2eee7b + content/2: 6f77421e48f3fc5d9d226461657d5955 + content/3: 992b3abebfb89a1ba9ca3498b86079ff + content/4: 80d3d3ff22a583a17280020155880f42 + content/5: 7e97694717a88e22ca342219173d8007 + content/6: 2c10a97e08ea83f66da35433bba4b161 + content/7: cd0d728e5ece860818fd28cb492b7d51 + content/8: a2f4a9e48c0a82a5cf4776abac56f135 + content/9: d8c8b2d9dfb5aac795de26be43a7d9b9 + content/10: 821e6394b0a953e2b0842b04ae8f3105 + content/11: dfc1ee41d6b3e799ee65271d45fbe2a8 + content/12: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/13: 0f2701a070121f0abbbf8cc289652330 + content/14: 18e01e99857573a423da69c5b4127487 + content/15: 371d0e46b4bd2c23f559b8bc112f6955 + content/16: b7d7d051b6003de92f09eff59955c4e7 + content/17: bcadfc362b69078beee0088e5936c98b + content/18: cca5bb45df434d1dd843d94eb9ac3f76 + content/19: b09ace13f48c17268148d1602d105999 + content/20: 553d5f0825e9d426b9753e64dd596872 + content/21: 371d0e46b4bd2c23f559b8bc112f6955 + content/22: ea958419fd22c3fbd2f647aae2ddb32a + content/23: bcadfc362b69078beee0088e5936c98b + content/24: 08992483aceab1862eedadd4e0e374d5 + content/25: b3f310d5ef115bea5a8b75bf25d7ea9a + content/26: c5ce52e3a765ca8ed0be639afb2eee7b 14b4bb962f102a4a42dd93498f0cf40c: meta/title: 7b7b808a136ce10b6199c504e81fb902 meta/description: 9b77a5b1561b43c9f30bb06febc6ff6c