从 Direct Invoke 迁移到 Bridge 接入
当前接入使用 Bridge HTTP 提交消息和中断响应,通过 WebSocket 订阅智能体输出。旧 Direct Invoke、同步回复和 SSE 示例不再适用于当前版本。
首次接入请按通过 WebSocket 接入智能体创建渠道账号、准备 Token 并验证消息往返。已有 Invoke 调用方按本文调整接入和状态管理。
将实例调用配置迁移到渠道账号
为目标智能体实例创建 WebSocket 渠道账号,选择实例绑定,再为业务服务创建 wst_ Token。原实例的 API 调用开关、Invoke 地址和旧 Token 不能替代这一步。HTTP 和 WebSocket 的部署地址由服务提供方给出,不要从控制台主机名推导。
替换同步调用
用 HTTP SendMessage 提交文本输入。成功响应只表示消息已接收;保存返回的 msg_id 和 context_key,再通过 WebSocket 订阅该会话并等待对应运行的终态。需要对外提供同步接口时,由你的业务后端聚合事件、处理超时后返回结果,不要把提交响应当成最终回答。
将 SSE 消费改为事件订阅
连接 infini.bridge.v2,发送 sub 订阅帧,并检查 subd.d.ok。文本来自 ev.d.message_delta;只有主智能体对应请求的 success、error 或 cancelled 生命周期事件才是终态。断线后用外层 seq 续传,不能继续解析旧 SSE chunk。参见Bridge HTTP 与 WebSocket API 参考。
重新建立业务会话映射
业务服务应保存已认证用户、业务会话、chat_id 与返回的 context_key 的映射。继续同一会话时复用 chat_id,为每条新消息生成新的 msg_id。不要直接把旧 Invoke 的 session_id 填入新请求;历史记录的保留和迁移应单独安排。
保留用户与资源隔离
user_id 由你的后端根据已认证用户确定。不同业务会话使用不同 chat_id,并在订阅、读取历史和执行工具前检查业务权限。同一渠道账号的 Token 不是最终用户权限隔离手段;分开会话也不会自动分开实例所连接的记忆库或沙箱。参见管理会话和中断。
改写错误与中断处理
HTTP 客户端同时检查状态码和响应的 success_response;业务失败按 data.reason 处理。提交成功后仍需处理事件流中的运行失败。
用户工具从 ev 帧的 pending 事件取得名称和参数,执行后通过 HTTP RespondInterrupt 返回结果。不要继续发送旧 interrupt_response 请求结构。完整闭环参见工单助手实战。
替换并收回旧凭证
为新渠道账号签发专用 wst_ Token,仅存储在业务服务端。验证普通回复、工具结果、断线恢复和失败处理后,再停止旧调用方并收回旧凭证。不要把 agt_ 或 dbg_ Token 改名前缀后用于 Bridge。参见管理 Bridge 接入 Token。