产品操作手册 / 知识与能力扩展

技能与 MCP

技能描述可复用的工作方法，MCP 服务提供标准化工具和数据接口。二者共同决定数字员工能以什么流程、调用什么外部能力完成任务。

适用人员: 业务用户、员工负责人、技能作者、集成管理员、审核人员
统一入口: 左侧导航“技能”、员工控制台 MCP 配置及管理后台能力治理
完成标准: 数字员工按明确规则处理任务，并可受控调用外部能力

开始之前

先确认权限、资料和运行条件

下面的准备项应在正式操作前完成。涉及外部发送、公开分享或高权限设置时，还需按组织流程完成审批。

本页角色分工

先按你的职责查阅；页面是否可操作，仍以账号实际权限为准。

普通业务用户: 在对话中选择当前员工已具备的技能或工具，并检查调用结果。
负责人: 为负责的员工安装、创建和测试技能，添加已批准的 MCP 服务。
管理员: 维护能力目录、发布审核、全局 MCP、认证配置和安全审计。

01
已选择要配置的数字员工。
02
外部服务地址、认证和网络连通性已准备。
03
技能内容和工具权限符合组织安全要求。

操作前注意

安装不等于可运行，仍需检查外部依赖和权限。
技能或服务升级可能改变输出和工具范围。
凭据不得写入技能正文或公开文件。

新手必学

日常工作首先掌握

进阶操作

有明确需要时使用

谨慎操作

可能影响权限、数据或运行状态

完整流程

从发现能力到员工可调用

技能规定任务怎么做，MCP 提供可以调用的工具或数据。目录中存在不代表当前员工已经可用。

01
确认需要哪类能力
标准流程和交付规范选择技能；外部工具、业务服务或知识检索选择 MCP。
02
审查内容和权限
查看说明、文件、工具、依赖和认证方式，确认数据范围与当前任务相符。
03
安装或添加给员工
选择目标员工，完成技能安装或 MCP 添加；不要把能力误装到其他员工。
04
配置连接和使用范围
填写必要参数、密钥或 OAuth 授权，启用服务并执行连接测试。
05
在对话中验证调用
新建话题提交可核对的任务，展开技能或工具记录，确认调用对象、返回数据和权限范围正确。

完成后确认

目标员工的已具备技能或 MCP 列表中能看到该能力。
连接和认证状态正常。
对话中的调用记录与预期能力、数据范围一致。

常见问题

目录中有能力，但员工看不到

检查是否已安装或添加给当前员工，再确认能力的可见范围和员工状态。

MCP 连接测试失败

核对地址、传输方式、请求头、密钥和网络可达性；从错误详情判断是认证还是服务不可用。

认证过期

按服务要求重新授权或更新密钥，保存后重新测试连接，并在新话题中验证调用。

工具返回了错误数据范围

立即停用该连接，核对租户、账号和服务端授权范围，修正后用低风险数据重新验证。

本页术语

先看懂页面里的名称

遇到下列名称时，按这里的含义理解。具体按钮和字段仍以当前页面为准。

技能: 围绕某类任务组织的说明、脚本、模板和资源。
已具备: 表示技能已安装到指定数字员工的可用范围。
技能包: 用于上传、审核和安装的文件集合。
MCP 服务: 向数字员工提供工具或资源的标准化连接。
MCP 应用: 在对话中呈现一个 MCP 服务返回的交互界面。
认证配置: 请求头、密钥或 OAuth 等服务身份信息。

技能市场与安装

从不同视图了解能力，再安装到指定员工或智能体。

技能目录、分类与搜索

新手必学建议操作人普通业务用户

按分类、关键词和适用范围浏览技能，并区分市场能力与已安装能力。

从哪进入: 左侧“技能”
何时使用: 用户需要为当前员工寻找新的业务能力时使用。

按顺序操作

进入技能页并确认当前员工。
选择分类或搜索关键词。
打开技能详情。
检查说明和依赖。

看到什么算完成

