技能

技能是把现场反复出现的作业方式整理下来，让智能体记住。只要创建一次，后续会话中无需再次说明同样的工作。

列表与注册

方法	路径	作用
GET	/api/skills	技能列表
POST	/api/skills	新建技能
PATCH	/api/skills/{id}	修改（仅发送需变更的项）
DELETE	/api/skills/{id}	删除

注册请求体：

{
  "name": "설비 일일점검 리포트",
  "description": "라인별 가동률과 알람 건수를 표로 정리한다",
  "content": "..."
}

description 很重要。智能体依据该说明判断当前作业是否适用此技能——写清楚何时使用比写它做什么更容易被匹配到。

从作业中提取技能

POST /api/session/{sessionId}/extract-skill

将刚结束的会话中所做的工作整理成技能。当希望复用一次做得不错的作业时，比起一开始就使用技能，先完成再提取的顺序在实际中更为方便。

导出与导入

方法	路径	作用
GET	/api/skills/export	将全部内容下载为技能包
POST	/api/skills/import	导入技能包（请求体中为 skills 数组）

当按现场分别运行 Studio 时，可用于把总部整理好的技能集合迁移到各现场。即使在隔离网络中，只需导入文件即可。