> ## 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.

# ハンドブックを管理する

> ステップ形式の手順マニュアル（ハンドブック）を登録・編集・削除する方法

ハンドブックは、ステップ形式で記述する手順マニュアルです。各ステップにタイトルと Markdown 形式の本文を設定でき、AI エージェントがチケット対応時に参照する構造化されたナレッジとして活用できます。

<Note>
  ハンドブックは **ナレッジ > ハンドブック** から管理します。プレイブック（AI の行動手順）やナレッジベース（ドキュメント記事）とは別のセクションです。
</Note>

## プレイブックとの違い

| 項目      | AIプレイブック          | ハンドブック          |
| ------- | ----------------- | --------------- |
| AIによる実行 | あり（構造化された対話）      | なし              |
| AIによる参照 | あり（対応指示として）       | あり（ナレッジとして参照のみ） |
| 用途      | AI エージェントの対話フロー定義 | 人間が実行する作業手順     |
| 管理画面の場所 | ナレッジ > AIプレイブック   | ナレッジ > ハンドブック   |

AI エージェントはハンドブックの内容をナレッジとして参照できます。例えば「〇〇の手順を教えて」という問い合わせに対して、ハンドブックに記載された手順をもとに回答できます。ただし、AI エージェントがハンドブックの手順をプレイブックとして自動実行することはありません。

## ハンドブックを作成する

<Steps>
  <Step title="ハンドブック管理画面を開く">
    左のナビゲーションから **ナレッジ** を展開し、**ハンドブック** を選択します。
  </Step>

  <Step title="新規作成を開始する">
    画面右上の **ハンドブックを追加** ボタンをクリックします。
  </Step>

  <Step title="基本情報を入力する">
    以下の項目を入力します。

    | 項目        | 説明                                         |
    | --------- | ------------------------------------------ |
    | **タイトル**  | ハンドブックの名前（必須）                              |
    | **説明**    | ハンドブックの用途・概要（任意）                           |
    | **カテゴリー** | アカウント / 請求 / 技術 / オンボーディング / 人事 / その他 から選択 |
    | **タグ**    | 検索・分類用のタグ（カンマ区切りで複数設定可）                    |
  </Step>

  <Step title="ステップを追加する">
    **ステップを追加** ボタンをクリックし、各ステップに **ステップタイトル** と **ステップの説明**（Markdown 形式）を入力します。

    * ステップは複数追加できます
    * ドラッグ操作でステップの順序を変更できます
    * 不要なステップは削除できます
  </Step>

  <Step title="保存する">
    **保存** ボタンをクリックして確定します。
  </Step>
</Steps>

## ファイルから一括アップロードする

複数のハンドブックをまとめて登録する場合は、一括アップロードを使います。

<Warning>
  アップロードできるファイル形式は **.md（Markdown）** と **.txt（テキスト）** のみです。各ファイルが 1 件のハンドブックになります。1ファイルあたり最大 **200KB**、1回の操作で最大 **30ファイル** までアップロードできます。
</Warning>

<Steps>
  <Step title="ハンドブック管理画面を開く">
    **ナレッジ > ハンドブック** を開きます。
  </Step>

  <Step title="一括アップロードを開始する">
    **一括アップロード** ボタンをクリックし、.md または .txt ファイルを選択します。複数ファイルを同時に選択できます。
  </Step>

  <Step title="内容を確認して確定する">
    アップロード後、各ハンドブックのプレビューが表示されます。内容を確認して **アップロード** をクリックします。
  </Step>
</Steps>

## ハンドブックを編集する

<Steps>
  <Step title="ハンドブック管理画面を開く">
    **ナレッジ > ハンドブック** を開きます。
  </Step>

  <Step title="対象のハンドブックを開く">
    編集したいハンドブックの行をクリックするか、行末の **…（アクションメニュー）** から **ハンドブックを編集** を選択します。
  </Step>

  <Step title="内容を修正して保存する">
    タイトル・説明・カテゴリー・タグ・ステップを編集し、**保存** をクリックします。
  </Step>
</Steps>

## ハンドブックを削除する

### 1 件削除

ハンドブックの行末にある **…（アクションメニュー）** から **ハンドブックを削除** を選択し、確認ダイアログで **削除** をクリックします。

### 一括削除

1. 各行のチェックボックスにチェックを入れます（ヘッダーのチェックボックスで全選択可）
2. 表示される **削除** ボタンをクリックします
3. 確認ダイアログで **削除** をクリックして確定します

<Warning>
  削除したハンドブックは復元できません。
</Warning>

## 表示モードとフィルター

ハンドブック一覧は **タイル表示** と **リスト表示** を切り替えられます。絞り込みには **カテゴリー** フィルターとキーワード検索が使用できます。

また、**グループ化** メニューから、カテゴリー・タグ・作成者・ステップ数・更新日のいずれかで一覧をグループ表示できます。

## AI エージェントでの活用

ハンドブックは AI エージェントのナレッジ検索の対象に含まれます。プレイブックのステップで明示的に参照する場合は `{{document_search}}` ツールを使用してください。

## 関連ページ

* [ナレッジを追加する](/ai-helpdesk/knowledge/adding) — ドキュメント記事形式のナレッジ管理
* [AI改善提案のレビューと適用](/ai-helpdesk/knowledge/improvements)
* [プレイブックを登録する](/ai-helpdesk/playbooks/creating)