打开技能详情，检查说明和依赖。

全部技能、已具备与我的创建

新手必学建议操作人负责人 / 管理员

提供“全部技能”、“已具备”和“我的创建”视图；选中员工时，全部技能会优先排列更匹配的能力。

从哪进入: 技能页顶部视图切换
何时使用: 用户需要在全量目录、当前员工能力和自己维护的技能之间切换时使用。

按顺序操作

先选择目标员工。
在三个视图中切换并检查数据范围。
从“我的创建”进入编辑。
从“已具备”处理更新或移除。

看到什么算完成

从“我的创建”进入编辑，从“已具备”处理更新或移除。

已具备技能与员工范围

新手必学建议操作人普通业务用户

按员工展示已安装技能、同步状态和可用状态，并支持切换员工。

从哪进入: 技能页“已具备”
何时使用: 负责人需要确认某一员工当前可调用哪些技能时使用。

按顺序操作

切换到目标员工。
查看已具备列表和状态。
打开异常项检查权限、同步或依赖。

看到什么算完成

打开异常项检查权限、同步或依赖。

技能详情、文件树与工具调用

新手必学建议操作人普通业务用户

展示技能说明、使用方法、文件树、依赖和可调用工具。

从哪进入: 技能卡片详情
何时使用: 安装或修改前需要了解能力边界和实现文件时使用。

按顺序操作

打开技能详情。
查看说明、文件和工具列表。
确认适配当前任务后再安装或编辑。

看到什么算完成

确认适配当前任务后再安装或编辑。

技能安装、卸载与同步

谨慎操作建议操作人负责人 / 管理员

把技能安装到指定员工并同步运行环境，同时显示安装过程和结果。

从哪进入: 技能详情“安装”、已具备列表
何时使用: 员工需要获得或移除某项技能时使用。

按顺序操作

选择目标员工并点击安装。
确认权限和依赖。
等待同步完成。
在对话中调用一次。
移除时先检查现有任务依赖。

看到什么算完成

在对话中调用一次；移除时先检查现有任务依赖。

批量安装技能

进阶操作建议操作人负责人 / 管理员

批量选择技能和目标员工，并逐项显示安装成功、跳过或失败。

从哪进入: 技能页批量操作
何时使用: 新员工需要一次配置多项标准技能时使用。

按顺序操作

选择多项技能和目标员工。
确认安装清单与权限。
执行后查看每项结果，对失败项单独处理。

看到什么算完成

执行后查看每项结果，对失败项单独处理。

安装到指定主智能体或子智能体

进阶操作建议操作人负责人 / 管理员

在员工层级之下选择具体主智能体或子智能体作为技能安装目标，避免不相关角色获得能力。

从哪进入: 技能安装抽屉、员工智能体技能设置
何时使用: 一名员工包含多个智能体，但技能只应交给其中某些角色时使用。

按顺序操作

选择目标员工后展开智能体列表。
勾选需要该技能的具体角色。
安装并同步后，分别使用不同智能体验证可用性。

看到什么算完成

安装并同步后，分别使用不同智能体验证可用性。

技能创建与测试

维护技能文件、依赖与调用规则，并用真实输入和异常输入验证。

上传技能包

新手必学建议操作人负责人 / 管理员

校验并上传技能包，解析元数据和文件，形成可管理技能。

从哪进入: 技能页“上传技能”
何时使用: 组织已有符合规范的技能文件，需要纳入平台管理时使用。

按顺序操作

选择技能包并上传。
检查解析后的名称、说明和文件。
保存后在技能目录定位。
并进行安装验证。

看到什么算完成

保存后在技能目录定位，并进行安装验证。

AI 辅助创建与修改技能

新手必学建议操作人负责人 / 管理员

通过对话式工作区生成、预览和迭代技能文件，并保留工作区草稿。

从哪进入: 技能页“创建技能”、编辑工作区
何时使用: 业务人员有流程描述但没有完整技能包时使用。

按顺序操作

