14. 智能体、工具与审批

完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向智能体编辑者、使用智能体的成员和负责运行状态的管理员。智能体创建后，需要为它连接应用、管理技能，并在对话中决定工具调用是否需要确认。读完本章，你可以完成能力配置与凭据设置、读懂能力状态、在对话里处理工具确认，并在出现问题时找到排查入口。

14.1 能力配置入口

适用场景：了解智能体的能力在哪里配置、由谁配置。

前提：对智能体具有编辑权限。只有查看权限的成员能看到能力列表，但开关和配置项不可操作。

操作步骤

1. 在工作台「智能体」列表中打开目标智能体，进入详情页。
2. 选择「应用」页签管理外部系统与数据来源，选择「技能」页签管理技能和内置工具。

你会看到

注意：智能体只能使用当前工作空间已启用的能力。条目显示「需先启用」时，页面提示「请先在当前工作空间启用该能力，再将其绑定到智能体。」，需要工作空间管理员先启用，MCP 服务与 API 服务的发布和分发见第 22 章，技能与插件见第 23 章。

14.2 为智能体连接应用

适用场景：让智能体访问企业系统、知识库或数据源。

操作步骤

1. 需要连接自行部署的 MCP 服务时，在配置中填写「服务端点 URL」和「认证令牌」（可选），选择「保存配置」。由管理员维护的端点只显示只读值。
2. 智能体运行中时，在操作菜单选择「验证连接」，页面提示「已发起验证，状态稍后自动刷新」。
3. 对知识库类应用，可在「库范围」中选择「调用者可见的全部知识库」或「限定」到指定知识库。
4. 需要声明数据敏感度时，选择「数据声明」，勾选「数据敏感标签」，查看「流量规则预览」中的「模型路由」和「强制执行」结果，再设置「审计级别」（「完整」「基础」「无」）并「保存」。

你会看到

• 页面顶部汇总「N 个启用中的能力需要配置授权凭据」，点击条目可直接配置。
• 条目显示子能力启用数，例如「子能力 3/5」。
• 撤回某位用户在该应用上的授权时，选择「取消授权」，成功后提示「授权已取消」。

注意：智能体未运行时无法验证连接，页面提示「智能体未运行，请先启动再验证」。飞书相关 MCP 能力要求智能体先绑定飞书 IM 工具（见第 16 章），否则提示「请先绑定飞书渠道再启用飞书 MCP 能力。」数据连接本身的创建见第 11 章，知识库见第 10 章。

14.3 管理技能

适用场景：调整智能体可用的技能和内置工具，或为它安装新技能。

操作步骤

1. 在「技能」页签用筛选切换「全部」「工具」「技能」，或只看「自定义」技能；用「搜索工具或行为指南」查找。
2. 用开关启用或禁用条目。标为「平台默认」的能力不能在开关上移除。
3. 选择「添加技能」，在「搜索技能源」「来源地址」「上传 .zip」三个页签中选一种来源。在「搜索技能源」中选择一条结果即开始解析；填写来源地址（如 owner/repo、owner/repo@技能名、GitHub 或 GitLab 的仓库与目录地址，完整写法见第 23.8 节）或选择包含 SKILL.md 的 .zip 后，选择「解析来源」。只写技能名称不算来源，按名称查找请使用「搜索技能源」。
4. 解析完成后，页面列出该来源中的全部技能。勾选需要的技能，选择「分析所选（未分析 n 个）」，单次最多分析 20 个。从搜索结果进入、来源地址指向具体技能，或上传的 .zip 只有一个技能时，该技能已预先勾选并自动分析。
5. 选中某一行，右栏显示该技能的分析结果：「风险分析」检查清单（如「破坏性命令」「凭据外泄模式」「外部网络访问」「提示注入模式」等）和风险等级标尺，标明「平台默认准入线」与「你所在企业的准入线」。
6. 选择「确认安装（n）」，勾选且分析后可安装的技能装到该智能体。勾选但尚未分析的技能不会安装，按钮旁提示「另有 k 个未分析的技能不会安装」。
7. 对自定义技能，可在操作菜单中「编辑」技能文件（SKILL.md 不能删除或重命名），或删除。
8. 需要让自定义技能根据使用效果自动改进时，打开「允许此技能自进化」；在「历史」中查看版本并可「回滚到此版本」。
9. 工作空间已有同名技能的另一版本时，可选择「使用本空间版本」。

你会看到

• 被企业策略拒绝或命中安全规则的技能显示「企业策略拒绝」或「安全规则阻断」，自动取消勾选且无法自助安装，页面提示「如需安装，请联系管理员调整安装准入策略。」
• 解析或分析失败时，页面写明原因并给出处理方式，如「访问过于频繁，请稍后重试」时可选择「重试」，已勾选的技能保持不变；各类提示与处理见第 23.8 节「常见问题与处理」。
• 自进化仅对该智能体的自定义技能生效，每 24 小时最多自动改写 3 次，所有改写都保留在版本历史中。

注意：技能提交的审批单由管理员在「管理后台 › 护栏 › 审批中心」处理。安装前请先「查看内容」确认技能来源可信。

14.4 读懂能力状态

适用场景：能力在对话中不可用，需要判断原因。

操作步骤

1. 在「应用」或「技能」页签查看条目的「状态」列。
2. 将鼠标移到状态上查看具体原因。
3. 按下表处理，处理后等待状态变为「已就绪」或「已生效」。

你会看到

