Skip to main content
プレイブックは、AI エージェントが問い合わせへ対応するときに使用する手順書です。登録されたプレイブックをもとに、AI エージェントは問い合わせを定められた手順へ導きます。 プレイブックの登録方法は ファイルアップロード と インライン作成 の2種類があります。

ファイルアップロードで登録する

複数のプレイブックをまとめて登録する場合はファイルアップロードを使います。
アップロードできるファイル形式は Markdown(.md)・プレーンテキスト(.txt)・CSV(.csv)・Word(.docx)・PDF(.pdf) です。1ファイルあたり最大 5MB、1回の操作で最大 50ファイル までアップロードできます。各ファイルの先頭には procedure_id・name・description・category・subcategory を指定したYAMLフロントマターが必要です。
1

AIプレイブック管理画面を開く

AIヘルプデスクの管理画面から AI プレイブック を選択します。
2

ファイルを選択する

手順をアップロード ボタンをクリックし、登録したいファイルを選択します。複数のファイルを一度に選択できます。
3

内容を確認して確定する

アップロード後、各プレイブックのフロントマターと本文が解析され、エラーがあればファイルごとに表示されます。内容を確認して アップロード をクリックします。
procedure_id が重複しているファイルは、最初に読み込まれた1件のみが登録されます。登録前にファイルの内容をあらかじめ確認しておくことをお勧めします。

インライン作成で登録する

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 が実行するアクションではなく、本文中に連絡先を分かりやすく表示するための記法です。属性を指定すると、特定の連絡先をアイコン付きのチップとして表示できます。
属性なしの {{escalation_contact}} は、実際の連絡先に自動で置き換わりません。属性で連絡先を指定するか、実際の連絡先(Slack のチャンネル名など)に書き換えてください。

プレイブック参照の書き方({{playbook_ref}})

{{playbook_ref:ファイル名}} は、AI エージェントに実行させる別のプレイブックを指定する記法です。テキストエディタで / または {{ と入力して プレイブック参照 を選ぶと、登録済みのプレイブックの一覧が表示されます。プレイブックを選ぶと、ファイル名から .md を除いた名前で挿入されます。手入力する場合も、フロントマターの name ではなく、.md を除いたファイル名を指定してください。 次の例は、printer-troubleshoot.md というファイル名で登録したプレイブックを実行させる場合の書き方です。ファイル名は、実際に登録しているプレイブックに合わせて書き換えてください。

記述例

ツール参照は省略可能です。省略した場合も AI エージェントが文脈から適切なツールを選択しますが、{{ツール名}} を明記するとツール選択が安定し、期待どおりの動作になりやすくなります。

関連ページ

最終更新日 2026年10月8日