消息渠道使用

墨台将 Agent 执行结果抽象成响应通道。当前后端提供 SSE、微信、企业微信、钉钉和 QQ Bot 渠道；各渠道的认证和回调协议不同，但都会把入站消息转换成统一的外部 IM 消息，再路由到 Agent session。

渠道能力

渠道	管理接口前缀	运行特点
SSE	/v1/chatbot	浏览器长连接，支持 token、节点进度和心跳
微信	/v1/channel/wechat	渠道实例可开启、重开、关闭和删除
企业微信	/v1/channel/wecom	以 Agent 维度管理渠道凭据和启停状态
钉钉	/v1/channel/dingtalk	支持扫码创建应用、扫码状态轮询和启停
QQ Bot	/v1/channel/qq	通过 Bot WebSocket 接收事件并回发消息

接入流程

1. 在 Agent 管理页面创建并发布 Agent。
2. 配置对应平台的凭据和回调地址。
3. 在渠道管理接口中保存并启用渠道。
4. 使用平台客户端发送测试消息。
5. 通过 Agent 日志和渠道状态接口确认入站、执行和出站链路均成功。

外部 IM 的协议回复目标保存在接入节点的内存中，因此同一会话的外部 IM 消息会优先提交到当前节点的本地 session 执行器；多实例部署时必须配合粘性路由或明确的节点路由策略。