Stagehand — автоматизация веба через Browserbase и модели OpenAI или Anthropic. Два режима: разобрать одну страницу по схеме или дать агенту многошаговую задачу (навигация, формы, несколько страниц).
Когда что брать:
stagehand_extract— известны URL и нужная структура: списки, поля, объекты с одной страницыstagehand_agent— нужна цепочка действий: вход, поиск, заполнение форм, сбор с нескольких страниц
Нужен ключ API (Application Programming Interface — программный интерфейс) выбранного провайдера. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Инструменты
stagehand_extract
Извлечь структурированные данные со страницы по схеме.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
url | string | Да | URL страницы |
instruction | string | Да | Инструкция, что извлечь |
provider | string | Нет | Провайдер модели: openai или anthropic |
apiKey | string | Да | Ключ API выбранного провайдера |
schema | json | Да | JSON-схема структуры данных |
Выход
| Параметр | Тип | Описание |
|---|---|---|
data | object | Извлечённые данные по заданной схеме |
stagehand_agent
Запустить автономного веб-агента: выполнить задачу и при необходимости вернуть данные по схеме.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
startUrl | string | Да | URL стартовой страницы |
task | string | Да | Задача или цель на сайте |
variables | json | Нет | Подстановки в текст задачи (формат {key: value}). В задаче — как %key% |
format | string | Нет | Нет описания |
provider | string | Нет | Провайдер модели: openai или anthropic |
apiKey | string | Да | Ключ API выбранного провайдера |
outputSchema | json | Нет | JSON-схема ответа агента |
Выход
| Параметр | Тип | Описание |
|---|---|---|
agentResult | object | Результат выполнения агента Stagehand |
↳ success | boolean | Задача завершилась успешно |
↳ completed | boolean | Задача выполнена полностью |
↳ message | string | Статус или итоговый результат |
↳ actions | array | Тип выполненного действия |
↳ type | string | Тип действия |
↳ params | object | Параметры действия |
↳ result | object | Результат действия |
↳ type | string | Тип действия |
↳ params | object | Параметры действия |
↳ result | object | Результат действия |
structuredOutput | object | Данные по заданной output-схеме |