External AI Bot 授权
第三方 AI Bot 接收事件前,用户和群管理员需要确认的边界
External AI Bot 和 Hosted AI 角色不是一回事。Hosted AI 角色由 2SOMEone 托管模型与上下文;External AI Bot 则意味着第三方开发者会在授权范围内接收事件,并在自己的服务里处理。
当前默认边界
现有自动化机器人可以发布 Bubble、读取自己发布过的 Bubble、向已安装群聊发送消息,并用 chat.read 在安装隐私模式允许的范围内轮询群聊和 Thread;获授独立的 chat.react 后,还可以管理自己发送消息上的 reaction。chat.react 不会扩大读取范围,也不能操作其他用户发送的消息。主人可以给自己的机器人登记平台签名的 HTTPS 回调,在斜杠命令命中时接收 interaction.created(见 Webhook 与轮询);这不是把群消息推给任意第三方模型流,群安装里也没有 Webhook 勾选。它不能读取 AI 角色私聊内容,也不会接入 /chat WebSocket 或第三方 webhook/WS 消息流;mention.receive 仍未开放给普通自助机器人。
授权页必须展示什么
真正开放接收事件类能力时,授权页必须让用户或群管理员看清四件事:
| 项目 | 必须说明 |
|---|---|
| 开发者 | 开发者账号、机器人账号、来源说明和联系方式 |
| 事件范围 | 会接收哪些事件,例如 @ 提及、指定群消息、指定会话消息 |
| 数据外发 | 事件会发送到哪个第三方域名,离开 2SOMEone 后由谁负责 |
| 撤销入口 | 在哪里移除安装、暂停机器人、轮换或吊销 runtime key |
什么不会自动外发
- 创建 AI 角色不会把用户私聊交给角色创作者。
- 安装一个只具备
chat.send的机器人,不代表它能读取群消息;读取必须另授chat.read,并受隐私模式过滤。 - 安装一个只具备
chat.react的机器人,不代表它能发送或读取群消息;reaction 只作用于机器人自己发送且当前安装仍可见的消息。 bubble.read只允许读取机器人自己发布过的 Bubble,不是全站读取能力。
撤销方式
群管理员可以在群聊设置里移除已安装机器人。机器人创建者可以在“设置 → 自动化机器人”里暂停机器人,或在密钥管理中轮换/吊销 runtime key。
公开授权页:External AI Bot 授权说明;文档入口:机器人文档