从智能体模板到智能体实例

连接 AI 助手

智能体模板保存模型、提示词和能力配置。智能体实例是实际运行、保存会话并被 网页版对话、API 或渠道使用的对象。完成智能体模板配置后，需要先得到一个智能体实例，才能验证或交付它。

理解设计如何投入运行

从保存设计到提供使用，智能体模板和智能体实例承担不同职责。

阶段	使用的对象	发生的事情
保存设计	智能体模板	构建者配置模型、提示词、能力关联和运行参数
准备运行	智能体实例	平台应用模板配置，并根据插件配置准备或连接所需能力资源
提供使用	智能体实例	构建者、业务系统或渠道用户通过 网页版对话、API 或渠道使用智能体

模板用于保存和复用设计，实例用于运行和交付。只有需要共享能力资源、为不同实例准备独立资源或管理配置更新时，才需要继续判断能力插件应选择模板还是实例。

什么时候需要智能体实例

以下任务都需要智能体实例：

• 在 网页版对话 中验证回复和多轮对话。
• 为业务客户端准备目标实例和访问凭证。
• 把渠道账号绑定到一个现有运行对象。
• 查看 Trace、调用任务和实例状态。

智能体模板保存名称、模型、提示词和能力配置。需要测试或接入时，请基于智能体模板创建智能体实例；智能体实例才是可以通过 网页版对话、渠道或 API 使用的运行对象。还在调整名称、模型或提示词且暂时不需要测试时，可以先不创建实例。

选择实例产生方式

实例可以由构建者手动创建，也可以在渠道用户首次使用时按需创建。

使用目标	实例如何产生	下一步
在 网页版对话 或 API 中使用	在控制台中手动创建	创建智能体实例
让渠道消息进入一个共享实例	先手动创建，再把渠道账号绑定到该实例	通过渠道提供智能体
让每个渠道用户使用专属实例	渠道账号绑定智能体模板，用户首次发送 /init 时创建	通过渠道提供智能体

API 调用使用已经存在的智能体实例，不会为每个请求自动创建新实例。渠道模板绑定也不会提前批量创建实例。

创建用于验证的第一个实例

1. 在 智能体模板 中确认智能体模板已经选择模型并保存提示词。

2. 打开 智能体实例。

   打开智能体实例

3. 单击 创建实例，选择刚才保存的智能体模板。

4. 从控制台侧栏打开 网页版对话，在新标签页的消息输入框下方选择刚创建的实例。

5. 选择 开启新对话，使用固定测试问题验证回复。

完整步骤参见创建智能体实例和验证智能体实例。

选择实际使用方式

实例通过验证后，根据调用方选择：

• 构建人员继续使用 网页版对话 调整配置。
• 业务系统使用 API 调用。
• 飞书、QQ 或自有消息系统使用渠道接入。

参见选择智能体的使用方式。更新智能体模板配置后，还需要验证受影响的实例；参见更新智能体模板并验证现有实例。