选择智能体的使用方式
先确认调用方是谁、是否需要独立实例以及由谁持有凭证，再选择控制台、API 调用或渠道。所有方式最终都使用智能体实例。
比较访问方式
根据调用方、交付目标和需要准备的运行对象选择访问方式。
| 调用方和目标 | 推荐方式 | 运行准备 |
|---|---|---|
| 构建人员验证实例 | 网页版对话 | 环境已配置入口；打开新标签页并选择目标实例 |
| 后端服务调用 | HTTP 与 WebSocket | 创建 WebSocket 渠道账号及 wst_ Token；Token 只保存在服务端 |
| 飞书或 QQ 共用一个智能体实例 | 渠道实例绑定 | 手动创建实例；配置渠道应用凭证 |
| 每个渠道用户使用专属智能体实例 | 渠道模板绑定和 /init | 首次使用时动态创建实例；配置渠道应用凭证 |
| 自有消息系统双向通信 | WebSocket 接入 | 手动创建实例或通过 /init 动态创建；使用 wst_ Token |
使用网页版对话
网页版对话 适合构建和验收，不适合作为业务系统集成接口。它依赖控制台登录态，在新标签页打开，并使用页面中选择的智能体实例。发送消息前应核对实例名称；环境未配置入口时，先联系管理员确认。
参见验证智能体实例。
使用业务客户端
后端服务和自有消息系统都可以通过 API 接入：使用 WebSocket 渠道账号及其 Token，经 HTTP 提交消息和中断响应，经 WebSocket 接收执行事件。
调用方负责可信用户映射、会话上下文、逐轮请求关联、事件处理和异常恢复。业务工具由调用方执行时，还需在中断后校验权限、执行工具并返回结果；批准工具不等于工具已经执行。
参见通过 API 调用智能体。完整练习参见构建可调用业务系统的工单助手。已有旧 Invoke 或 Bridge v1 集成参见迁移旧版智能体接入。
使用渠道
飞书、QQ 和 WebSocket 渠道账号不仅传递消息，也可以决定消息路由到现有实例，还是让用户通过 /init 创建专属实例。
只需让不同用户拥有各自的对话历史时，可以共享一个智能体实例并使用不同渠道会话。需要分别管理实例参数、状态、能力资源或生命周期时，再使用模板绑定按用户创建实例。
按用户开通的实例可以分别管理智能体配置、状态和生命周期，但不会自动让插件数据、外部凭证或业务权限彼此独立，并且会增加实例、能力资源和清理工作。参见通过渠道提供智能体。需要完整练习飞书模板绑定、两位用户分别开通和配置个人工作助手、解绑和重新初始化时，参见构建按用户开通的飞书个人工作助手。
如果调用方是自有消息系统，参见通过 API 调用智能体完成渠道账号、Token、鉴权和消息往返验证；实现协议客户端时再查阅 HTTP 与 WebSocket API 参考。
避免把实例创建方式混为一谈
- API 调用不会按每个请求动态创建新的智能体实例。
- 渠道模板绑定不会提前批量创建实例；用户发送
/init时才创建。 - 沙箱、MCP、记忆库等能力实例用于向智能体提供能力；智能体实例才是可以接受调用和消息的运行对象。
- 要获得可调用的智能体实例，请先创建智能体模板，再基于智能体模板创建实例。