智能体契约

状态准入受控

智能体公开入口由下方契约约束，避免不可追踪、不可限制的浏览器执行进入生产路径。

要求可观测、可限制、可复现

运行必须具备步骤日志、浏览器证据、限制项、回放和公开 API 语义。

当前使用浏览器、单页抓取或多页爬取

现有工作台已经基于真实托管会话运行，并会继续作为执行基础。

当前可用路径

智能体公开入口受准入契约约束。当前生产工作流应使用已有工作台：

浏览器需要完整 Playwright 控制

使用浏览器工作台。它已经具备真实会话、实时画面、日志、网络事件和回放。

单页需要单页渲染和提取

使用单页抓取。它适合以 URL 为入口的文本、HTML 和截图输出。

多页需要有边界的站内采集

使用多页爬取。它提供最大页数、同站链接和包含/排除边界。

智能体成为公开能力前，运行对象必须可追踪、步骤必须可解释、限制必须在运行前可见，证据和计费用量必须能关联到同一个运行。每次运行至少包含会话 ID、运行 ID、状态、开始/结束时间、终态、动作时间线和失败原因。

运行前必须能看到任务提示词、执行器、模型或服务提供方、超时、会话保持、档案访问、权限和录制模式。这些是运行输入，不应隐藏在控制台私有状态里。

结果视图和公开 API 必须描述同一个运行对象：最终答案或终态失败、步骤时间线、浏览器证据、输出产物和用量语义。SDK、cURL、团队 API 密钥或公开 OAuth 授权都应返回同一种运行结构，而不是控制台专属结果。

准入判断归结为四件事：失败可定位、风险可控制、结果可复现、用量可解释。智能体不能绕过会话模型、隐藏浏览器动作或默认开放无限制执行；它应该组合浏览器、单页抓取和多页爬取能力，而不是替代它们。