描述业务目标、输入和输出规则。
检查生成的说明和文件，提出修改。
预览验证后保存或提交发布。

看到什么算完成

预览验证后保存或提交发布。

技能编辑工作区与文件树

进阶操作建议操作人负责人 / 管理员

以左侧文件树、中间编辑区和右侧对话测试区组织技能工作区，并保留草稿状态。

从哪进入: 技能编辑页
何时使用: 技能包含 SKILL.md、脚本、模板或资料文件，需要统一维护时使用。

按顺序操作

在文件树选择或新增文件。
编辑内容后检查未保存状态。
切换文件和预览。
确认修改已落盘。

看到什么算完成

切换文件和预览，确认修改已落盘。

技能编辑模型、用量与中止

进阶操作建议操作人负责人 / 管理员

可在工作区选择可用模型，实时显示累计 Token 和成本，并中止正在进行的生成。

从哪进入: 技能编辑工作区顶部与对话区
何时使用: 作者需要选择创建模型、观察 Token 和成本，或停止方向不对的生成时使用。

按顺序操作

在顶部选择适合当前任务的模型。
执行时观察 Token、成本和生成状态。
发现方向错误时停止，修改要求后再次执行。

看到什么算完成

发现方向错误时停止，修改要求后再次执行。

操作限制与风险

停止只结束当前生成，不会自动撤销已写入的工作区文件。

技能快照、版本详情与恢复

谨慎操作建议操作人负责人 / 管理员

手工保存快照，查看各版本的文件数、大小和文件明细，并在确认后恢复指定版本。

从哪进入: 技能编辑工作区“版本历史”
何时使用: 重大修改前需要留存节点，或者当前内容需要回到较早版本时使用。

按顺序操作

重大修改前先保存快照。
打开版本详情。
核对文件列表和时间。
确认恢复后重新打开关键文件。
执行一次回归测试。

看到什么算完成

确认恢复后重新打开关键文件，再执行一次回归测试。

操作限制与风险

恢复前会先保存当前文件为新快照；恢复工作区文件不等于回退已发布技能。

技能文件手工编辑

新手必学建议操作人负责人 / 管理员

直接编辑 SKILL.md 和其他文件，并提供分屏预览、文件快捷操作和元数据校验。

从哪进入: 技能编辑工作区文件编辑器
何时使用: 作者需要精确修改触发条件、执行步骤或辅助文件时使用。

按顺序操作

打开 SKILL.md 或目标资源文件。
使用精确的触发词、输入输出和边界编辑内容。
预览并通过元数据检查后保存。

看到什么算完成

预览并通过元数据检查后保存。

技能真实执行测试

谨慎操作建议操作人负责人 / 管理员

把草稿技能作为已安装能力进行对话，并在沙箱中执行脚本、安装允许依赖，以验证真实效果。

从哪进入: 技能编辑页“执行这个技能”
何时使用: 发布前需要确认技能会按 SKILL.md 实际执行脚本和依赖时使用。

按顺序操作

保存最新 SKILL.md 和相关文件。
用典型真实输入执行技能。
检查命令、工具、生成文件和错误处理。

看到什么算完成

检查命令、工具、生成文件和错误处理。

操作限制与风险

测试会真实执行脚本和可能的网络依赖，应使用非生产数据和受控凭据。

输入缺失、格式异常与依赖失败测试

谨慎操作建议操作人负责人 / 管理员

构造常见输入缺失、格式错误或依赖不可用情况，检查技能是否给出可理解的拒绝或恢复路径。

从哪进入: 技能执行测试的“试一个边缘场景”
何时使用: 技能在典型输入下已通过，需要检查异常输入和外部失败时使用。

按顺序操作

在执行测试中选择边缘场景。
检查输入校验、错误说明和副作用。
把未覆盖的处理规则补入 SKILL.md 并重测。

看到什么算完成

把未覆盖的处理规则补入 SKILL.md 并重测。

操作系统、命令、环境变量与配置依赖

