> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# プレイブックの登録

> ファイルアップロードまたはインライン作成でプレイブックを登録する手順

プレイブックは、AI エージェントが問い合わせへ対応するときに使用する手順書です。登録されたプレイブックをもとに、AI エージェントは問い合わせを定められた手順へ導きます。

プレイブックの登録方法は **ファイルアップロード** と **インライン作成** の2種類があります。

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

複数のプレイブックをまとめて登録する場合はファイルアップロードを使います。

> [!WARNING]
>
> アップロードできるファイル形式は **Markdown（.md）** だけです。1ファイルあたり最大 **5MB**、1回の操作で最大 **50ファイル** までアップロードできます。各ファイルの先頭には `procedure_id`・`name`・`description`・`category`・`subcategory` を指定したYAMLフロントマターが必要です。形式は、アップロード画面の **テンプレートをダウンロード** で取得できるテンプレートで確認できます。

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

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

**2. ファイルを選択する**

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

**3. 内容を確認して確定する**

アップロード後、各プレイブックのフロントマターと本文が解析され、エラーがあればファイルごとに表示されます。内容を確認して、**3ファイルをアップロード** のように登録するファイル数が表示されたボタンをクリックします。

> [!TIP]
>
> `procedure_id` が重複しているファイルは、最初に読み込まれた1件のみが登録されます。登録前にファイルの内容をあらかじめ確認しておくことをお勧めします。

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

WebUI のテキストエディタを使って、直接プレイブックを作成します。

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

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

**2. 新規作成を開始する**

**手順を追加** ボタンをクリックして、新規作成モードを開きます。

**3. プレイブックを記述する**

