Skip to main content
把已有 Agent 接入聊天渠道后，用户可以直接发送消息，平台负责创建或复用 Session、投递任务，再将回复发送回渠道。 目前已支持飞书，近期将支持微信、企微等更多渠道。 渠道的公开开放时间以平台公告为准。
聊天渠道接入暂不支持控制台操作，请通过 Channel API 创建和管理。飞书渠道能力与控制台配置入口分别开放；已有 Agent 可按下列步骤接入。

​
选择接入方式

Channel 使用固定的 Agent 版本、Environment 和资源配置。模型、工具、MCP 与 Skills 仍定义在 Agent 中，Channel 不接受这些字段的临时覆盖。

​
接入飞书

​
准备资源

  1. 创建飞书应用并启用机器人和消息接收能力，完成应用发布与可用范围配置。准备 app_id 和 app_secret。
  2. 准备属于当前账号的 Agent 与未归档的 Environment。创建 Channel 的账号需要目标 Agent 的 owner 权限。
  3. 需要外部凭据、文件或共享记忆时，准备同一账号下的 Vault、File 或 Memory Store ID。

​
创建 Channel

Channel API 的地址与 Managed Agents API 不同，请单独配置 FORWARD_BASE_URL。当前 Channel v0 的 Beta 头必须包含 managed-agents-2026-05-26；不要直接照抄 Managed API 推荐的新 Beta 值。
将示例变量替换为你自己的值。HTTP 201 表示预检与保存成功，连接由后台异步建立；保存成功不代表机器人已经可以收发消息。接口不回显飞书凭据。 完整字段、响应示例和 Playground 见创建 Channel API。

​
查看连接并验证

  1. 保存创建响应中的 id，调用获取 Channel，检查 connection_status 与 last_error。
  2. 在飞书向机器人发送真实消息；群聊中 @ 机器人。确认回复发送到了预期对话。
  3. 用 GET /v1/sessions?agent_id=$AGENT_ID 查找关联 Session。其 metadata 包含 source_type: "im"、channel_id、channel_type 和 conversation_type。随后通过 Events API 核对任务输入与执行结果。
飞书的话题是渠道对话分组；Multi Agent 的 Thread 是一个 Session 内的 Agent 执行上下文。两者的 ID 和生命周期不同。

​
配置输出与记忆

输出选项位于 channel_config.response_options，其他渠道选项位于 channel_config。工具原始结果与 Thinking 不会发送到聊天渠道；最终正文取当轮最后一条非空 agent.message。 群聊模板必须包含 {{context_note}} 和 {{messages}} 各一次。通过更新 Channel只修改该模板；不支持修改 Agent、机器人凭据、名称、回复选项或私有记忆开关。需要改这些配置时，删除旧 Channel 后重新创建。

​
API 与使用边界

  • Agent 版本在创建 Channel 时固定。更新 Agent 后，已有 Channel 不会自动使用新版本。
  • 当前 Channel 不支持外部工具结果或审批接续。使用自定义工具或 always_ask 导致 requires_action 时，该条渠道消息处理会失败；无人值守的渠道应使用可自动完成的工具。
  • 删除 Channel 会停止连接与后续回复，清除机器人凭据；已创建的 Session、Memory Store 和审计记录保留。重复删除返回 404。
  • 本页使用公开 Channel v0 API；不要用内部 Console 接口或操作名称替代。