CA
文档首页

连接渠道

渠道让团队成员可以从已经使用的工具中与 Agent 对话。一个渠道会把一个外部 bot 或 app 连接到一个 Cloud Agents Agent。

建议先在网页工作区中验证 Agent 的行为。确认符合预期后,再接入渠道。

支持的渠道

渠道适合场景
Telegram快速的个人或群组 bot 访问。
Slack工作区 mention、私信和 threaded 团队工作流。
Lark / 飞书Lark 或飞书工作区中的团队聊天工作流。
Discord社区或 server 中的 Agent 访问。
Matrix开放聊天部署和自托管 homeserver。

设置模式

多数渠道遵循相同流程:

  1. 在外部服务中创建 bot 或 app。
  2. 复制 token 或 app secret。
  3. 在 Cloud Agents 中打开 Settings -> Channels
  4. 创建新渠道,并选择目标 Agent。
  5. 粘贴 token 或 app secret。
  6. 保存并测试渠道。
  7. 如果 Cloud Agents 显示 inbound URL,把它粘贴到外部服务的 event 或 webhook 设置中。

会话行为

默认情况下,渠道会尽量按用户、私信、房间或 thread 隔离对话,具体取决于提供方能力。部分渠道设置允许群组共享同一个 Agent 会话。只有当频道中的所有人都应该看到同一份上下文时,才使用共享会话。

安全习惯

  • 为每个 Agent 或团队工作流创建专用 bot。
  • 只授予 bot 必需的消息权限。
  • 把 token 保存在渠道设置中,不要发到聊天消息里。
  • 暂停或删除不再使用的渠道。
  • 在邀请 bot 进入大型群组前,先在私密房间中测试。

渠道指南