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