技能与工具
智能助手本身能检索知识库、读写文件、生成 Office 文档。要让它按公司的固定流程办事、或者去操作公司的业务系统，靠的是技能和工具：
| 技能 | 工具 | |
|---|---|---|
| 是什么 | 一套写好的工作方法：做什么、按什么顺序、产出什么 | 一个能调用的外部能力，比如查 CRM、建工单、发邮件 |
| 怎么来 | 上传 ZIP 技能包 | 登记 MCP 服务 |
| 例子 | 合同审查、投标文件对照、周报整理 | 查询订单、创建审批单 |
两者都在空间的「管理后台」→「能力接入」下，由管理员维护，再通过资源授权给需要的人。
技能
技能包长什么样
一个技能就是一个 ZIP 包，根目录有一个 SKILL.md，开头写清楚它是什么：
---
name: contract-review
description: 按公司合同审查要点逐条检查合同，输出风险清单（Word）。用户上传合同并要求审查时使用。
version: 1.2.0
allowed-tools: knowledge_search knowledge_read present
---
# 合同审查
1. 先读用户上传的合同，列出合同类型、双方、金额、期限；
2. 检索「法务制度」知识库里的《合同审查要点》，逐条对照；
...
| 字段 | 说明 |
|---|---|
name | 技能标识，小写字母、数字和短横线 |
description | 什么时候该用这个技能。智能助手靠它判断要不要调用，写清适用场景 |
version | 版本号，选填 |
allowed-tools | 这个技能只允许调用哪些工具，选填；不写就是不限 |
completion-tools | 完成判据，选填：必须调用过这些工具才算完成，比如必须交付了文件 |
SKILL.md 正文写具体步骤，包里还可以放模板、参考资料、脚本。
上传与发布
- 「管理后台」→「技能」，上传 ZIP 包，先成为草稿；
- 在技能详情里看说明、可调用的工具、完成判据，确认无误后发布；
- 到「资源授权」里授给需要的部门或用户组，他们在对话里就能用。
以后改了技能，上传新版本会先成为新的草稿，发布前不影响正在用的版本。技能可以停用、删除。
员工使用时，可以在输入框里 @技能名 直接调用，也可以只描述需求，由智能助手判断该用哪个技能。
看技能用得怎么样
技能详情的「最近运行」里，按版本汇总成功率、主要失败在哪一步、平均耗时，下面是最近每一次运行，点开能看那一轮的每一步。新版本发布后，用它对比效果有没有变好。
工具（MCP）
登记 MCP 服务
「管理后台」→「工具与 MCP」，添加 MCP 服务：
| 字段 | 说明 |
|---|---|
| 名称 | 显示用 |
| 标识 | 工具名的前缀，比如 crm，它提供的工具在 KnowWork 里叫 mcp__crm__xxx |
| 地址 | MCP 服务的 Streamable HTTP 端点，一般以 /mcp 结尾 |
| 请求头 | 鉴权信息放这里，加密保存，保存后不再显示 |
| 单次调用超时 | 秒 |
保存后会拉取它提供的工具清单，之后可以随时「刷新」。
风险等级与审批
每个工具有一个风险等级，默认按工具自己的声明判断：
| 等级 | 例子 | 默认 |
|---|---|---|
| 只读 | 查订单、查库存 | 直接执行 |
| 写入 | 建工单、改状态 | 执行前要提问人批准 |
| 高风险 | 删除数据、对外发消息 | 执行前要提问人批准 |
在 MCP 服务的工具清单里，可以逐个工具调整风险等级、审批方式，或者停用某个工具，改完立即生效，正在进行的对话也一样。
审批卡片会写清楚要做什么、对谁做，由提问人自己点「批准」或「拒绝」。这和授权是两道闸：先要被授权使用这个工具，用的时候再审批。
建议
新接入的工具先只授给试点用户组，确认没问题再放开。写入类工具保留审批，不建议关掉。
对外部系统开放 KnowWork
反过来，别的系统也可以调用 KnowWork 的知识库检索，见对外接口。