选择智能体的使用方式

先确认调用方是谁、是否需要独立实例以及由谁持有凭证，再选择控制台、API 调用或渠道。所有方式最终都使用智能体实例。

比较访问方式

根据调用方、交付目标和需要准备的运行对象选择访问方式。

调用方和目标	推荐方式	运行准备
构建人员在控制台验证	Playground	手动创建实例；使用控制台登录态
后端服务调用	API 调用	手动创建实例；使用 dbg_ 或 agt_ Bearer Token
飞书或 QQ 共用一个智能体实例	渠道实例绑定	手动创建实例；配置渠道应用凭证
每个渠道用户使用专属智能体实例	渠道模板绑定和 /init	首次使用时动态创建实例；配置渠道应用凭证
自有消息系统双向通信	WebSocket 接入	手动创建实例或通过 /init 动态创建；使用 wst_ Token

使用 Playground

Playground 适合构建和验收，不适合作为业务系统集成接口。它依赖控制台登录态并只面向当前智能体实例。

参见验证智能体实例。

使用 API 调用

API 调用适合服务到服务调用，支持：

• 同步和 SSE 流式响应。
• 用 session_id 继续会话。
• 响应工具批准或用户输入中断。
• 查询和重置调用任务状态。
• 上传文件并把限时 URL 作为输入。

参见通过 API 调用智能体。需要观察业务调用方如何接收工具中断、执行查询并返回结果时，参见构建可调用业务系统的工单助手。

使用渠道

飞书、QQ 和 WebSocket 渠道账号不仅传递消息，也可以决定消息路由到现有实例，还是让用户通过 /init 创建专属实例。

只需让不同用户拥有各自的对话历史时，可以共享一个智能体实例并使用不同渠道会话。需要分别管理实例参数、状态、能力资源或生命周期时，再使用模板绑定按用户创建实例。

按用户开通的实例可以分别管理智能体配置、状态和生命周期，但不会自动让插件数据、外部凭证或业务权限彼此独立，并且会增加实例、能力资源和清理工作。参见通过渠道提供智能体。需要完整练习飞书模板绑定、两位用户分别开通实例、解绑和重新初始化时，参见构建按用户开通的飞书助手。

避免把实例创建方式混为一谈

• API 调用不会按每个请求动态创建新的智能体实例。
• 渠道模板绑定不会提前批量创建实例；用户发送 /init 时才创建。
• 沙箱、MCP、记忆库等能力实例用于向智能体提供能力；智能体实例才是可以接受调用和消息的运行对象。
• 要获得可调用的智能体实例，请先创建智能体模板，再基于智能体模板创建实例。