Direct Invoke 迁移对照
Direct Invoke 不再是当前版本的业务接入入口。本页保留旧文档定位，帮助已有调用方迁移；新项目使用Bridge HTTP 与 WebSocket API，不要按旧请求重新实现客户端。
端点迁移
旧 /api/agents/Invoke、任务状态和媒体上传入口不再作为当前接入契约。先取得部署提供的 Bridge HTTP 基址和 WebSocket 地址，再按照迁移步骤创建渠道账号。
鉴权迁移
Bridge 使用绑定到 WebSocket 渠道账号的 wst_ Token。旧 Agent API Token 和临时调试 Token 不适用于新接入。参见Token 管理。
请求字段迁移
| 旧调用方职责 | 当前处理方式 |
|---|---|
发送 prompt | HTTP SendMessage.content |
使用 session_id 继续对话 | 保存业务 chat_id 和服务端 context_key 的映射 |
设置 stream | 输出统一通过 WebSocket 订阅，不再设置该字段 |
| 传递文件数组 | 按文件准备方式选择知识库、MCP 或应用侧工具 |
不能只替换 URL。新请求严格检查字段，需要移除旧请求字段。
同步结果迁移
SendMessage 返回 msg_id 和 context_key，不返回最终答案。由调用方消费相同 mid 的事件，直到主智能体运行进入终态。
SSE 输出迁移
不再解析旧 SSE chunk。文本、工具、中断和生命周期通过 ev 帧传递；回复正文按 message_id 累加文本增量。参见事件字段。
中断迁移
从 ev.d.pending 取得中断，以 HTTP RespondInterrupt 回传。interrupt_id 来自 pending.id，msg_id 来自外层 mid，context_key 来自外层 sid。参见中断响应。
状态查询迁移
当前客户端通过生命周期事件维护运行状态；普通重连使用外层 seq 续传。收到 reset 时，再使用 ListMessages 和 ListPendingInterrupts 重建会话状态。旧任务状态和重置请求不能照搬。
文件上传迁移
Bridge SendMessage 接收文本，不提供旧 Invoke 的文件上传和 files 字段。需要文件处理时，先选择适合任务的文件准备路径。
错误处理迁移
同时检查 HTTP 状态和 success_response；业务失败查看 data.reason。HTTP 已接收与运行完成是不同阶段，后者还需检查生命周期终态。完整字段见错误处理。