注意：常见原因还包括「未在工作空间启用」「凭据所属成员已离开工作区」「技能内容与审核版本不一致」「模型接口不支持此工具的参数结构」。前两类由工作空间管理员处理，后两类需联系平台管理员。

14.5 在对话中使用技能与应用

适用场景：在一次对话中明确指定使用某个技能、应用或文件。

操作步骤

1. 在智能体对话页的输入框中输入 /，从「技能」列表中选择要使用的技能。
2. 输入 @，从「应用」和「文件」两组候选中选择；搜索文件时需要输入一定数量的字符。
3. 输入任务内容并发送。

你会看到

• 若对话涉及的应用尚未就绪，输入区上方会显示就绪提示卡，提供配置授权凭据等操作入口。
• 工具调用、确认请求和结果回执显示在对话流中。

注意：只有对智能体已启用且可用的技能才会出现在 / 列表中。

14.6 选择访问权限

适用场景：决定当前对话中智能体调用工具前是否需要你确认。

操作步骤

1. 在对话输入区打开「访问权限」选择器。
2. 选择以下三种模式之一：

1. 选择「完全访问」时，若页面要求确认风险，勾选确认后才生效（未勾选时提示「请勾选确认才能启用」）。

你会看到

• 访问权限按对话生效，不修改工具本身的授权。
• 切换到「完全访问」时，当前对话中正在等待确认的那一次工具调用会随之放行。
• 智能体已接入面向外部用户的 IM 工具时，切换到「完全访问」需要再次确认。

注意：没有相应权限的账号看不到可选的「完全访问」，或选择后提示「需要管理员权限」。任何模式都不能绕过平台安全策略：没有授权、缺少凭据或被护栏拒绝的工具仍不可执行（见第 18 章）。

14.7 处理工具确认

适用场景：智能体请求执行一个需要你确认的工具。

操作步骤

1. 确认卡超时后显示「已过期」，需要让智能体重新发起该操作。

你会看到

• 确认卡可能标注来源：「策略」表示由平台策略要求确认，「已自动审查」表示已经过自动审查。
• 处理后，对话流中的记录显示「已选择允许一次」「已选择始终允许」或「已选择拒绝」，状态为「等待确认」「已批准」「已拒绝」「已在别处处理」「提交失败」或「提交状态未知」。

注意：出现「提交状态未知」时不要重复批准，先刷新对话，确认该操作是否已经执行。文件写入、命令执行、消息发送和外部系统变更属于高风险操作，建议保留确认，并在目标系统核对结果。

14.8 查看执行状态与错误恢复

适用场景：任务运行中断、失败，或模型不可用。

操作步骤

1. 提交任务后，在对话中查看生成进度、工具调用、确认请求和最终结果。
2. 网络中断时页面显示「进度同步中…」和「任务仍在云端运行，恢复后会自动续上。」；长时间未恢复时选择「刷新进度」，不要立即重发原任务。
3. 出现错误卡时，读取原因：模型不可用、额度用尽、速率限制或上游响应异常。
4. 确认没有外部副作用后选择「重试」；错误卡提供「更换模型」时，进入「智能体」页签按第 13.7 节切换。
5. 恢复后发送一条最小请求确认可用。

你会看到

• 「已完成」表示本次任务结束，不代表外部系统中的业务动作必然成功；以工具回执和目标系统状态为准。

注意：没有权限更换模型的成员，记录智能体名称、模型和发生时间，联系智能体编辑者或管理员。

14.9 运行历史、用量与操作审计

适用场景：回看智能体做过什么、用了多少资源、谁改过它的配置。

操作步骤

1. 「运行历史」页签：查看运行事件，列为「时间」「来源」「状态」「消息」；打开事件可看「错误信息」「容器日志」和「补充详情」。
2. 「用量统计」页签：查看该智能体的模型调用和 Token 用量。资料卡中也显示「模型调用」「输入 Token」「输出 Token」「本月 Token」。
3. 「操作审计」页签：查看用户和系统对该智能体做过的操作，列为「时间」「操作人」「操作」「对象」「结果」。

注意：操作审计记录的是配置与管理动作，不是任务执行结果；任务结果看「运行历史」和对话本身。全平台的审计与可观测数据见第 29、34 章。

14.10 管理员查看智能体运行状态

适用场景：管理员统一查看工作空间或全租户智能体的运行情况，处理异常智能体。

前提：具备运维管理权限。

操作步骤

1. 进入「管理后台 › 智能体 › 智能体运营」。
2. 用「搜索智能体名称」查找，列表列为「智能体」「状态」「服务状态」「工作区」「运行时」「升级状态」「节点」「创建时间」。
3. 在行的「更多操作」中选择「启动」「停止」「重启」「重新下发配置」或「查看生命周期事件」。
4. 打开智能体查看「智能体详情」：「身份」（所有者等）、「运行时」（运行镜像、模型、重启次数、最近重启）、「最近错误」（停止原因、错误时间、最近错误）和「事件」。
5. 运行时版本升级进行中时，页面顶部显示「运行时版本升级进行中」、目标版本和进度；可调整「同时升级上限」，升级暂停时可选择「恢复升级」。

你会看到

• 「运行时」列可能标注「运行时落后」，表示该智能体尚未更新到当前运行时版本。
• 修改同时升级上限后约 30 秒内生效，无需重启服务。

注意：停止智能体前会确认「确定要停止 名称 吗？停止后该智能体不再提供服务。」，请先通知使用者。

能力说明

---

上一章：13. 创建可复用智能体 · 下一章：15. 记忆、子智能体与任务委派