Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 52 additions & 22 deletions apps/docs/content/docs/de/tools/stagehand.mdx
Original file line number Diff line number Diff line change
@@ -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"
Expand All @@ -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`
54 changes: 42 additions & 12 deletions apps/docs/content/docs/es/tools/stagehand.mdx
Original file line number Diff line number Diff line change
@@ -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"
Expand All @@ -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
Expand All @@ -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`
Expand Down
58 changes: 44 additions & 14 deletions apps/docs/content/docs/fr/tools/stagehand.mdx
Original file line number Diff line number Diff line change
@@ -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"
Expand All @@ -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

Expand All @@ -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

Expand Down
Loading