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