スキル

スキルとは、現場で繰り返される作業手順をエージェントに記憶させるために整理したものです。一度作成しておけば、以降のセッションで同じ内容を再度説明する必要がなくなります。

一覧と登録

メソッド	パス	機能
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 を個別に運用する場合、本社で整理したスキル一式を各現場へ移すために使用します。閉域網でもファイルを取り込むだけで済みます。