> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# プレイブックを登録する

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

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

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

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

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

<Warning>
  アップロードできるファイル形式は **Markdown（.md）・プレーンテキスト（.txt）・CSV（.csv）・Word（.docx）・PDF（.pdf）** です。1ファイルあたり最大 **5MB**、1回の操作で最大 **50ファイル** までアップロードできます。各ファイルの先頭には `procedure_id`・`name`・`description`・`category`・`subcategory` を指定したYAMLフロントマターが必要です。
</Warning>

<Steps>
  <Step title="AIプレイブック管理画面を開く">
    AI Helpdesk の管理画面から **AI プレイブック** を選択します。
  </Step>

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

  <Step title="内容を確認して確定する">
    アップロード後、各プレイブックのフロントマターと本文が解析され、エラーがあればファイルごとに表示されます。内容を確認して **アップロード** をクリックします。

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

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

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

<Steps>
  <Step title="AIプレイブック管理画面を開く">
    AI Helpdesk の管理画面から **AI プレイブック** を選択します。
  </Step>

  <Step title="新規作成を開始する">
    **手順を追加** ボタンをクリックして、新規作成モードを開きます。
  </Step>

  <Step title="プレイブックを記述する">
    テキストエディタにプレイブックの内容を入力します。プレイブックのステップ記法については [プレイブックステップの書き方](/ai-helpdesk/playbooks/creating#playbook-step-notation) を参照してください。

    <img src="https://mintcdn.com/admina-sbn/P0Z2ZjMpBdMu1zTW/images/ai-helpdesk/playbooks/creating/add-modal.png?fit=max&auto=format&n=P0Z2ZjMpBdMu1zTW&q=85&s=f9570b506a6546258bcfedd94221f167" alt="プレイブック追加フォームのスクリーンショット" width="2880" height="1800" data-path="images/ai-helpdesk/playbooks/creating/add-modal.png" />
  </Step>

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

<img src="https://mintcdn.com/admina-sbn/P0Z2ZjMpBdMu1zTW/images/ai-helpdesk/playbooks/creating/list.png?fit=max&auto=format&n=P0Z2ZjMpBdMu1zTW&q=85&s=0cd0dbbae9626db40ecba5d6408afae4" alt="プレイブック一覧のスクリーンショット" width="2880" height="1800" data-path="images/ai-helpdesk/playbooks/creating/list.png" />

## プレイブックの仕様

### 汎用プレイブック

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

<Info>
  フォールバック時の対応品質を高めるために、汎用プレイブックの内容を組織の状況に合わせて適切に設定してください。削除すると、どのプレイブックにもマッチしなかった問い合わせに対する案内が失われるため注意してください。
</Info>

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

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

<h2 id="playbook-step-notation">
  プレイブックステップの書き方
</h2>

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

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

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

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

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

<Tip>
  テキストエディタで `{{` と入力するとツール名の補完メニューが表示されます（`/` でも全コマンドの補完メニューが開きます）。手入力の代わりに補完から選択できます。
</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 ツールの一覧は管理者に確認してください。
</Note>

**コアツール**

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

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

### 連絡先チップの書き方（`{{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="山田太郎"}} まで確認してください。
```

### 記述例

```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 エージェントが文脈から適切なツールを選択しますが、`{{ツール名}}` を明記するとツール選択が安定し、期待どおりの動作になりやすくなります。
</Tip>

## 関連ページ

* [プレイブックを編集・削除する](/ai-helpdesk/playbooks/editing)
* [ハンドブックを管理する](/ai-helpdesk/knowledge/handbook)
* [ナレッジを追加する](/ai-helpdesk/knowledge/adding)