Skip to content

模板和实例如何影响资源

创建智能体实例时,插件可以使用能力模板,也可以使用现有能力实例。选择模板时,智能体实例使用模板固定值和允许填写的实例参数;选择现有实例时,智能体实例共享所选资源。

创建前,先确定能力资源是由各智能体实例分别使用,还是由多个实例共享。

选择模板后,创建智能体实例时会使用模板固定值和已开放的实例参数。选择现有能力实例后,多个智能体实例可能共享同一资源。创建后,请验证实际能力和资源关系。

选择资源引用方式

先根据资源是否需要由各智能体实例分别准备或由多个实例共享,选择在插件中引用能力模板或现有能力实例。

处理插件中的模板引用

插件配置引用能力模板时:

  1. 智能体实例使用模板中的固定配置。
  2. 只有模板明确开放的参数可在创建智能体实例时填写。
  3. 平台根据模板和实例参数准备对应能力资源。
  4. 创建后,在测试智能体实例中验证能力参数和实际运行结果。

MCP、知识库组、记忆库、沙箱和技能组的资源关系不同。选择模板前,请在对应能力页面确认其创建和共享方式。

处理插件中的现有实例引用

插件配置直接引用能力实例时,智能体实例使用该现有资源。多个智能体实例可能共享:

  • 同一个 MCP 实例。
  • 同一个知识库组实例。
  • 同一个技能组实例。
  • 同一个记忆库或沙箱配置,取决于具体使用方式。

共享资源变化可能立即影响多个智能体实例,应在生产变更前盘点引用。

处理版本、共享范围和动态创建关系

确定引用方式后,还需要按资源类型处理版本、共享范围和动态创建关系。以下内容说明技能组、记忆库和渠道账号的具体差异。

让 Skill 版本随技能组进入实例

技能组展示了模板和实例的一个具体差异:

  1. 技能组 - 模板 让平台在创建智能体实例时按统一基线准备技能组资源。
  2. 技能组 - 实例 让多个智能体实例共享一个已经存在的 Skill 组合。
  3. 两种方式都会保留每个 Skill 的版本选择,供运行时激活 Skill 和读取相关资源。

技能组负责版本选择、运行时激活和资源读取;沙箱负责执行。把技能组和沙箱添加到同一个智能体模板,不会自动把 Skill 文件放入沙箱。任务需要运行脚本时,应确认沙箱本身具备脚本、运行时和依赖,再显式执行并检查结果。

修改 Skill 或技能组后,不要把版本标记变化当作运行实例已经同步。更新测试智能体实例,并用目标版本独有的说明或资源完成回归后,再更新生产实例。

为多个智能体实例规划记忆库

在智能体模板的插件表单中,先根据多个智能体实例是否应共享记忆选择类型:

需要的结果智能体模板插件表单中的选择需要注意
多个智能体实例使用同一个现有记忆库记忆 - 实例,选择目标记忆库所有相关实例都能使用同一份记忆数据;修改或删除可能影响全部实例
每个新建智能体实例使用单独的记忆库资源记忆 - 模板,选择已有模板仅在列表中已有可选模板时使用

选择 记忆 - 实例 后,从该智能体模板创建的多个智能体实例都会连接所选记忆库。任何能够基于该智能体模板创建实例的人,创建出的实例也会连接同一份记忆数据。只有这些实例确实需要使用同一组记忆时,才共享一个现有记忆库;不要把个人或私有记忆库连接到供他人复用的智能体模板。需要使用不同现有记忆库时,应为每个隔离范围准备单独的智能体模板和记忆库。

选择 记忆 - 模板 后,平台在创建智能体实例时根据模板为该实例准备记忆库资源。同一个智能体实例会在后续会话中继续使用该资源。记忆库管理 页面只管理已经创建的记忆库及其中的记忆条目,不提供模板创建入口。列表中没有可选模板时,请联系平台管理员确认可用配置;需要保存用户私有信息时,不要改用一个由多个实例共享的现有记忆库。

这里确定的是智能体实例之间的记忆库范围。即使为每个实例分别使用单独的记忆库,也不等于同一个实例内的最终用户已经自动隔离;处理用户数据前,请使用不同调用方账号验证写入和检索范围。

处理渠道账号关系

渠道账号可以绑定已有智能体实例或智能体模板。渠道用户通过模板绑定发送 /init 后,平台为该用户创建专属智能体实例并保存用户绑定;这是按用户动态创建,不是批量预生成。

专属智能体实例不会改变智能体模板中已有的插件引用。如果模板选择 记忆 - 实例,不同用户通过 /init 创建的智能体实例仍会使用同一个记忆库。MCP、沙箱或其他能力也遵循各自的资源引用方式。需要分别准备能力资源时,请在相应能力支持的范围内引用能力模板,并在创建后检查实际资源关系。

实例和能力资源分别管理也不等于外部业务权限已经按用户区分。请根据外部 MCP Server、用户工具或业务 API 实际收到的凭证和调用方上下文落实授权;多个用户共用同一凭证时,应按共享权限边界处理。共享服务和按用户开通的选择原则参见选择共享服务或按用户开通

理解配置同步状态

智能体模板发生变化后,相关智能体实例可能显示需要手动更新。请逐个编辑并保存目标实例,再验证回复、工具和能力。

模板、绑定和实例是分别管理的资源:

  • 修改能力模板后,请更新受影响的测试智能体实例并验证结果,再处理生产实例。
  • 删除能力模板后,请在相应的实例列表中单独检查已有能力实例。
  • 删除渠道用户绑定后,请单独检查对应的智能体实例。
  • 删除知识库组实例不会删除知识库集合;请在 知识库管理 中单独管理集合。

记录生产资源关系

对每个生产智能体实例记录:

  • 来源智能体模板。
  • 实例参数。
  • 插件配置引用的能力模板和实际能力实例。
  • 渠道账号及绑定模式。
  • Agent API Token 负责人。
  • 环境和沙箱规格。
  • 变更和手动回退步骤。

生产变更或删除前,请维护模板、智能体实例、能力资源和渠道绑定之间的团队清单。控制台不会在一个页面中汇总全部依赖关系。