Stagehand: фреймворк для реализации операций автоматизации браузеров на естественном языке

Общее введение

Stagehand - это фреймворк для веб-браузинга с искусственным интеллектом, ориентированный на простоту и расширяемость. Он полностью совместим с Playwright и предоставляет три простых AI API (act, extract и observe), которые построены поверх базовых классов Playwright Page, обеспечивая строительные блоки для автоматизации веб-просмотра с помощью естественного языка.Stagehand делает написание постоянного, эффективного кода автоматизации браузера проще. и менее чувствительны к небольшим изменениям в пользовательском интерфейсе/доме. Будь то поиск лучших историй дня на Hacker News или поиск и покупка товаров на Amazon, Stagehand делает это проще. В настоящее время фреймворк находится на стадии раннего релиза, и команда разработчиков активно ищет отзывы сообщества.

Список функций

• Предоставляет три простых API ИИ: действовать, извлекать и наблюдать
• Полная совместимость с Playwright
• Поддержка веб-автоматизации с помощью естественного языка
• Предоставьте инструменты отладки, такие как воспроизведение сеанса и пошаговая отладка
• Для нетехнических пользователей
• Нечувствительность к незначительным изменениям пользовательского интерфейса/доступа к компьютеру
• Поддерживает интеграцию с Browserbase, предоставляя более мощные инструменты отладки

Использование помощи

Процесс установки

1. Клонируйте проект Stagehand:

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

2. Установите зависимость:

   npm install
npx playwright install

3. Запустите пример сценария:

   npm run example

Руководство по использованию

Создайте новый проект

Чтобы создать проект Stagehand с настройками по умолчанию, выполните следующую команду:

npx create-browser-app --example quickstart

Дополнительные сведения см. в руководстве по быстрому запуску.

Добавить к существующему проекту

Вы можете добавить Stagehand в существующий проект Typescript с помощью следующей команды:

npm install @browserbasehq/stagehand zod
npx playwright install

Настройка ключа API

Для оптимальной работы Stagehand требуется API-ключ провайдера LLM и учетные данные Browserbase. Чтобы добавить их в свой проект, выполните команду:

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

Основные функции

1. API: Используется для выполнения действий, таких как нажатие кнопки, заполнение формы и т.д.

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

2. API извлечения: Используется для извлечения информации, такой как текст, ссылки и т.д., со страницы.

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

3. наблюдать API: Используется для наблюдения за изменениями на странице, например, ожидание появления элементов, мониторинг загрузки страницы и т.д.

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

Средства отладки

Интеграция Stagehand с Browserbase предоставляет мощные инструменты отладки, такие как повтор сеанса и пошаговая отладка. Вы можете включить эти инструменты, выполнив следующие действия:

1. Добавьте ключ API Browserbase в проект:

   nano .env  # 添加BROWSERBASE_API_KEY和BROWSERBASE_PROJECT_ID

2. Включите воспроизведение сеанса:

   await page.enableSessionReplay();

3. Включите пошаговую отладку:

   await page.enableStepByStepDebugging();

Выполнив эти шаги, вы сможете в полной мере использовать возможности Stagehand для эффективной автоматизации работы браузера.