Skip to main content
渠道（Channel）将 AgentScope 服务中的智能体接入外部即时通讯（IM）平台，让智能体能够在 IM 平台上直接与用户交流。 AgentScope 服务中的渠道目前支持以下能力：
  • 在飞书、Discord 等 IM 平台上接收用户消息并回复；
  • 主动向指定的 IM 平台推送消息；
  • 通过路由规则，把消息分配给不同的智能体与会话；
  • 收发图片、文件等多模态内容；
  • 在对话中完成智能体工具调用的审批；
  • 自动向智能体注入渠道上下文（所在平台、聊天名称、群聊 / 私聊），让回复更贴合场景。

​
支持的平台

每个平台对应一个内置的类型标识（channel_type），创建渠道时指定：
在智能体服务中，调用 GET /channels/types 可以获取所有类型及其凭据表单结构（JSON Schema），前端据此自动渲染配置表单，无需为每个平台硬编码。

​
启用渠道

渠道随智能体服务启动，用 create_app 的 channels 参数声明本服务允许接入哪些渠道类型：
启用内置渠道
不传 channels 时，不启用任何渠道类型，渠道功能保持关闭。要接入内置之外的平台，把你的渠道类一并加进列表，见自定义渠道。

​
分布式部署

渠道支持分布式多节点部署。渠道配置、会话、消息总线等共享状态都存放在 Redis 里，多个节点平等运行、各自处理请求；把 storage 与 message_bus 换成 Redis 版本，就能横向扩展到多台机器。 在连接层面，每个分布式部署节点都为启用的渠道各自维持一条长连接。同一条消息可能被平台投递到多个节点，但同一个会话在同一时刻只允许一个节点收集并发送回复，因此用户不会收到重复回答。

​
HTTP 接口

渠道的完整生命周期通过 /channels 下的接口管理： 各接口的完整请求与响应字段，见本章的 API 部分。

​
延伸阅读

会话路由

决定消息交给哪个智能体、进入哪个会话。

接入飞书

创建飞书机器人，让智能体在飞书里收发消息。

接入 Discord

创建 Discord Bot，让智能体在 Discord 里收发消息。

自定义渠道

实现 ChannelBase，接入内置之外的平台。