Bot 工作组(ADR-0023)通过 API 对外提供。它和现有的 Agent API(/v1,会话、消息)是两类能力,使用方和权限范围都不同:Agent API 的 Key 按 Profile 授权,Bot 的 Key 应当按机器人授权。两者不应该互相通用。
/bot/v1/* 前缀,与 /v1/* 分开。bot_api_keys,前缀 bk_(Agent Key 是 ask_)allowedBotIds),不涉及 Profile/v1 只接受 ask_ 和 Agent 浏览器令牌;/bot/v1 只接受 bk_ 和 Bot 浏览器令牌。拿错类型一律返回 401,不提示另一套 API 的存在。/v1 的方式一致),来源记为 admin。Bot Playground 因此不需要单独的后端;替身组员、逐步执行等调试功能只对来源为 admin 的工作组开放。kind(agent / bot),两种令牌不能互换使用。Bot 浏览器令牌由 POST /bot/v1/browser-tokens 签发。team:<id>,Agent API 永远看不到/v1 和 /bot/v1。api_keys 表和 /v1 的行为不变