模板和实例如何影响资源
创建智能体实例时,插件可以使用能力模板,也可以使用现有能力实例。选择模板时,智能体实例使用模板固定值和允许填写的实例参数;选择现有实例时,智能体实例共享所选资源。
创建前,先确定能力资源是由各智能体实例分别使用,还是由多个实例共享。
选择模板后,创建智能体实例时会使用模板固定值和已开放的实例参数。选择现有能力实例后,多个智能体实例可能共享同一资源。创建后,请验证实际能力和资源关系。
选择资源引用方式
先根据资源是否需要由各智能体实例分别准备或由多个实例共享,选择在插件中引用能力模板或现有能力实例。
处理插件中的模板引用
插件配置引用能力模板时:
- 智能体实例使用模板中的固定配置。
- 只有模板明确开放的参数可在创建智能体实例时填写。
- 平台根据模板和实例参数准备对应能力资源。
- 创建后,在测试智能体实例中验证能力参数和实际运行结果。
MCP、知识库组、记忆库、沙箱和技能组的资源关系不同。选择模板前,请在对应能力页面确认其创建和共享方式。
处理插件中的现有实例引用
插件配置直接引用能力实例时,智能体实例使用该现有资源。多个智能体实例可能共享:
- 同一个 MCP 实例。
- 同一个知识库组实例。
- 同一个技能组实例。
- 同一个记忆库或沙箱配置,取决于具体使用方式。
共享资源变化可能立即影响多个智能体实例,应在生产变更前盘点引用。
处理版本、共享范围和动态创建关系
确定引用方式后,还需要按资源类型处理版本、共享范围和动态创建关系。以下内容说明技能组、记忆库和渠道账号的具体差异。
让 Skill 版本随技能组进入实例
技能组展示了模板和实例的一个具体差异:
- 技能组 - 模板 让平台在创建智能体实例时按统一基线准备技能组资源。
- 技能组 - 实例 让多个智能体实例共享一个已经存在的 Skill 组合。
- 两种方式都会保留每个 Skill 的版本选择,供运行时激活 Skill 和读取相关资源。
技能组负责版本选择、运行时激活和资源读取;沙箱负责执行。把技能组和沙箱添加到同一个智能体模板,不会自动把 Skill 文件放入沙箱。任务需要运行脚本时,应确认沙箱本身具备脚本、运行时和依赖,再显式执行并检查结果。
修改 Skill 或技能组后,不要把版本标记变化当作运行实例已经同步。更新测试智能体实例,并用目标版本独有的说明或资源完成回归后,再更新生产实例。
为多个智能体实例规划记忆库
在智能体模板的插件表单中,先根据多个智能体实例是否应共享记忆选择类型:
| 需要的结果 | 智能体模板插件表单中的选择 | 需要注意 |
|---|---|---|
| 多个智能体实例使用同一个现有记忆库 | 记忆 - 实例,选择目标记忆库 | 所有相关实例都能使用同一份记忆数据;修改或删除可能影响全部实例 |
| 每个新建智能体实例使用单独的记忆库资源 | 记忆 - 模板,选择已有模板 | 仅在列表中已有可选模板时使用 |
选择 记忆 - 实例 后,从该智能体模板创建的多个智能体实例都会连接所选记忆库。任何能够基于该智能体模板创建实例的人,创建出的实例也会连接同一份记忆数据。只有这些实例确实需要使用同一组记忆时,才共享一个现有记忆库;不要把个人或私有记忆库连接到供他人复用的智能体模板。需要使用不同现有记忆库时,应为每个隔离范围准备单独的智能体模板和记忆库。
选择 记忆 - 模板 后,平台在创建智能体实例时根据模板为该实例准备记忆库资源。同一个智能体实例会在后续会话中继续使用该资源。记忆库管理 页面只管理已经创建的记忆库及其中的记忆条目,不提供模板创建入口。列表中没有可选模板时,请联系平台管理员确认可用配置;需要保存用户私有信息时,不要改用一个由多个实例共享的现有记忆库。
这里确定的是智能体实例之间的记忆库范围。即使为每个实例分别使用单独的记忆库,也不等于同一个实例内的最终用户已经自动隔离;处理用户数据前,请使用不同调用方账号验证写入和检索范围。
处理渠道账号关系
渠道账号可以绑定已有智能体实例或智能体模板。渠道用户通过模板绑定发送 /init 后,平台为该用户创建专属智能体实例并保存用户绑定;这是按用户动态创建,不是批量预生成。
专属智能体实例不会改变智能体模板中已有的插件引用。如果模板选择 记忆 - 实例,不同用户通过 /init 创建的智能体实例仍会使用同一个记忆库。MCP、沙箱或其他能力也遵循各自的资源引用方式。需要分别准备能力资源时,请在相应能力支持的范围内引用能力模板,并在创建后检查实际资源关系。
实例和能力资源分别管理也不等于外部业务权限已经按用户区分。请根据外部 MCP Server、用户工具或业务 API 实际收到的凭证和调用方上下文落实授权;多个用户共用同一凭证时,应按共享权限边界处理。共享服务和按用户开通的选择原则参见选择共享服务或按用户开通。
理解配置同步状态
智能体模板发生变化后,相关智能体实例可能显示需要手动更新。请逐个编辑并保存目标实例,再验证回复、工具和能力。
模板、绑定和实例是分别管理的资源:
- 修改能力模板后,请更新受影响的测试智能体实例并验证结果,再处理生产实例。
- 删除能力模板后,请在相应的实例列表中单独检查已有能力实例。
- 删除渠道用户绑定后,请单独检查对应的智能体实例。
- 删除知识库组实例不会删除知识库集合;请在 知识库管理 中单独管理集合。
记录生产资源关系
对每个生产智能体实例记录:
- 来源智能体模板。
- 实例参数。
- 插件配置引用的能力模板和实际能力实例。
- 渠道账号及绑定模式。
- Agent API Token 负责人。
- 环境和沙箱规格。
- 变更和手动回退步骤。
生产变更或删除前,请维护模板、智能体实例、能力资源和渠道绑定之间的团队清单。控制台不会在一个页面中汇总全部依赖关系。