Stagehand 浏览器智能体 SDK10 行代码跑通一次自然语言网页自动化【免费下载链接】stagehandThe SDK For Browser Agents项目地址: https://gitcode.com/GitHub_Trending/stag/stagehandStagehand 是 Browserbase 团队开源的浏览器智能体 SDK提供 act、extract、observe 三个自然语言原语和一套 Playwright 风格的确定性 API覆盖 TypeScript、Python、Go 三种语言。传统选择器脚本一遇到网站改版就崩纯 AI 智能体又不可控——Stagehand 的思路是让每一步的AI 含量由你自己决定。装好环境只需要三条命令结论Node.js 22.18或 Python 3.11 / Go 1.26环境下装 SDK、配一把密钥就能开工模型密钥可以先不管。pnpm add browserbasehq/stagehand zod export BROWSERBASE_API_KEYyour_api_key这里有个容易踩的坑Stagehand 不会替你读环境变量也不会自动加载 .env 文件密钥要在代码里显式读出来传给浏览器工厂。另外如果走 Browserbase 托管浏览器不配置任何模型时 Model Gateway 会自动选模型也就是说连模型提供商的 API Key 都可以先不配。写脚本浏览器、页面、三个原语结论一个最小脚本分四步走——启动浏览器、创建 Stagehand 实例、拿页面跳转、调用原语全程约 20 行。const browser await browserbase.launch({ apiKey: process.env.BROWSERBASE_API_KEY }); const stagehand await Stagehand.create({ browser }); const [page] await browser.context.pages(); await page.goto(https://stagehand.dev);三个原语各管一件事act执行单个动作比如await stagehand.act(Click the Evals button.)。官方建议把复杂流程拆成单步指令依次执行不要指望一条指令干完三件事。extract按 Zod schema 抽结构化数据返回的是已校验的类型化对象不是裸字符串。observe先侦察页面上有哪些可交互元素返回带选择器和操作方法的 Action 列表。page对象本身是完整 Playwright 风格 APIgoto、locator、screenshot、keyPress知道选择器、想零推理的环节直接用它两种风格可以在同一个脚本里混用。验证与运行一条命令出结果结论本地跑tsx index.ts即可脚本结束前记得按stagehand.close()→browser.close()的顺序释放资源。pnpm dlx tsx index.ts运行后在控制台依次看到 extract 的结构化结果、act 的成功回执、observe 返回的候选动作列表说明三个原语都通了。想换本地 Chrome 调试把browserbase.launch()换成localBrowser.launch()并去掉 Browserbase 密钥即可本地开发阶段完全不用消耗云服务额度。进阶三板斧observe 规划、服务端缓存、确定性回放结论把先 observe 再 act固化成习惯是省 token、提速、保稳定性价比最高的一件事。observe返回的 Action 可以直接回喂给act回放——此时跳过模型推理、快照和等待完全确定性执行选择器失效且开启 selfHeal 时才会重新推理一次。这意味着一次 observe 可以规划整页表单的填写而不是每个字段烧一次 LLM 调用。在 Browserbase 上运行时构造器传cache: true即可启用服务端缓存相同输入重复执行直接命中不产生 token 消耗且缓存跨脚本、跨机器生效。需要绝对控制时model选项可以固定具体模型名甚至传自定义的 LLM 回调绕过网关。想深入细节的话官方文档在 packages/docs/v4/ 下按 basics、configuration、best-practices 分目录组织act/extract/observe 各有独立章节。下一步建议拿你日常最重复的一项网页操作比如每天填的某个表单写一个 observe act 两行版的自动化跑通后再逐步叠加缓存与 schema 校验。【免费下载链接】stagehandThe SDK For Browser Agents项目地址: https://gitcode.com/GitHub_Trending/stag/stagehand创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考