---
title: Stagehand Agent
description: 自主网页浏览代理
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="stagehand_agent"
  color="#FFC83C"
/>

{/* MANUAL-CONTENT-START:intro */}
[Stagehand](https://www.stagehand.dev/) 是一个自主的网页代理平台，使 AI 系统能够像人类一样浏览和与网站交互。它为自动化复杂的网页任务提供了强大的解决方案，无需定制代码或浏览器自动化脚本。

使用 Stagehand，您可以：

- **自动化网页导航**：使 AI 能够浏览网站、点击链接、填写表单并与网页元素交互
- **提取结构化数据**：从网站收集特定信息并以结构化、可用的格式呈现
- **完成复杂工作流程**：在不同网站和网页应用程序之间执行多步骤任务
- **处理身份验证**：导航登录流程并维护跨网站的会话
- **处理动态内容**：与 JavaScript 密集型网站和单页应用程序交互
- **保持上下文感知**：在导航时跟踪当前状态和历史记录
- **生成详细报告**：接收所采取操作和收集数据的全面日志

在 Sim 中，Stagehand 集成使您的代理能够无缝地与基于网页的系统交互，作为其工作流程的一部分。这允许复杂的自动化场景，将您的 AI 代理与网络上广泛的信息和功能连接起来。您的代理可以搜索信息、与网页应用程序交互、从网站提取数据，并将这些能力融入其决策过程中。通过将 Sim 与 Stagehand 连接，您可以创建超越基于 API 集成的代理，使其能够像人类一样浏览网页——填写表单、点击按钮、阅读内容并提取有价值的信息，从而更高效地完成任务。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Stagehand Agent 集成到工作流程中。可以浏览网页并执行任务。需要 API 密钥。

## 工具

### `stagehand_agent`

运行一个自主的网页代理来完成任务并提取结构化数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `startUrl` | string | 是 | 启动代理的网页 URL |
| `task` | string | 是 | 在网站上完成的任务或实现的目标 |
| `variables` | json | 否 | 替代任务中的可选变量（格式：\{key: value\}）。在任务中使用 %key% 引用 |
| `format` | string | 否 | 无描述 |
| `apiKey` | string | 是 | 用于代理执行的 OpenAI API 密钥（Stagehand 必需） |
| `outputSchema` | json | 否 | 定义代理应返回的数据结构的可选 JSON 架构 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `agentResult` | object | Stagehand 代理执行的结果 |

## 注意

- 类别：`tools`
- 类型：`stagehand_agent`
