店舗資料とSkill
接客が読む店舗資料を編集し、画像やZIPを含めて下書きへ保存します。
このページの内容
店舗資料とPluginの違い
店舗資料のSkillは、料理の食べ方や店舗の案内など、接客が必要なときに読む知識です。Agent Pluginに同梱される店舗設定用skillとは別です。店舗資料へスクリプトやtool名を書いても実行権限は増えません。接客が参照するのは公開した版です。
管理画面で編集する
接客設定の資料ツリーからファイルを選び、プレビュー・原文・グラフィカル編集を切り替えます。見出し、リスト、コード、表、画像、リンクを編集できます。SKILL.mdの名前・説明などのメタデータは本文と分けて編集します。
保存前に画像とコードブロックを含む内容を確認します。ファイルを改名したら、そのファイルへのリンクも修正してください。画像には出所と代替テキストを付け、生成画像を写真として扱いません。画像は公開配信されるため、秘密情報や会員の個人情報を載せないでください。
資料をまとめる
各SkillにSKILL.mdを置き、先頭のYAMLへフォルダーと同じ名前と説明を記載します。入口は短くし、詳しい説明は相対リンクで参照するファイルへ分けられます。
local-sake/
SKILL.md
references/serving.md
assets/bottle.webp---
name: local-sake
description: 店舗の地酒の飲み方と提供温度を案内するときに読む。
---
確認済みの提供方法は[提供案内](references/serving.md)を参照する。資料は最大8 Skill、各30ファイル、1ファイル32,000文字、全体256,000文字です。文字数はUTF-16単位で数えます。原材料や価格は確認した情報だけを使い、顧客の記憶や認証情報を店舗資料へ転記しません。
ZIPで持ち運ぶ
5MiBまでのZIPを取り込めます。1つのSkillならルートにSKILL.md、複数なら上のようなSkill別フォルダーを置きます。同じIDの資料を置き換える場合だけ置換を選びます。画像の出所を確認できない場合は補ってください。TableCastの書出ZIPには画像の出所と代替テキストも含まれます。
管理画面で取り込んだ後は下書き保存が必要です。Skill検査で必須ファイル、名前・説明、参照切れを確認し、エラーを直してから公開前の検証へ進みます。検査の成功は資料の内容が事実であることを保証しません。
agentに任せる
この料理説明と写真を店舗資料へ整理して。既存の資料を保ち、長い説明は参照ファイルへ分けて。画像の出所、参照切れ、保存した下書きを確認して。公開はまだしないで。
agentはlist_store_skillsで一覧を読み、read_store_skill_fileで必要な本文を取得します。編集はedit_store_skill、ZIPはimport_store_skills・export_store_skills、検査はlint_store_skillsを使います。各変更の返却版を次のexpectedVersionへ渡します。書出結果のリンクを受け取るだけではZIPの取得完了になりません。クライアントが取得できない場合は管理画面の書出を使います。