Channels 导读

群聊权限与触发:谁能在群里叫醒机器人

群聊默认是白名单模式,只有被允许的人通过@提及才能触发回复。注意区分“谁可以触发”和“谁的消息能被引用进上下文”——后者目前按渠道各有不同,未来会收紧。如果想把个人DM和公开群聊隔离到不同执行环境,单agent配合sandbox的non-main模式就能做到。

先讲这一页到底在解决什么

群聊权限与触发:谁能在群里叫醒机器人

群聊默认是白名单模式,只有被允许的人通过@提及才能触发回复。注意区分“谁可以触发”和“谁的消息能被引用进上下文”——后者目前按渠道各有不同,未来会收紧。如果想把个人DM和公开群聊隔离到不同执行环境,单agent配合sandbox的non-main模式就能做到。

原文共 17 节,先看 Start Here 路径:/channels/groups 查看官方原文

第一站

🚪 群聊这边有两层门:先看群本身允不允许,再看有没有被点名

把这两层分开想,就不会把配置搅成一团。

🏢

groupPolicy

像大楼门禁,决定这类群消息整体是开门、关门,还是只放白名单。

📋

groups / groupAllowFrom

像门卫名单,决定哪些具体群、哪些具体人能在群里把它叫起来。

@

requireMention

像进大厅后还得点名喊它,不然它只在旁边听,不随便插嘴。

🪣

群会话单独分桶

每个群各有一只记忆桶,不跟你的私聊主桶混在一起。

第二站

🧪 那张 quick flow 图,其实是在讲一条很朴素的门卫流程

读成动作,比读条件判断舒服得多。

🚫 policy 是 disabled

像门口直接挂“今日不接待”,消息进来就不处理。

📋 policy 是 allowlist

像先翻名单,不在名单里的群,还是不让进。

@ 需要 mention

即便进了大厅,也得被点名它才会正式起身回应。

📝 没触发时会怎样

很多频道里它会把消息留作上下文参考,但不当场开口。

第三站

🧠 “个人 DM + 公共群” 那个模式,说白了就是“同一个脑子,但私聊和群聊用不同工作姿势”

这是这一页最实用的一段。

💬 私聊在主桶

像最贴身的工作台,权限更大、工具更全。

👥 群聊在非主桶

像公共大厅,常常更适合配沙箱、更克制的工具权限。

🧪 sandbox: non-main

像说“凡是不在私聊主工作台上的,就放进更安全的实验箱里处理”。

🎈 一句话

同一个脑子也可以在不同房间用不同规矩上班。