テキストエディタにプレイブックの内容を入力します。プレイブックのステップ記法については [プレイブックステップの書き方](https://support.i.moneyforward.com/ai-helpdesk/playbooks/creating.md#playbook-step-notation) を参照してください。

![プレイブック追加フォームのスクリーンショット](https://mintcdn.com/moneyforwardi/heTTAJxL3AZAb52f/images/ai-helpdesk/playbooks/creating/add-modal.png?fit=max\&auto=format\&n=heTTAJxL3AZAb52f\&q=85\&s=3fbd87553c45909faa244491664e3fed)

**4. 保存する**

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

![プレイブック一覧のスクリーンショット](https://mintcdn.com/moneyforwardi/heTTAJxL3AZAb52f/images/ai-helpdesk/playbooks/creating/list.png?fit=max\&auto=format\&n=heTTAJxL3AZAb52f\&q=85\&s=1563dc9c855e0454fafd913a893d7c32)

## プレイブックの仕様

### 汎用プレイブック

Triage Agent がどのプレイブックにもマッチしないと判断した問い合わせは、`procedures/general.md` という汎用プレイブックにフォールバックします。汎用プレイブックは他のプレイブックと同様に一覧に表示され、編集できます。削除はできません。

> [!NOTE]
>
> フォールバック時の対応品質を高めるために、汎用プレイブックの内容を組織の状況に合わせて適切に設定してください。

### 更新の反映タイミング

プレイブックを登録・更新した内容は、**次回のトリアージ以降** に反映されます。すでに進行中のセッションには影響しません。

## プレイブックステップの書き方

プレイブックのステップには、AI エージェントが実行すべき操作を自然言語で記述します。ステップ内に `{{ツール名}}` を記述することで、AI エージェントが使用するツールを明示的に指定できます。

### ツール参照の書き方

ツールを呼び出すには `{{ツール名}}` 形式をステップ本文に埋め込みます。

```markdown theme={null}
### Step 1: ユーザー情報を取得する

{{admina_get_user}} でユーザーのアカウント情報を確認する。
メールアドレスが見つからない場合は、ユーザーに確認を求める。
```

> [!TIP]
>
> テキストエディタで `{{` と入力するとツール名の補完メニューが表示されます（`/` でも全コマンドの補完メニューが開きます）。手入力の代わりに補完から選択できます。

### 利用可能なツール一覧

**ナレッジ・ドキュメント検索**

| ツール名 | 機能 |
| - | - |
| `{{document_search}}` | ナレッジベースを検索し、ヒットしない場合は自動でWeb検索にフォールバックする（推奨） |
| `{{web_search}}` | Web を直接検索して最新情報を取得する |
| `{{read_markdown_file}}` | 特定のドキュメントファイルを読み込む |

**Admina データ参照（MCP）**

| ツール名 | 機能 |
| - | - |
| `{{mcp__admina__get_people_accounts}}` | ユーザーの所属・在籍状況・SaaSアカウント情報を取得する |
| `{{mcp__admina__get_devices}}` | ユーザーのデバイス情報を取得する |
| `{{mcp__admina__get_identities}}` | ユーザーのID・MFA登録状況を取得する |
| `{{mcp__admina__get_services}}` | 利用可能なサービス連携の一覧を取得する |
| `{{mcp__admina__get_service_accounts}}` | 特定サービスのアカウント一覧を取得する |

> [!NOTE]
>
> Admina MCP ツールを使用するには、**設定 > 連携** で Admina MCP 連携が有効になっている必要があります。ツール名は `{{mcp__admina__ツール名}}` の形式です。利用可能な Admina ツールの一覧は管理者に確認してください。

**コアツール**

| ツール名 | 機能 |
| - | - |
| `{{check_session_status}}` | セッションの現在の状態・担当者を確認する（`{{escalation}}` の前に必ず呼び出す） |
| `{{escalation}}` | 担当者またはチームへエスカレーションする |
| `{{escalation_contact}}` | 特定の連絡先をチップとして本文に表示する（下記参照） |
| `{{playbook_ref:ファイル名}}` | AI エージェントに実行させる別のプレイブックを指定する（下記参照） |
| `{{suggest_session_complete}}` | 問題が解決したとユーザーに確認し、セッション完了を促す |
| `{{start_workflow}}` | 名前付きワークフロー（例: `password-reset`）の追跡を開始する |
| `{{update_conversation_data}}` | 会話中に収集した情報（ソフトウェア名・申請理由など）を保存する |

> [!NOTE]
>
> `{{investigation}}` と `{{resolution_planning}}` はプロンプトモデルの改修に伴い廃止されました。同等の判断は AI エージェントのコア指示に統合されているため、プレイブック側で明示的に呼び出す必要はありません。

### 連絡先チップの書き方（`{{escalation_contact}}`）

`{{escalation_contact}}` は `{{escalation}}` とは別のツールです。AI が実行するアクションではなく、**本文中に連絡先を分かりやすく表示するための記法**です。属性を指定すると、特定の連絡先をアイコン付きのチップとして表示できます。

| 記法 | 表示されるアイコン |
| - | - |
| `{{escalation_contact}}` | 汎用アイコン（連絡先は自動で置き換わらない） |
| `{{escalation_contact name="表示名"}}` | 人物アイコン |
| `{{escalation_contact slack_name="表示名"}}` | Slack アイコン |
| `{{escalation_contact teams_username="表示名"}}` | Microsoft Teams アイコン |
| `{{escalation_contact line_id="表示名"}}` | LINE WORKS アイコン |
| `{{escalation_contact email="メールアドレス"}}` | メールアイコン |

```markdown theme={null}
不明点があれば {{escalation_contact name="山田太郎"}} まで確認してください。
```

> [!WARNING]
>
> 属性なしの `{{escalation_contact}}` は、実際の連絡先に自動で置き換わりません。属性で連絡先を指定するか、実際の連絡先（Slack のチャンネル名など）に書き換えてください。

### プレイブック参照の書き方（`{{playbook_ref}}`）

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

次の例は、`printer-troubleshoot.md` というファイル名で登録したプレイブックを実行させる場合の書き方です。ファイル名は、実際に登録しているプレイブックに合わせて書き換えてください。

```markdown theme={null}
プリンターに接続できない場合は {{playbook_ref:printer-troubleshoot}} を実行する。
```

### 記述例

```markdown theme={null}
## パスワードリセット手順

### Step 1: ユーザー情報を確認する

{{mcp__admina__get_people_accounts}} でアカウントの在籍状況を確認する。
アカウントがロックされている場合は Step 2 へ、存在しない場合はエスカレーションする。

### Step 2: 社内ドキュメントを検索する

{{document_search}} でパスワードリセット手順を検索する。
見つかった手順をユーザーにわかりやすく案内する。

### Step 3: 解決確認

手順に従って解決したか確認する。
解決した場合は {{suggest_session_complete}} でセッションを完了する。
解決しない場合は {{check_session_status}} で状態を確認し、未エスカレーションであれば {{escalation}} で IT 担当者にエスカレーションする。
```

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

## 関連ページ

* [プレイブックの編集・削除](https://support.i.moneyforward.com/ai-helpdesk/playbooks/editing.md)
* [ハンドブックの管理](https://support.i.moneyforward.com/ai-helpdesk/knowledge/handbook.md)
* [ナレッジの追加](https://support.i.moneyforward.com/ai-helpdesk/knowledge/adding.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.