谨慎操作建议操作人负责人 / 管理员

声明 macOS、Linux 或 Windows 兼容性，所需命令、任一命令、环境变量和配置项，用于安装前检查。

从哪进入: 技能编辑页“运行环境”
何时使用: 技能需要特定系统、命令行工具、环境变量或宿主配置时使用。

按顺序操作

选择支持的操作系统。
填写必需命令、环境变量和配置项。
在每种目标环境安装并执行一次回归。

看到什么算完成

在每种目标环境安装并执行一次回归。

操作限制与风险

环境变量字段用于声明名称，不应把真实密钥写入技能包。

用户主动调用与禁止模型自动调用

谨慎操作建议操作人负责人 / 管理员

分别配置是否允许用户通过命令主动调用，以及是否禁止 AI 自动调用。

从哪进入: 技能编辑页“运行环境 → 调用策略”
何时使用: 技能只允许用户明确触发，或需要控制模型是否可自主选用时使用。

按顺序操作

确认技能的风险等级和预期触发方式。
设置用户可调用和模型自动调用开关。
分别用命令和普通对话测试触发结果。

看到什么算完成

分别用命令和普通对话测试触发结果。

操作限制与风险

禁止模型自动调用后，技能不会出现在 AI 可自主选择的列表中，但仍可按配置由用户命令触发。

技能依赖自动安装步骤

谨慎操作建议操作人负责人 / 管理员

配置 Homebrew、Node、Go、uv 或下载解压等安装步骤，依赖缺失时由客户端或网关提示或自动执行。

从哪进入: 技能编辑页“运行环境 → 自动安装”
何时使用: 员工环境缺少技能依赖，需要给出统一安装方法时使用。

按顺序操作

为每个依赖选择安装类型。
填写包名、模块、URL、目标目录和预期命令。
在干净的测试环境执行安装和技能回归。

看到什么算完成

在干净的测试环境执行安装和技能回归。

操作限制与风险

自动安装步骤会修改目标环境；下载地址、包来源和命令应经过供应链安全审查。

技能权限与发布

控制使用范围、发布版本、自学习和技能晋升。

技能权限与使用范围

谨慎操作建议操作人普通业务用户

控制技能可见、安装和调用范围，并在会话调用时执行权限校验。

从哪进入: 技能详情或员工技能权限
何时使用: 技能只允许特定员工、用户或角色使用时使用。

按顺序操作

打开技能权限设置。
选择主体和允许范围。
保存后用授权与未授权账号分别验证。

看到什么算完成

保存后用授权与未授权账号分别验证。

技能发布、审核与生命周期

谨慎操作建议操作人负责人 / 管理员

管理草稿、提交审核、发布、下架和版本变更。

从哪进入: 技能编辑页“发布”、审核中心
何时使用: 自建技能需要进入组织目录或对外发布时使用。

按顺序操作

完成技能验证并提交发布。
审核人检查文件、权限和工具范围。
发布后安装回归。
重大修改重新审核。

看到什么算完成

发布后安装回归；重大修改重新审核。

发布前检查与版本升级

谨慎操作建议操作人负责人 / 管理员

在发布前检查 SKILL.md、操作系统、依赖、安装步骤和调用策略，并将新版本按审核和升级流程交付。

从哪进入: 技能编辑页发布对话框、已具备技能更新提示
何时使用: 新技能首次发布，或已发布技能准备升级时使用。

按顺序操作

完成发布检查清单中的阻断项。
填写版本和变更说明。
提交审核。
发布后将目标员工升级到新版本，重新执行回归。

看到什么算完成

发布后将目标员工升级到新版本，重新执行回归。

操作限制与风险

审核通过前当前已发布版本继续生效；升级可能改变输出或依赖，应先在测试员工验证。

个人自学习开关

谨慎操作建议操作人普通业务用户

设置当前账号的自学习偏好，对本人的全部分身生效，不是只修改页面上当前选中的一名员工。

