通过渠道提供智能体
一体化智能体运行与协同平台（AgentWorks）的渠道账号连接飞书、QQ 或 WebSocket 消息入口，并决定消息应进入已有智能体实例，还是为渠道用户动态创建专属实例。
三类渠道的消息范围和接入方式如下；上线前请以目标部署的可见配置和真实账号测试为准：
| 渠道 | 消息与回复 | 接入方式 |
|---|---|---|
| 飞书 | 支持单聊和群聊；流式回复 | 飞书应用机器人长连接 |
| 单聊可配置，无群聊设置；非流式回复 | QQ WebSocket C2C | |
| WebSocket | 支持单聊和群聊；流式回复 | infini.bridge.v1 协议 |
分别参见接入飞书机器人、接入 QQ 机器人和通过 WebSocket 接入智能体。需要创建、切换或清空渠道中的对话时，参见管理渠道会话。
选择共享服务或按用户开通
选择绑定模式时，重点判断不同用户只是需要各自的对话历史，还是需要分别管理智能体实例及其资源。
共享一个智能体实例
用户使用相同的智能体配置和能力资源，只需分开对话时，选择 实例绑定（agent_id 指向应用实例）。这种方式适合企业 FAQ、制度问答和公共服务台；一个智能体实例承载多个渠道会话，资源和清理工作较少。
为每位用户按需开通实例
需要分别管理实例参数、沙箱或实例生命周期时，选择 模板绑定（agent_id 指向 Agent 模板，用户需 /init）。这种方式适合个人工作助手、客户专属助手、培训教练和研发运维助手；用户首次发送 /init 时创建实例，需要规划容量、能力资源和清理。需要分别保存长期记忆时，还必须确认每个实例实际使用独立记忆库。
选择这种方式后：
- 不需要提前为所有潜在用户创建智能体实例。
- 同一个智能体模板可以供不同用户按需开通。
- 只有完成
/init的用户才会创建智能体实例。 - 每位用户的实例参数、运行状态和生命周期可以分别管理。
用户停止使用后，可以删除用户绑定。如果原智能体实例也不再需要，还需要在 智能体实例 中单独处理。删除用户绑定不会删除原智能体实例。
只需分开对话时，使用共享实例和不同渠道会话。需要分别管理实例配置、能力资源或生命周期时，使用模板绑定和 /init 按用户开通。
“实例绑定”选项中的“应用实例”就是智能体实例，即基于智能体模板创建的运行实例。
WebSocket 渠道使用较短的 绑定 Agent 实例（默认） 和 绑定 Agent 模板 标签，语义相同。
同一租户内，一个智能体实例或智能体模板只能绑定一个尚未删除的 WebSocket 渠道账号。停用账号不会释放这个绑定目标。需要让多个客户端连接同一个绑定目标时，为同一个 WebSocket 渠道账号创建多个 Token。
专属智能体实例表示运行对象可以分别管理，不自动保证记忆、数据和权限彼此独立。智能体模板选择 记忆 - 实例 时，不同用户通过 /init 创建的实例仍会连接同一个记忆库。需要保存用户私有信息时，应选择环境中已有的 记忆 - 模板，让每个新实例准备独立记忆库；列表为空时，请联系平台管理员，或由业务系统管理按用户区分的长期记忆。
MCP 凭证或业务系统账号也可能由多个实例共享。请检查智能体模板中插件引用的能力模板或实例，以及外部服务实际收到的凭证和调用方上下文；多个用户共用同一凭证时，应按共享权限边界设计和验证。参见模板和实例如何影响资源。
绑定已有智能体实例
- 先创建并验证智能体实例。
- 打开 渠道账号。
- 选择 新建账号，在 渠道类型 中选择 飞书、QQ 或 WebSocket。
- 飞书或 QQ 账号选择 实例绑定（agent_id 指向应用实例）；WebSocket 账号选择 绑定 Agent 实例（默认）。
- 选择目标 智能体实例。
- 填写渠道应用凭证及允许名单。
- 选择 创建。创建的渠道账号会自动上线。
这种方式不会为每个用户创建新智能体实例。不同用户仍可使用各自的渠道会话分开对话，适合所有用户共享同一智能体实例配置和能力资源的情况。
首次使用时创建专属实例
- 创建一个可复用智能体模板。
- 确认所有必需的实例参数可以由用户或管理员提供。
- 选择 新建账号，在 渠道类型 中选择所需渠道。飞书或 QQ 账号选择 模板绑定（agent_id 指向 Agent 模板，用户需 /init）；WebSocket 账号选择 绑定 Agent 模板。
- 选择目标 Agent 模板。
- 选择 创建。
- 用户在渠道中发送：
/init如果模板要求参数，可以在同一条命令中传入 KEY=VALUE：
/init CUSTOMER_ID=customer-001 REGION=cn-east模板绑定的首次使用和后续路由过程如下：
该时序只适用于模板绑定。实例绑定跳过 /init 和动态创建，消息直接进入渠道账号选择的现有智能体实例。
平台会创建智能体实例并保存渠道用户绑定。后续消息进入该实例。如果用户已经完成初始化，再次发送 /init 会返回已初始化提示。
警告
动态创建不是批量预创建。每个用户只在发送 /init 时触发一次智能体实例创建。上线前应评估实例数量、外部能力资源和后续清理责任。
需要使用两位测试用户完整验证飞书模板绑定、按用户开通实例、用户绑定和重新初始化时，参见构建按用户开通的飞书助手。
配置渠道参数
智能体模板表单可以保存飞书或 QQ 的渠道参数，并选择模板绑定或实例绑定。创建或更新测试智能体实例后，在 渠道账号 中确认出现预期账号和绑定关系，再完成真实消息往返测试。
如果需要单独管理渠道账号、用户绑定、会话或 WebSocket Token，应在 渠道账号 中完成。具体创建和验证步骤参见接入飞书机器人、接入 QQ 机器人、通过 WebSocket 接入智能体和管理渠道会话。
区分渠道路由和 WebSocket Token
渠道账号保存实例绑定或模板绑定的路由选择。wst_ WebSocket Token 只允许客户端连接一个 WebSocket 渠道账号，并不直接绑定智能体模板或智能体实例。
修改 WebSocket 渠道账号的绑定目标后，应让客户端重新连接并通过测试消息确认实际路由，不要依赖已建立的连接自动切换目标。
管理渠道用户绑定
在渠道详情的 会话管理 和 用户绑定 中检查路由，并按需为用户绑定配置补充审批处理规则。用户规则只处理模板规则未匹配的确认型调用。删除用户绑定不会删除对应智能体实例；还需要在 智能体实例 中检查并处理原实例和相关能力资源。
删除操作路径、普通消息验证、重新执行 /init 的时机，以及需要立即阻止访问时的处理方式，参见管理渠道账号与用户绑定。
处理渠道失败和审批
渠道返回失败信息时，记录渠道用户、发送时间和完整错误信息，并在目标智能体实例中查找同一时间的 Trace。不要立即重复发送可能产生副作用的请求。
消息已经进入智能体执行
找到对应 Trace，说明消息已经进入智能体执行过程。继续检查模型、工具、审批、子代理和外部能力。
- 核对失败发生在普通回复、工具调用还是子代理任务中。
- 在飞书中有多个并行工具调用时，展开各个工具调用，找出失败或仍在等待的操作。
- 如果飞书会话中出现子代理审批卡片，核对操作和参数后选择 ✅ 允许、⭐ 加白执行 或 ❌ 拒绝。对应后台任务会在 等待审批 和继续运行之间切换。
- 涉及子代理时，打开 后台任务检查对应任务。
- 根据 Trace 中的失败位置检查 模型凭证、MCP Server、沙箱运行记录或其他外部能力，然后使用同一测试输入复测。
消息没有进入智能体执行
没有对应 Trace 时，检查渠道账号状态、绑定目标、用户绑定和智能体实例状态。
- 打开 渠道账号，确认目标账号已经启用并处于在线状态。
- 对于实例绑定，确认绑定的智能体实例仍然存在并且可以运行。
- 对于模板绑定，在渠道账号的 用户绑定 中确认该用户已经绑定到有效智能体实例；尚未初始化时，让用户发送
/init。 - 修复状态或绑定后，先发送不会修改业务数据的固定测试消息。仍然失败时，把渠道账号、用户、发送时间和完整错误信息交给管理员排查。
渠道中的失败信息用于及时告知用户。Trace 和运行记录用于定位已经开始的智能体执行；没有对应记录时，应从渠道账号和绑定关系开始排查。参见排查智能体实例运行问题和将任务委托给子代理。
处理初始化问题
- 提示当前渠道不支持
/init：账号不是模板绑定。 - 提示缺少参数：按照返回的参数名重新发送
/init KEY=VALUE。 - 用户消息没有回复：检查允许名单、渠道账号状态和智能体实例状态。
- 初始化后配置错误：对对应智能体实例选择 编辑，不要只修改渠道用户绑定。