Stagehand: uma estrutura para implementação de linguagem natural de operações de automação do navegador

Introdução geral

O Stagehand é uma estrutura de navegação na Web com IA que se concentra na simplicidade e na extensibilidade. Ele é totalmente compatível com o Playwright e oferece três APIs de IA simples (act, extract e observe) que são construídas sobre as classes de página subjacentes do Playwright, fornecendo os blocos de construção para automação da Web por meio de linguagem natural. O Stagehand facilita a escrita de código de automação de navegador persistente e eficiente, especialmente para usuários não técnicos, e é menos sensível a pequenas alterações na UI/DOM. Seja para obter as principais histórias do dia no Hacker News ou para pesquisar e comprar produtos na Amazon, o Stagehand facilita as coisas. A estrutura está em fase inicial de lançamento e a equipe de desenvolvimento está buscando ativamente o feedback da comunidade.

Lista de funções

• Fornece três APIs de IA simples: agir, extrair e observar
• Totalmente compatível com o Playwright
• Suporte para automação da Web por meio de linguagem natural
• Fornecer ferramentas de depuração, como repetição de sessão e depuração passo a passo
• Para usuários não técnicos
• Insensível a pequenas alterações de UI/DOM
• Oferece suporte à integração com o Browserbase para fornecer ferramentas de depuração mais avançadas

Usando a Ajuda

Processo de instalação

1. Clone o projeto Stagehand:

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

2. Instale a dependência:

   npm install
npx playwright install

3. Execute o script de amostra:

   npm run example

Diretrizes para uso

Criar um novo projeto

Para criar um projeto do Stagehand configurado com as definições padrão, você pode executar o seguinte comando:

npx create-browser-app --example quickstart

Consulte o Guia de Início Rápido para obter mais informações.

Adicionar ao projeto existente

Você pode adicionar o Stagehand a um projeto Typescript existente com o seguinte comando:

npm install @browserbasehq/stagehand zod
npx playwright install

Configuração da chave de API

O Stagehand, em sua melhor forma, requer uma chave de API do provedor LLM e credenciais do Browserbase. Para adicioná-las ao seu projeto, execute:

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

Funções principais

1. agir APIUtilizado para executar ações, como clicar em um botão, preencher um formulário, etc.

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

2. extrair APIUsado para extrair informações, como texto, links, etc., de uma página.

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

3. observar a APIUsado para observar alterações na página, como aguardar o aparecimento de elementos, monitorar o carregamento da página etc.

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

Ferramentas de depuração

A integração do Stagehand com o Browserbase oferece ferramentas avançadas de depuração, como a reprodução de sessões e a depuração passo a passo. Você pode ativar essas ferramentas seguindo as etapas abaixo:

1. Adicione a chave da API do Browserbase ao projeto:

   nano .env  # 添加BROWSERBASE_API_KEY和BROWSERBASE_PROJECT_ID

2. Ativar a repetição da sessão:

   await page.enableSessionReplay();

3. Ativar a depuração passo a passo:

   await page.enableStepByStepDebugging();

Seguindo essas etapas, você poderá aproveitar ao máximo o poder do Stagehand para uma automação eficiente do navegador.