Stagehand : un cadre pour la mise en œuvre en langage naturel des opérations d'automatisation des navigateurs

Introduction générale

Stagehand est un cadre de navigation Web IA axé sur la simplicité et l'extensibilité. Il est entièrement compatible avec Playwright et fournit trois API d'IA simples (agir, extraire et observer) qui sont construites au-dessus des classes de page Playwright sous-jacentes, fournissant les éléments de base pour l'automatisation du Web par le biais du langage naturel.Stagehand facilite l'écriture d'un code d'automatisation du navigateur efficace et persistant, en particulier pour les utilisateurs non techniques, et est moins sensible aux petites modifications de l'interface utilisateur et de la page d'accueil. Stagehand facilite l'écriture d'un code d'automatisation du navigateur efficace et persistant, en particulier pour les utilisateurs non techniques, et est moins sensible aux petites modifications de l'interface utilisateur et de la nomenclature. Qu'il s'agisse de trouver les meilleures histoires du jour sur Hacker News ou de rechercher et d'acheter des produits sur Amazon, Stagehand facilite les choses. Le framework est actuellement en version préliminaire et l'équipe de développement recherche activement les commentaires de la communauté.

Liste des fonctions

• Fournit trois API d'IA simples : agir, extraire et observer
• Entièrement compatible avec Playwright
• Prise en charge de l'automatisation du web par le langage naturel
• Fournir des outils de débogage tels que le rejeu de session et le débogage étape par étape.
• Pour les utilisateurs non techniques
• Insensible aux changements mineurs de l'interface utilisateur et de la nomenclature
• Prise en charge de l'intégration avec Browserbase pour fournir des outils de débogage plus puissants

Utiliser l'aide

Processus d'installation

1. Cloner le projet Stagehand :

   git clone https://github.com/browserbase/stagehand.git
cd stagehand

2. Installer la dépendance :

   npm install
npx playwright install

3. Exécutez l'exemple de script :

   npm run example

Lignes directrices pour l'utilisation

Créer un nouveau projet

Pour créer un projet Stagehand configuré avec les paramètres par défaut, vous pouvez exécuter la commande suivante :

npx create-browser-app --example quickstart

Voir le Guide de démarrage rapide pour plus d'informations.

Ajouter à un projet existant

Vous pouvez ajouter Stagehand à un projet Typescript existant avec la commande suivante :

npm install @browserbasehq/stagehand zod
npx playwright install

Configuration de la clé API

Stagehand a besoin d'une clé d'API de fournisseur LLM et d'informations d'identification Browserbase. Pour les ajouter à votre projet, exécutez :

cp .env.example .env
nano .env  # 编辑.env文件以添加API密钥

Principales fonctions

1. act API: Utilisé pour effectuer des actions telles que cliquer sur un bouton, remplir un formulaire, etc.

   await page.act('点击登录按钮');

2. extraire l'API: Permet d'extraire d'une page des informations telles que du texte, des liens, etc.

   const headlines = await page.extract('提取所有新闻标题');

3. observer l'API: Permet d'observer les modifications de la page, comme l'attente de l'apparition d'éléments, le suivi du chargement de la page, etc.

   await page.observe('等待加载完成');

Outils de débogage

L'intégration de Stagehand avec Browserbase offre de puissants outils de débogage tels que la relecture de session et le débogage étape par étape. Vous pouvez activer ces outils en suivant les étapes ci-dessous :

1. Ajouter la clé API Browserbase au projet :

   nano .env  # 添加BROWSERBASE_API_KEY和BROWSERBASE_PROJECT_ID

2. Activer la relecture de la session :

   await page.enableSessionReplay();

3. Activer le débogage pas à pas :

   await page.enableStepByStepDebugging();

En suivant ces étapes, vous pourrez tirer pleinement parti de la puissance de Stagehand pour une automatisation efficace du navigateur.