Stagehand — это инструмент, который позволяет как извлекать структурированные данные с веб-страниц, так и выполнять автономную веб-автоматизацию с использованием Browserbase и современных LLM (OpenAI или Anthropic).
Stagehand предлагает две основные возможности в AACFlow:
-
stagehand_extract: Извлечение структурированных данных с одной веб-страницы. Вы указываете, что хотите (схему), и AI извлекает и парсит данные в этой форме со страницы. Это лучше всего подходит для извлечения списков, полей или объектов, когда вы точно знаете, какая информация вам нужна и где ее получить.
-
stagehand_agent: Запуск автономного веб-агента, способного выполнять многошаговые задачи, взаимодействовать с элементами, перемещаться между страницами и возвращать структурированные результаты. Это гораздо более гибко: агент может выполнять такие действия, как вход в систему, поиск, заполнение форм, сбор данных из нескольких мест и вывод конечного результата в соответствии с запрошенной схемой.
Ключевые различия:
- stagehand_extract — это быстрая операция "извлечь эти данные с этой страницы". Она лучше всего работает для прямых, одношаговых задач извлечения.
- stagehand_agent выполняет сложные, многошаговые автономные задачи в интернете — такие как навигация, поиск или даже транзакции — и может динамически извлекать данные в соответствии с вашими инструкциями и опциональной схемой.
На практике используйте stagehand_extract, когда вы знаете, что хотите и где это найти, и используйте stagehand_agent, когда вам нужен бот, который будет продумывать и выполнять интерактивные рабочие процессы.
Интегрируя Stagehand, агенты AACFlow могут автоматизировать сбор данных, анализ и выполнение рабочих процессов в интернете: обновлять базы данных, организовывать информацию и генерировать пользовательские отчеты — бесшовно и автономно.
Инструкции по использованию
Интегрируйте Stagehand в рабочий процесс. Может извлекать структурированные данные с веб-страниц или запускать автономного агента для выполнения задач.
Инструменты
stagehand_extract
Извлечение структурированных данных с веб-страницы с использованием Stagehand
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
url | string | Да | URL веб-страницы для извлечения данных |
instruction | string | Да | Инструкции для извлечения |
provider | string | Нет | AI-провайдер для использования: openai или anthropic |
apiKey | string | Да | API-ключ для выбранного провайдера |
schema | json | Да | JSON-схема, определяющая структуру данных для извлечения |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
data | object | Извлеченные структурированные данные, соответствующие предоставленной схеме |
stagehand_agent
Запуск автономного веб-агента для выполнения задач и извлечения структурированных данных
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
startUrl | string | Да | URL веб-страницы для запуска агента |
task | string | Да | Задача для выполнения или цель для достижения на веб-сайте |
variables | json | Нет | Опциональные переменные для подстановки в задачу (формат: { "key": "value" }). Ссылайтесь в задаче с помощью %key% |
provider | string | Нет | AI-провайдер для использования: openai или anthropic |
apiKey | string | Да | API-ключ для выбранного провайдера |
outputSchema | json | Нет | Опциональная JSON-схема, определяющая структуру данных, которые должен вернуть агент |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
agentResult | object | Результат выполнения агента Stagehand |
↳ success | boolean | Успешно ли завершилась задача агента без ошибок |
↳ completed | boolean | Завершил ли агент выполнение (может быть false, если достигнут максимальный шаг) |
↳ message | string | Финальное статусное сообщение или сводка результата от агента |
↳ actions | array | Список всех действий, выполненных агентом во время выполнения задачи |
↳ type | string | Тип выполненного действия (например, "act", "observe", "ariaTree", "close", "wait", "navigate") |
↳ reasoning | string | AI-рассуждение о том, почему было выполнено это действие |
↳ taskCompleted | boolean | Была ли задача завершена после этого действия |
↳ action | string | Описание выполненного действия (например, "нажать кнопку отправки") |
↳ instruction | string | Инструкция, которая вызвала это действие |
↳ pageUrl | string | URL страницы, когда было выполнено это действие |
↳ pageText | string | Текстовое содержимое страницы (для действий ariaTree) |
↳ timestamp | number | Временная метка Unix, когда было выполнено действие |
↳ timeMs | number | Время в миллисекундах (для действий ожидания) |
structuredOutput | object | Извлеченные данные, соответствующие предоставленной выходной схеме |