Stagehand: un marco para la implementación en lenguaje natural de operaciones de automatización de navegadores

Introducción general

Stagehand es un marco de navegación web de IA centrado en la simplicidad y la extensibilidad. Es totalmente compatible con Playwright y proporciona tres API de IA simples (actuar, extraer y observar) que se construyen sobre las clases subyacentes de Playwright Page, proporcionando los bloques de construcción para la automatización web a través del lenguaje natural. Stagehand facilita la escritura de código de automatización del navegador persistente y eficiente, especialmente para los usuarios no técnicos, y es menos sensible a los pequeños cambios en la interfaz de usuario y la DOM. Ya se trate de consultar las noticias más destacadas del día en Hacker News o de buscar y comprar productos en Amazon, Stagehand lo hace fácil. El framework se encuentra actualmente en su fase inicial y el equipo de desarrollo está buscando activamente la opinión de la comunidad.

Lista de funciones

• Proporciona tres sencillas API de IA: actuar, extraer y observar
• Totalmente compatible con Playwright
• Apoyo a la automatización web mediante lenguaje natural
• Proporcionar herramientas de depuración como la repetición de sesiones y la depuración paso a paso.
• Para usuarios no técnicos
• Insensible a pequeños cambios en la interfaz de usuario y el sistema operativo.
• Admite la integración con Browserbase para proporcionar herramientas de depuración más potentes.

Utilizar la ayuda

Proceso de instalación

1. Clona el proyecto Stagehand:

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

2. Instale la dependencia:

   npm install
npx playwright install

3. Ejecute el script de ejemplo:

   npm run example

Normas de uso

Crear un nuevo proyecto

Para crear un proyecto Stagehand configurado con los ajustes por defecto, puedes ejecutar el siguiente comando:

npx create-browser-app --example quickstart

Consulte la Guía de inicio rápido para obtener más información.

Añadir a proyecto existente

Puedes añadir Stagehand a un proyecto Typescript existente con el siguiente comando:

npm install @browserbasehq/stagehand zod
npx playwright install

Configuración de la clave API

Stagehand en su mejor momento requiere una clave de API de proveedor LLM y credenciales Browserbase. Para añadirlas a tu proyecto, ejecuta:

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

Funciones principales

1. actuar API: Se utiliza para realizar acciones como pulsar un botón, rellenar un formulario, etc.

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

2. extraer API: Se utiliza para extraer información, como texto, enlaces, etc. de una página.

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

3. observar API: Se utiliza para observar cambios en la página, como esperar a que aparezcan elementos, controlar la carga de la página, etc.

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

Herramientas de depuración

La integración de Stagehand con Browserbase proporciona potentes herramientas de depuración como la repetición de sesiones y la depuración paso a paso. Puedes habilitar estas herramientas siguiendo los pasos que se indican a continuación:

1. Añade la clave API de Browserbase al proyecto:

   nano .env  # 添加BROWSERBASE_API_KEY和BROWSERBASE_PROJECT_ID

2. Activar la repetición de sesión:

   await page.enableSessionReplay();

3. Activar la depuración paso a paso:

   await page.enableStepByStepDebugging();

Siguiendo estos pasos, podrás aprovechar al máximo la potencia de Stagehand para una automatización eficiente del navegador.