ファイルアップロードで登録する
複数のプレイブックをまとめて登録する場合はファイルアップロードを使います。1
AIプレイブック管理画面を開く
AIヘルプデスクの管理画面から AI プレイブック を選択します。
2
ファイルを選択する
手順をアップロード ボタンをクリックし、登録したいファイルを選択します。複数のファイルを一度に選択できます。
3
内容を確認して確定する
アップロード後、各プレイブックのフロントマターと本文が解析され、エラーがあればファイルごとに表示されます。内容を確認して アップロード をクリックします。
インライン作成で登録する
WebUI のテキストエディタを使って、直接プレイブックを作成します。1
AIプレイブック管理画面を開く
AIヘルプデスクの管理画面から AI プレイブック を選択します。
2
新規作成を開始する
手順を追加 ボタンをクリックして、新規作成モードを開きます。
3
プレイブックを記述する
テキストエディタにプレイブックの内容を入力します。プレイブックのステップ記法については プレイブックステップの書き方 を参照してください。

4
保存する
入力が完了したら 保存 をクリックします。登録されたプレイブックは次のトリアージから即座に有効になります。

プレイブックの仕様
汎用プレイブック
Triage Agent がどのプレイブックにもマッチしないと判断した問い合わせは、procedures/general.md という汎用プレイブックにフォールバックします。汎用プレイブックは他のプレイブックと同様に一覧に表示され、編集・削除ができます。
フォールバック時の対応品質を高めるために、汎用プレイブックの内容を組織の状況に合わせて適切に設定してください。削除すると、どのプレイブックにもマッチしなかった問い合わせに対する案内が失われるため注意してください。
更新の反映タイミング
プレイブックを登録・更新した内容は、次回のトリアージ以降 に反映されます。すでに進行中のセッションには影響しません。プレイブックステップの書き方
プレイブックのステップには、AI エージェントが実行すべき操作を自然言語で記述します。ステップ内に{{ツール名}} を記述することで、AI エージェントが使用するツールを明示的に指定できます。
ツール参照の書き方
ツールを呼び出すには{{ツール名}} 形式をステップ本文に埋め込みます。
利用可能なツール一覧
ナレッジ・ドキュメント検索
Admina データ参照(MCP)
Admina MCP ツールを使用するには、設定 > 連携 で Admina MCP 連携が有効になっている必要があります。ツール名は
{{mcp__admina__ツール名}} の形式です。利用可能な Admina ツールの一覧は管理者に確認してください。{{investigation}} と {{resolution_planning}} はプロンプトモデルの改修に伴い廃止されました。同等の判断は AI エージェントのコア指示に統合されているため、プレイブック側で明示的に呼び出す必要はありません。連絡先チップの書き方({{escalation_contact}})
{{escalation_contact}} は {{escalation}} とは別のツールです。AI が実行するアクションではなく、本文中に連絡先を分かりやすく表示するための記法です。属性を指定すると、特定の連絡先をアイコン付きのチップとして表示できます。
プレイブック参照の書き方({{playbook_ref}})
{{playbook_ref:ファイル名}} は、AI エージェントに実行させる別のプレイブックを指定する記法です。テキストエディタで / または {{ と入力して プレイブック参照 を選ぶと、登録済みのプレイブックの一覧が表示されます。プレイブックを選ぶと、ファイル名から .md を除いた名前で挿入されます。手入力する場合も、フロントマターの name ではなく、.md を除いたファイル名を指定してください。
次の例は、printer-troubleshoot.md というファイル名で登録したプレイブックを実行させる場合の書き方です。ファイル名は、実際に登録しているプレイブックに合わせて書き換えてください。

