数字员工文档中心

产品说明书 / 知识与能力扩展

技能与 MCP

技能用于固化处理方法和交付规则,MCP 用于把外部工具、业务服务或知识库连接给数字员工。两者都需要安装或绑定后才能在对话中使用。

适用场景
标准化任务、接入外部工具、连接知识库与业务服务
管理对象
技能包、员工安装关系、MCP 服务、工具与认证
最终结果
数字员工按明确规则处理任务,并可受控调用外部能力

开始之前

技能告诉员工怎么做,MCP 提供员工能调用什么

技能可以包含说明、脚本和资源;MCP 则通过可发现的工具接口连接外部能力。一项任务可同时需要技能和 MCP。
技能
围绕某类任务组织的说明、脚本、模板和资源。
已具备
表示技能已安装到指定数字员工的可用范围。
技能包
用于上传、审核和安装的文件集合。
MCP 服务
向数字员工提供工具或资源的标准化连接。
MCP 应用
在对话中呈现一个 MCP 服务返回的交互界面。
认证配置
请求头、密钥或 OAuth 等服务身份信息。
目录中存在不等于当前员工可用

技能需要安装到员工,MCP 服务需要添加并启用。服务连接成功后,仍要单独验证工具权限、业务数据范围和密钥保管。

  1. 发现从目录查找能力
  2. 审查查看内容与权限
  3. 安装添加到目标员工
  4. 配置设置认证和使用范围
  5. 验证在对话中检查调用

技能市场与安装

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

技能目录、分类与搜索

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

入口
左侧“技能”
适用
用户需要为当前员工寻找新的业务能力时使用。
技能目录中的精选分类
技能目录中的精选分类

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

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

入口
技能页顶部视图切换
适用
用户需要在全量目录、当前员工能力和自己维护的技能之间切换时使用。
视图 · 我的创建
视图 · 我的创建

已具备技能与员工范围

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

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

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

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

入口
技能卡片详情
适用
安装或修改前需要了解能力边界和实现文件时使用。
技能详情、文件树与内容预览
技能详情、文件树与内容预览

技能安装、卸载与同步

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

入口
技能详情“安装”、已具备列表
适用
员工需要获得或移除某项技能时使用。
技能目录中的安装入口
技能目录中的安装入口

批量安装技能

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

入口
技能页批量操作
适用
新员工需要一次配置多项标准技能时使用。
技能更多操作与 AI 添加入口
技能更多操作与 AI 添加入口

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

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

入口
技能安装抽屉、员工智能体技能设置
适用
一名员工包含多个智能体,但技能只应交给其中某些角色时使用。
员工已具备的技能
员工已具备的技能

技能创建与测试

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

上传技能包

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

入口
技能页“上传技能”
适用
组织已有符合规范的技能文件,需要纳入平台管理时使用。

AI 辅助创建与修改技能

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

入口
技能页“创建技能”、编辑工作区
适用
业务人员有流程描述但没有完整技能包时使用。
技能同步与 AI 添加能力入口
技能同步与 AI 添加能力入口

技能编辑工作区与文件树

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

入口
技能编辑页
适用
技能包含 SKILL.md、脚本、模板或资料文件,需要统一维护时使用。
技能编辑工作区与模型用量控制
技能编辑工作区与模型用量控制

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

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

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

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

技能编辑工作区与模型用量控制
技能编辑工作区与模型用量控制

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

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

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

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

技能版本历史与恢复
技能版本历史与恢复

技能文件手工编辑

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

入口
技能编辑工作区文件编辑器
适用
作者需要精确修改触发条件、执行步骤或辅助文件时使用。
技能文件树与手工编辑
技能文件树与手工编辑

技能真实执行测试

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

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

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

技能执行测试与边缘场景
技能执行测试与边缘场景

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

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

入口
技能执行测试的“试一个边缘场景”
适用
技能在典型输入下已通过,需要检查异常输入和外部失败时使用。
技能执行测试与边缘场景
技能执行测试与边缘场景

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

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

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

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

技能运行环境与调用策略
技能运行环境与调用策略

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

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

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

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

技能运行环境与调用策略
技能运行环境与调用策略

技能依赖自动安装步骤

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

入口
技能编辑页“运行环境 → 自动安装”
适用
员工环境缺少技能依赖,需要给出统一安装方法时使用。

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

技能运行环境与调用策略
技能运行环境与调用策略

技能权限与发布

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

技能权限与使用范围

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

入口
技能详情或员工技能权限
适用
技能只允许特定员工、用户或角色使用时使用。
工具选择列表
工具选择列表

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

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

入口
技能编辑页“发布”、审核中心
适用
自建技能需要进入组织目录或对外发布时使用。
技能执行测试与边缘场景
技能执行测试与边缘场景

发布前检查与版本升级

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

入口
技能编辑页发布对话框、已具备技能更新提示
适用
新技能首次发布,或已发布技能准备升级时使用。

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

技能执行测试与边缘场景
技能执行测试与边缘场景

个人自学习开关

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

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

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

员工已具备的技能
员工已具备的技能

租户自学习策略

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

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

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

员工自学习策略、能力网络健康度与技能晋升
员工自学习策略、能力网络健康度与技能晋升

能力网络健康度

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

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

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

员工自学习策略、能力网络健康度与技能晋升
员工自学习策略、能力网络健康度与技能晋升

个人技能晋升

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

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

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

员工自学习策略、能力网络健康度与技能晋升
员工自学习策略、能力网络健康度与技能晋升

MCP 服务

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

MCP 服务目录、详情与安装

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

入口
员工控制台“MCP”、管理后台 MCP 服务
适用
数字员工需要连接标准工具或数据服务时使用。
MCP 服务目录与运行状态
MCP 服务目录与运行状态

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

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

入口
MCP 服务“新建”或“编辑”
适用
组织需要接入自建或第三方 MCP 服务时使用。

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

MCP 服务列表中的外部服务
MCP 服务列表中的外部服务

HTTP 接口转换为 MCP 工具

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

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

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

MCP 服务接入方式
MCP 服务接入方式

从 cURL 导入接口配置

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

入口
MCP 工具编辑器“导入 cURL”
适用
已有可运行的接口请求,希望减少手工录入时使用。

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

从 cURL 导入 MCP 接口配置
从 cURL 导入 MCP 接口配置

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

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

入口
MCP 服务编辑页“测试”
适用
服务已保存并运行,需要确认协议握手和工具调用结果时使用。

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

将 HTTP API 转为 MCP 工具
将 HTTP API 转为 MCP 工具

为单个知识库创建 MCP 服务

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

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

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

MCP 服务接入方式
MCP 服务接入方式

MCP 应用与交互结果

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

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

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

在员工控制台配置并启用 MCP 服务
在员工控制台配置并启用 MCP 服务

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

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

入口
对话输入区“技能”、回复工具记录
适用
已安装技能需要在真实任务中执行并验证时使用。
技能选择列表
技能选择列表