从哪进入: 技能页员工选择区“员工自学习”
何时使用: 你希望自己的分身在复杂任务后复盘，并尝试沉淀个人技能时使用。

按顺序操作

在技能页选择一名有权访问的员工。
根据自己的工作需要开启或关闭自学习。
在“我的创建”中检查后续产生的个人技能。

看到什么算完成

在“我的创建”中检查后续产生的个人技能。

操作限制与风险

租户策略为“关闭”时，页面不显示该开关；个人偏好不会绕过技能审核、依赖和工具权限。

租户自学习策略

谨慎操作建议操作人管理员

提供“关闭”、“默认关闭，员工可开启”和“默认开启，员工可关闭”三种策略，同时设置每人每分身的自学技能上限和每人每日复盘上限。

从哪进入: 管理后台“技能治理 → 员工自学习策略”
何时使用: 组织需要统一决定自学习是否开放，并限制技能数量和每日复盘量时使用。

按顺序操作

根据组织的数据与用量要求选择默认策略。
设置个人技能数量和每日复盘上限。
保存后等待下次心跳生效。
再用普通账号检查开关状态。

看到什么算完成

保存后等待下次心跳生效，再用普通账号检查开关状态。

操作限制与风险

策略不提供“强制开启且不可关闭”；超出个人技能上限后，新技能仍可发布到“我的创建”，但不再自动安装。

能力网络健康度

谨慎操作建议操作人管理员

汇总已发布、待审核、可晋升、贡献者、复用次数、平均有效性、已隔离和建议复审等指标。

从哪进入: 管理后台“技能治理 → 能力网络健康度”
何时使用: 管理员需要了解租户内技能的发布、复用、有效性和风险情况时使用。

按顺序操作

进入技能治理页。
先查看隔离和建议复审项。
检查复用与有效性。
对异常技能进入审核或编辑流程处理。

看到什么算完成

对异常技能进入审核或编辑流程处理。

操作限制与风险

健康度是治理汇总，不代表单个技能已通过安全和业务审核。

个人技能晋升

谨慎操作建议操作人管理员

列出达到复用和有效性条件的候选技能，支持晋升到指定团队或全租户，原作者归属保留。

从哪进入: 管理后台“技能治理 → 晋升候选”
何时使用: 一项个人技能已被多个分身稳定复用，需要开放给团队或全租户时使用。

按顺序操作

打开候选技能。
检查复用数、有效性和贡献者。
选择团队或全租户作为晋升范围。
晋升后用范围内普通账号检查可见和安装状态。

看到什么算完成

晋升后用范围内普通账号检查可见和安装状态。

操作限制与风险

出现在候选列表只表示达到系统阈值；晋升前仍应复核内容、依赖、权限和适用范围。

MCP 服务

管理内置与外部服务，并在对话中检查工具和交互结果。

MCP 服务目录、详情与安装

新手必学建议操作人管理员

集中管理 MCP 服务定义、工具清单和安装状态，并绑定目标员工。

从哪进入: 员工控制台“MCP”、管理后台 MCP 服务
何时使用: 数字员工需要连接标准工具或数据服务时使用。

按顺序操作

打开 MCP 服务目录。
查看连接方式、工具和权限要求。
安装到目标员工并执行连通性验证。

看到什么算完成

安装到目标员工并执行连通性验证。

外部 MCP 服务、认证与导入导出

谨慎操作建议操作人负责人 / 管理员

配置地址、传输方式、请求头、OAuth 或密钥，并支持配置导入导出。

从哪进入: MCP 服务“新建”或“编辑”
何时使用: 组织需要接入自建或第三方 MCP 服务时使用。

按顺序操作

填写服务地址和传输方式。
配置认证并执行连接测试。
保存后检查工具列表，导出时确认不含明文凭据。

看到什么算完成

保存后检查工具列表，导出时确认不含明文凭据。

操作限制与风险

只接入受信服务；密钥应进入安全存储，导出文件不得包含可直接使用的秘密。

