browser_navigate、browser_act、browser_extract、browser_observe、browser_screenshot）来驱动它，并通过可 iframe 嵌入的实时视图将会话呈现出来，让你的用户可以实时观看（或接管）。
以下四个端点均限定于调用者的 API 密钥范围，并受 connectors 权限范围限制。会话默认硬性上限为 20 分钟，并在空闲超时后自动关闭（可通过 THEO_BROWSER_SESSION_MAX_SECONDS / THEO_BROWSER_SESSION_IDLE_SECONDS 配置）。
端点
创建会话
请求体
string
可选的起始 URL。会话启动后会立即导航到该地址，因此第一个实时视图 URL 就已指向真实页面（避免
about:blank 目标绑定问题）。boolean
默认值:"false"
在智能体断开连接后仍保持会话存活。如果你之后需要重新连接 Stagehand，则必须设置此项。
boolean
默认值:"false"
通过 Theo 的住宅代理池路由流量。按 MB 计费更高。
string
默认值:"us-west-2"
数据中心区域：
us-west-2 · us-east-1 · eu-central-1 · ap-southeast-1。响应（201）
embed_url 是零配置路径。 直接将它放入你自己产品中的 <iframe src="...">，即可获得带 Theo 品牌的浏览器窗口（地址栏、实时状态指示、重连界面），无需任何 SDK 集成。该令牌是短期有效的——请从你的后端调用 GET /:id 来获取一个新的令牌。刷新实时视图 URL
BrowserBase 的调试器 URL 固定指向某个特定的 CDP 页面目标。当智能体进行导航、点击打开新标签页，或页面销毁了其目标时，嵌入的 WebSocket 连接会断开。Theo 会在每次智能体工具调用后自动强制刷新——但你自己的界面也应支持按需刷新：live_view_version 很重要。 当 iframe 触发 browserbase-disconnected postMessage 时，应带 ?force=1 重新获取。上游服务商可能返回相同的 URL 字符串，但在背后悄悄替换了底层的页面目标。请使用 live_view_version（而不是 URL 相等性判断）来决定何时应为 iframe 重新生成 key。
响应
列出活跃会话
{ sessions: BrowserSessionSnapshot[] }——与 GET /:id 中单个会话的结构相同。
查看会话
embed_url（有效期 1 小时），因此长时间运行的仪表盘可以不断重新发起 iframe，而无需创建新的会话。