为智能体添加能力
在智能体开发服务平台（AgentWorks）中，只有当模型和提示词无法独立完成任务时，才添加外部能力。根据智能体还需要完成的任务，选择知识、工具、记忆、Skill、沙箱或子代理，再在智能体模板的 插件配置 中保存关联。
可以直接从任务选择能力，不必预先创建或理解所有插件、模板和实例类型。确定能力后，准备对应资源；只有控制台出现模板或实例选项时，再决定使用可复用配置准备资源，还是直接连接已有资源。
想先观察能力如何进入创建、接入和验证流程，可以从构建可追溯的企业知识助手或构建可调用业务系统的工单助手开始，再回到本页选择和替换能力。
根据任务选择能力
从要得到的运行结果出发选择能力。完成选择后，进入对应主题准备资源并查看验证方法。
| 任务需要 | 选择的插件或资源 | 继续配置 |
|---|---|---|
| 调用 Streamable HTTP MCP Server | MCP | 选择 MCP 实例或模板 |
| 检索平台中已入库的资料 | 知识库组 | 配置知识库组模板和实例 |
| 跨会话保存可供后续检索的信息 | 记忆库 | 添加并验证记忆库 |
| 复用版本化 Skill 内容 | 技能组 | 使用技能组为智能体提供一组 Skill |
| 隔离执行命令、代码或文件处理 | 沙箱 | 配置沙箱模板和实例 |
| 在 Playground 中提供自定义业务界面 | 沙箱（微应用） | 使用沙箱提供微应用界面 |
| 按需加载版本化 Skill 说明或相关资源 | 技能组 | 读取 Skill 引用的资源 |
| 使用控制台中可选的 AgentWorks 内置工具 | 平台工具包 | 使用平台工具包 |
| 让接入应用执行自定义业务工具 | 用户工具包 | 定义用户工具包 |
| 把部分任务交给另一个智能体实例 | 子代理 | 了解子代理和动态委托 |
处理工具调用时，先确认实际操作由谁执行：
| 实际执行方 | 选择的能力 | 运行结果 |
|---|---|---|
| AgentWorks | 平台工具包 | 执行控制台中可选的内置工具；不会创建或连接沙箱 |
| AgentWorks 外部的 MCP Server | MCP | 平台发现并调用远程 MCP 工具 |
| 通过 Invoke API 或 WebSocket 接入的业务系统 | 用户工具包 | 业务系统接收工具中断、执行操作并返回结果 |
| AgentWorks 提供的隔离执行环境 | 沙箱 | 智能体直接调用沙箱提供的命令、文件或执行工具 |
| 另一个已经验证的智能体实例 | 子代理 | 平台把任务异步委托给目标智能体实例 |
新建智能体模板默认开启文件系统功能，开启后直接提供智能体文件工具，无需添加插件。只做模型验证或不需要工作文件时应关闭。需要命令执行、特定运行时或外部对象存储挂载时，请使用沙箱。参见选择文件系统功能、沙箱和对象存储。
需要让智能体调用接收方维护的计划脚本，由脚本根据 manifest 匹配已批准校验器，再把对象存储输入、人工工具审批、确定性校验、Trace、沙箱运行记录和持久报告连成一条完整验收路径时，参见构建订单与退款交付验收助手。
如果租户管理员禁用了某种插件类型，该类型不能再添加到智能体模板。已有插件不会因此自动完成替换或资源清理。参见管理租户可用能力。
技能组和沙箱是两项独立能力。技能组让智能体按所选版本激活 Skill，并按需读取相关资源；沙箱提供命令、文件和代码执行环境。同一个智能体模板同时使用技能组和沙箱模板时，所选 Skill 文件会只读挂载到沙箱的 /skills 目录；直接使用已有沙箱实例时不会增加这项自动挂载。需要不同 Skill 集合时，默认选择沙箱模板。文件可用不表示脚本会自动执行或依赖已经安装。参见选择沙箱模板或实例。
理解能力如何关联到智能体
插件不是另一项需要单独创建的能力资源。插件配置保存智能体模板与能力资源之间的关联：
| 概念 | 回答的问题 | 示例 |
|---|---|---|
| 能力 | 智能体需要做什么 | 检索企业资料、调用工具、保存记忆或执行命令 |
| 能力资源 | 运行时实际连接或使用什么 | MCP 连接、记忆库、知识库组、技能组或沙箱 |
| 插件配置 | 智能体模板如何关联这项能力 | 在智能体模板中添加 MCP - 实例 或 记忆 - 实例 |
创建能力资源后，还需要在智能体模板的 插件配置 中选择对应对象。沙箱、MCP、知识库组、记忆库和技能组插件还需要指定模板或实例。模板和实例不是与插件并列的另一类能力，而是插件取得能力资源的方式。
决定如何取得能力资源
对于提供模板和实例选项的插件，先确定智能体实例应共享现有资源，还是在创建时按照一套可复用配置准备资源。
| 需要的结果 | 在插件配置中选择 | 创建智能体实例时的结果 |
|---|---|---|
| 连接一个已经存在并允许共享的固定资源 | 实例 | 智能体实例直接使用所选资源 |
| 使用统一基线，并按开放参数准备或绑定所需资源 | 模板 | 平台合并模板固定值和实例参数，再准备运行所需资源 |
| 为每个智能体实例按统一基线准备 Skill 组合 | 技能组 - 模板 | 平台根据模板准备技能组资源，并保留所选 Skill 版本 |
| 使用平台工具包或另一个智能体实例 | 对应的平台工具包或子代理选项 | 直接保存所选对象的关联，不显示模板和实例选择 |
| 让 Invoke API 调用方执行自定义工具 | 用户工具包 | 保存工具名称和输入输出结构，由调用方处理中断并返回结果 |
直接选择实例适合共享一个只读知识库组、固定 MCP 连接、技能组或确实需要共享的记忆库。选择 记忆 - 实例 后，从该智能体模板创建的所有智能体实例都会连接同一记忆库，因此不要把个人或私有记忆库连接到供他人复用的智能体模板。修改或删除共享资源前，应先确认哪些智能体模板和智能体实例正在使用该资源。
沙箱需要额外检查。选择现有沙箱实例会共享同一个逻辑沙箱资源，而不只是复用配置。只有所有引用方可以安全共享文件、Skill、执行状态、资源、环境变量和清理操作时，才选择现有沙箱实例；无法确认时，选择沙箱模板。参见了解共享沙箱的影响。
选择模板适用于重复使用统一能力设置，并在创建智能体实例时确定部分参数或资源关系。创建实例前，请在对应能力页面确认该模板会为实例准备独立资源，还是绑定已有资源；只有模板明确开放的参数可由实例填写。记忆 - 模板 仅在列表中已有可选模板时使用。参见模板和实例如何影响资源。
添加并验证能力
选定能力和资源取得方式后，先在智能体模板中保存插件关联，再通过测试智能体实例确认能力实际生效。
在插件配置中添加能力
- 准备要连接的能力资源、确认已有可选模板，或者设计需要添加的用户工具契约。
- 编辑或创建智能体模板。
- 打开 插件配置。
- 单击 添加插件。
- 在 类型 中选择需要的能力。
- 如果该类型提供模板和实例选项，选择 选择模板 或 选择实例，再选择目标对象。
- 对模板参数决定是否允许智能体实例创建者填写。
- 保存智能体模板。
- 在智能体模板详情页打开 插件，确认列表中的类型、名称和资源 ID 与预期一致。
- 创建智能体实例，或更新已有智能体实例，然后测试新增能力。
添加沙箱时，默认选择 沙箱 - 模板。只有已经完成共享实例检查时，才选择 沙箱 - 实例。
只有目标沙箱使用已经准备好的兼容环境时，才选择 微应用。该选项不会把普通沙箱转换成微应用环境。配置和验证方法参见使用沙箱提供微应用界面。
模板参数不是任意覆盖入口。智能体实例只能填写模板明确开放的参数。
插件 页签用于确认智能体模板已经保存哪些关联。要确认智能体实例在实际调用中使用该能力，还应在对应实例中执行代表性输入，并核对 Trace 或相关运行记录。
验证能力实际生效
保存插件后，至少完成以下验证：
- 确认来源智能体模板的 插件 页签中存在目标关联。
- 创建或更新测试智能体实例。
- 发送能明确触发该能力的输入。
- 在 Trace、能力管理页面或运行记录中确认使用了预期资源。
- 使用不会触发该能力或无权执行的输入验证边界。
只在能力资源管理页面看到资源，并不表示智能体已经关联该资源；只在 插件 页签看到关联，也不表示模型一定会在每次运行中选择该能力。
为工具调用配置审批
添加工具后，在智能体模板的 工具权限 中统一决定哪些调用自动批准、哪些调用自动拒绝，以及哪些调用等待人工审批。沙箱不再提供单独的工具审批开关；沙箱、MCP、平台工具包和其他可审批工具都使用智能体级规则。
工具权限规则不会添加工具，也不会授予外部系统权限。规则需要使用工具的可调用名称和输入 schema 顶层参数名；按参数值过滤时，还需要填写由你定义的 RE2 表达式。没有任何规则且默认处理为未指定时，人工审批关闭。查找字段的方法参见找到工具名称和参数名，配置步骤和验收方法参见配置工具审批流程。
委托任务给子代理
子代理引用的是一个已有智能体实例，而不是智能体模板。先围绕目标任务设计并测试被调用的智能体实例，再把它添加到主智能体模板。完整配置参见设计并关联子代理；渠道验证和后台任务排查参见运行和管理子代理委托。
子代理提供由模型决定是否发起的异步任务委托。配置时选择已有 AgentWorks 智能体实例；需要组合通过 Agent Card 或 A2A 服务地址接入的外部智能体时，在外部系统中完成协调。模型如何选择委托目标参见理解模型驱动的动态委托。需要精确定义节点、分支、循环或重试时，由 AgentWorks 之外的编排系统保存流程状态并调用相应智能体实例。