> ## 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が生成するプレイブック改善提案の確認・編集・適用手順

AI エージェントはセッションが完了するたびに、会話の内容を分析してプレイブックの改善提案を自動生成します。オペレーターはこの提案をレビューし、適用・破棄・再生成を選択することで、サポートの品質を継続的に向上させることができます。

<Info>
  改善提案は自動で生成されますが、**プレイブックへの反映は必ずオペレーターが明示的に操作して行います**。提案が自動でプレイブックに適用されることはありません。
</Info>

## 提案の生成仕組み

セッションがクローズされると、AI エージェントがバックグラウンドで会話履歴を分析します。分析の結果、既存プレイブックの改善点や新しいプレイブックの必要性が検出された場合、改善提案が生成されます。

| 提案の種類     | 内容                         |
| --------- | -------------------------- |
| プレイブックの修正 | 既存プレイブックに対する変更の提案          |
| 新規プレイブック  | まだカバーされていないパターンに対する新規作成の提案 |

<Info>
  既存のプレイブックが問い合わせのパターンを十分にカバーしていると判断された場合、提案は生成されません。提案がないことはエラーではなく、正常な動作です。
</Info>

## 提案を確認する

改善提案は「改善提案」という独立した画面には集約されていません。次のいずれかの画面から確認します。

<Steps>
  <Step title="AIプレイブックの詳細画面から確認する">
    **ナレッジ > AI プレイブック** から対象のプレイブックを開き、**提案** タブを選択します。保留中の提案がある場合、タブに件数バッジが表示されます。
  </Step>

  <Step title="チケット（セッション）の詳細画面から確認する">
    特定のセッションから生成された提案を確認する場合は、そのチケットを開き、**提案** タブを選択します。
  </Step>

  <Step title="提案の一覧・詳細を確認する">
    各画面の **提案** タブには、保留中の提案がカード形式で一覧表示されます。各提案には以下の情報が表示されます。

    | フィールド    | 説明                            |
    | -------- | ----------------------------- |
    | 提案の種類    | プロシージャを更新 または 新規プロシージャ        |
    | 提案理由・背景  | なぜこの変更が提案されたか                 |
    | 優先度      | 高 / 中 / 低                     |
    | 品質チェック結果 | 合格 / 要修正 / 却下（AIによる自動チェックの結果） |

    提案をクリックすると、現在のプレイブック内容と提案された変更のdiff（差分）が表示されます。変更内容と提案理由を確認した上で、次の操作を選択してください。
  </Step>
</Steps>

## 提案を適用する（そのまま適用）

提案の内容が適切と判断した場合は、そのままプレイブックに適用できます。

<Steps>
  <Step title="提案を選択して差分を確認する">
    提案一覧から対象の提案をクリックし、diff と提案理由を確認します。
  </Step>

  <Step title="適用する">
    **適用** ボタンをクリックします。
  </Step>
</Steps>

適用すると、次の内容が変更されます。

* プレイブックの内容が提案の内容に更新されます
* 更新されたプレイブックは即座に有効化されます
* 提案は一覧から削除されます

## 提案を編集して適用する

提案の方向性は正しいが、内容を調整してから適用したい場合は、編集してから適用できます。

<Steps>
  <Step title="提案を選択する">
    提案一覧から対象の提案をクリックします。
  </Step>

  <Step title="編集モードを開く">
    diff表示から編集モードに切り替えます。提案されたドラフト内容を編集できるエディタが表示されます。
  </Step>

  <Step title="内容を調整する">
    エディタで提案内容を自由に修正します。
  </Step>

  <Step title="適用する">
    編集が完了したら **適用** をクリックします。
  </Step>
</Steps>

<Info>
  編集画面を閉じても適用しなかった場合、編集内容は破棄されます。提案は一覧に残ったままになります。
</Info>

## 提案を破棄する

提案の内容が誤っている場合や現在の運用に合わない場合は、破棄できます。

1. 提案一覧から対象の提案をクリックします
2. **破棄** ボタンをクリックします

破棄すると提案は一覧から削除されます。プレイブックは変更されません。提案の方向性を修正してほしい場合は、破棄する前に **再生成** を使用してください（破棄後は同じ提案に対して再生成できません）。

## 提案を再生成する（フィードバックを添えて）

提案の方向性が合わない場合、フィードバックを添えて新しい提案を生成できます。

<Steps>
  <Step title="提案を選択する">
    提案一覧から対象の提案をクリックします。
  </Step>

  <Step title="再生成を選択する">
    **再生成** ボタンをクリックします。
  </Step>

  <Step title="フィードバックプロンプトを入力する（任意）">
    今回の再生成だけに適用されるフィードバックをテキストで入力できます（任意）。このプロンプトは再生成後には保存されません。

    フィードバックプロンプトの例：

    * 「VPNのプレイブックではなく、パスワードリセットのプレイブックを参考にしてほしい」
    * 「ステップにVIP対応のエスカレーション確認を追加してほしい」
  </Step>

  <Step title="再生成を確定する">
    **再生成** をクリックします。現在の提案は一覧から削除され、新しい提案がバックグラウンドで生成されます。
  </Step>
</Steps>

## チャットコマンドでセッションにフィードバックを残す

管理画面上の提案レビューとは別に、対応が完了したセッションに対して、Slack・Teamsなどのチャット上から `/feedback` コマンドで直接フィードバックを残すこともできます。セッションに残せるフィードバックは **1件のみ** です。一度投稿すると、同じセッションには再投稿できません。投稿済みのフィードバックは管理画面のセッション詳細で確認できます。

フィードバックの例：

* 「このタイプの問い合わせでは、VPNセットアップのプレイブックを参照すべきだった」
* 「対応者が途中でエスカレーションが必要だったことに気づいていない」
* 「このセッションの解決ステップを標準プレイブックにすべき」

<Info>
  チャットコマンドでフィードバックを投稿すると、その内容を踏まえた改善提案の生成が **自動的に** トリガーされます。生成されたプレイブックをそのまま適用するかどうかは、引き続きオペレーターの明示的な操作が必要です。
</Info>

## 関連ページ

* [ナレッジを追加する](/ai-helpdesk/knowledge/adding)
* [プレイブックを登録する](/ai-helpdesk/playbooks/creating)
* [プレイブックを編集・削除する](/ai-helpdesk/playbooks/editing)