HTTP 接口转换为 MCP 工具

谨慎操作建议操作人管理员

把接口方法、地址、参数、请求头、认证和超时配置成一个或多个 MCP 工具，并可分别启停。

从哪进入: 管理后台“MCP 服务 → 将 HTTP API 配置为 MCP Tool”
何时使用: 已有普通 HTTP 接口，希望让数字员工按标准工具方式调用时使用。

按顺序操作

新建服务并填写基本信息。
为每个接口配置工具名称、参数、认证和请求规则。
保存并启动后检查工具发现结果。

看到什么算完成

保存并启动后检查工具发现结果。

操作限制与风险

工具参数和权限应按最小范围设计；写操作接口还需要在业务侧保留鉴权、幂等和审计。

从 cURL 导入接口配置

谨慎操作建议操作人负责人 / 管理员

解析 cURL 中的地址、方法、请求头、认证和参数，覆盖并填充当前工具草稿。

从哪进入: MCP 工具编辑器“导入 cURL”
何时使用: 已有可运行的接口请求，希望减少手工录入时使用。

按顺序操作

在测试环境确认 cURL 可用并移除真实秘密。
粘贴命令并执行导入。
逐项检查自动填充内容。
再补充工具名称和参数说明。

看到什么算完成

逐项检查自动填充内容，再补充工具名称和参数说明。

操作限制与风险

导入会覆盖当前工具草稿；命令中的令牌、Cookie 和个人数据应先替换为安全配置。

MCP 连接、工具发现与调用测试

进阶操作建议操作人负责人 / 管理员

通过标准客户端完成初始化、工具发现和指定工具调用，并显示协议版本、耗时和原始响应。

从哪进入: MCP 服务编辑页“测试”
何时使用: 服务已保存并运行，需要确认协议握手和工具调用结果时使用。

按顺序操作

先保存并启动服务。
打开测试。
确认传输协议和工具列表。
选择工具、填写 JSON 参数并检查响应。

看到什么算完成

选择工具、填写 JSON 参数并检查响应。

操作限制与风险

测试读取已保存配置，不包含当前未保存的修改；会产生真实调用的工具应使用非生产参数。

为单个知识库创建 MCP 服务

谨慎操作建议操作人管理员

选择一个已启用知识库，生成只访问该库的 MCP 地址和服务标识，再安装到目标员工。

从哪进入: 管理后台“MCP 服务 → 添加内置 MCP”
何时使用: 需要把指定知识库独立提供给员工，而不是开放全部知识资产时使用。

按顺序操作

先创建并启用目标知识库。
选择知识库并填写服务名称。
保存后安装到员工，在对话中检索并核对引用来源。

看到什么算完成

保存后安装到员工，在对话中检索并核对引用来源。

操作限制与风险

服务只关联选定知识库；知识库停用、权限变化或删除后，员工调用结果也会受影响。

MCP 应用与交互结果

谨慎操作建议操作人负责人 / 管理员

在隔离框架中呈现 MCP 应用结果，并把用户交互安全回传给当前会话。

从哪进入: 对话中的 MCP 应用卡片
何时使用: 工具返回表单、看板或其他交互界面时使用。

按顺序操作

在对话中调用支持应用界面的工具。
检查应用来源和请求权限。
完成交互并确认结果写回当前任务。

看到什么算完成

完成交互并确认结果写回当前任务。

操作限制与风险

应用在隔离环境中运行；涉及外部提交或敏感字段时必须再次核对目标和内容。

会话中调用技能与查看执行记录

新手必学建议操作人普通业务用户

把所选技能附加到消息，执行后展示过程、工具调用和交付文件。

从哪进入: 对话输入区“技能”、回复工具记录
何时使用: 已安装技能需要在真实任务中执行并验证时使用。

按顺序操作

在对话中选择目标技能。
补齐技能要求的资料和参数。
发送后检查执行记录与输出格式。

看到什么算完成

发送后检查执行记录与输出格式。