API 接入概览
你的应用可以通过智能体开发服务平台（AgentWorks）的智能体调用接口（Bridge API）提交消息、接收回复：用 HTTP 提交消息，用 WebSocket 接收回复和运行事件。
区分接入方式
- 通过 API 将智能体接入自己的业务系统：按照通过 API 调用智能体获取渠道账号的 Token，通过 HTTP 发送消息，通过 WebSocket 接收智能体回复和运行事件。
- 在飞书或 QQ 中对话：使用相应的渠道接入。
- 让智能体调用已有工具服务：添加 MCP 或用户工具包。
- 创建和管理智能体资源：使用 AgentWorks 控制台；本组文档面向应用调用智能体，不包含控制台内部的资源管理请求。
调用 API 让你的应用使用已经配置好的智能体；MCP 和用户工具包提供的是智能体执行任务时可调用的工具。通过 API 接入智能体不需要迁移你的整个应用或工作流，也不会把智能体自动发布成 MCP Server 或 OpenAI 兼容模型接口。
HTTP 提交请求，WebSocket 接收结果
一次调用按以下流程完成：
- 应用用渠道账号的
wst_Token 建立 WebSocket 连接。 - 应用通过 HTTP
SendMessage提交文本，保存返回的消息标识msg_id和会话标识context_key。 - 应用通过 WebSocket 订阅该会话，接收文本、工具调用和运行状态。
- 智能体需要审批或应用执行工具时，应用通过 HTTP
RespondInterrupt回传决定或结果；随后继续接收事件，直到本次运行结束。
HTTP 接收成功后，回复可能还在生成。应用以运行事件判断成功、失败、取消或等待处理；具体做法见管理会话、运行和中断。
Token 保存在你的后端，网页或移动应用通过后端访问。后端根据已登录用户检查会话访问和工具执行权限。SendMessage 接收文本；附件限制及替代方式见能否通过调用接口直接提交文件？。
选择接入或迁移方式
是否已有客户端，以及客户端使用哪种协议，决定了需要新建接入还是修改原有代码。
- 第一次接入：按通过 API 调用智能体创建渠道账号、准备 Token，发送消息并收到第一条回复；教程以
curl和websocat演示，也可使用其他客户端。 - 查询接口用法：查 API 参考，按 HTTP 方法或 WebSocket 帧类型定位字段、事件和错误处理规则。
- 已有
infini.bridge.v2客户端准备升级：对照智能体接入 API 更新日志中的起点与目标发布，检查不兼容变化和行为调整。 - 已有 Direct Invoke 或
infini.bridge.v1客户端：按旧版接入迁移指南识别原接入方式，再修改凭证、请求、订阅及事件处理。
首次接入不需要阅读旧版迁移步骤；开发中可以直接查 API 参考。
版本与兼容性
核对升级影响时，需要区分平台发布与接入协议中的版本标识：
| 标识 | 用途 |
|---|---|
| 发布日期与产品版本 | 定位平台的一次发布及其变化，例如智能体接入 API 更新日志中的 2026-09-16；不是请求中可选择的日期版本 |
/api/bridge/v1/ | HTTP 接口路径前缀；其中的 v1 不代表 WebSocket 子协议版本，也不是平台发布版本号 |
/ws/v1 | WebSocket 接入路径；路径未变，不表示客户端协议未变 |
infini.bridge.v2 | 握手时选择的 WebSocket 子协议，客户端按此协议发送订阅帧和解析事件 |
hello.d.protocol_version | 服务端就绪帧中的版本值；其中的 v1 不替代握手时使用的 infini.bridge.v2 |
infini.bridge.v2 相同也不表示行为完全相同。升级时核对更新日志中的“必须修改”和“按用法检查”；“无需修改现有调用”只适用于条目说明的用法。
跨多次发布升级时，检查起点之后到目标发布之间的相关条目，再按目标接口修改；无需先实现已经过时的中间客户端。支持范围和移除时间以对应条目为准，不从版本编号推定额外的兼容期。