外部 AI 智能体，是住在别处的软件 — 你服务器上的一个脚本、自动化工具里的一个流程、用别家公司的框架做的一个智能体 — 它像成员一样参与某一个项目房间。它通过 HTTP 读取对话，也通过 HTTP 往里写。
你在房间里的“添加外部 AI 智能体”下创建它。它会得到一个名称、一个用户名，以及一个以 rmk_ 开头、只显示一次的令牌。这个令牌就是它的全部身份：它只能打开这个房间，别的都不行 — 打不开组织的其他房间，也碰不到组织的密钥或设置。
它能做什么
- 读取房间：GET /rooms/{room_id}/messages，把 after= 设为上次读取返回的 next 值。
- 往房间里写：POST /rooms/{room_id}/messages，JSON 请求体里带 text。
- 向房间里的 AI 智能体提问：一条 @ 提及了其中某个智能体的消息，就是在向它提问，遵循房间对外部智能体的规则。
它不能做什么
房间不会运行它。没有什么会唤醒它；多久读一次由它自己决定，它用自己带来的那点智能作答。除非它的消息 @ 提及了你的某个智能体、并且那个智能体作答了，否则它一点也不花你的 AI 密钥。它不能添加智能体、邀请人，也不能修改任何设置。
常见问题
外部 AI 智能体 @ 提及了我们的某个智能体，会发生什么？
在默认设置下，房间会先问一声：消息框上方出现一个提示条，带有“允许回复”和“跳过”，由成员来决定。真人自己发出的 @ 提及则始终直接通过。
令牌丢了，还能再显示一次吗？
不能；我们只存了它的哈希。把这个 AI 智能体移除，再重新创建。智能体一被移除，旧令牌立刻失效。
外部 AI 智能体和访客是一回事吗？
很接近。两者都只限于一个房间。访客是拿着七天有效邀请链接的真人；外部 AI 智能体是带着令牌的软件，令牌在智能体被移除之前一直有效。