アノテーション（回答改善）機能
dify-docs-use-annotation-for-answer-improvement
機能の概要
アノテーションは、過去の会話ログや想定される質問に対して「模範回答」を事前に登録する機能です。ユーザーから類似した質問が行われた際、AI（LLM）による生成を行わず、登録された回答を優先的に返します。
主な効果
- 回答の安定化: 生成ごとのブレをなくし、常に同じ内容を返答します。
- 即時性・低コスト: LLMの推論を介さないため、応答速度が向上し、トークン消費を抑えられます。
- 確実な情報提供: 営業時間や規約など、事実に基づいた正確な情報を固定できます。
アノテーションのメリット
項目 | 詳細 |
品質の担保 | 担当者やタイミングによる回答の揺らぎを防ぎます。 |
誤回答の是正 | 誤った回答を発見した際、即座に正しい回答を登録して再発を防げます。 |
重要情報の固定 | 住所、連絡先、営業時間などの「間違えてはいけない情報」を正確に伝えます。 |
トーンの統一 | 企業ごとの丁寧語、口調、専門用語の表記ルールを統一できます。 |
設定・有効化
手順
- アプリケーション設定画面（「設定」タブ）を開きます。
- 「アノテーション」（または「Annotation Reply」）セクションを展開します。
- 機能を 「有効」 に切り替えます。
主要な設定項目
- 類似度閾値 (Score Threshold): ユーザーの質問とアノテーション登録済みの質問が「どの程度似ていれば回答を採用するか」の基準値です。閾値を高くすると適用が厳格になり、低くすると適用されやすくなります（誤適用のリスクも上がります）。
- 埋め込みモデル (Embedding Model): 質問文の類似度計算に使用するモデルを指定します。
アノテーションの登録方法
1. 会話ログからの登録（推奨）
実際のユーザーとの対話履歴から改善すべき回答を見つけて登録する方法です。
- 「ログ」 タブから対象の会話を開きます。
- 改善したいAIの回答にある 「アノテーション（編集）」 アイコンを選択します。
- 修正後の「正しい回答」を入力し、保存します。
2. 手動での新規登録
FAQや想定問答を事前に登録する方法です。
- 「アノテーション」 管理タブを開きます。
- 「追加」 ボタンを選択します。
- 「質問」と「回答」のペアを入力し、保存します。
効果的なアノテーション作成のコツ
良いアノテーションの例
- 質問: 「営業時間は？」
- 悪い回答:
10時から20時です- 良い回答:
当店の営業時間は平日10:00～20:00、土日祝日は10:00～18:00となっております。
年末年始（12/31～1/3）は休業となります。ベストプラクティス
- 網羅性を高める: 単なる回答だけでなく、前提条件や例外（休日、対象外プランなど）も含めて記述します。
- 表記ゆれの統一: 社名、サービス名、日付等の表記ルールを守ります。
- 質問バリエーション: 同じ意図の質問でも言い回しが異なる場合があるため、必要に応じて類似質問を追加登録します。
運用・管理フロー
定期レビュー（推奨サイクル）
- ログ確認: 週次で「低評価」や「ユーザーが離脱した」会話ログを確認します。
- 特定: 誤回答や不十分な回答を特定します。
- 登録: 正しい回答をアノテーションとして登録・修正します。
- 監視: その後、同様の質問に対して正しく応答できているかモニタリングします。
注意事項
- 情報の鮮度: 登録した情報は自動更新されないため、定期的な見直し（棚卸し）が必要です。
- 閾値の調整: 全く関係ない質問にアノテーションが反応してしまう場合は、類似度閾値を上げる調整を行ってください。
デジタルヒューマンでの活用ポイント
デジタルヒューマンなどの対話エージェントでは、キャラクター性を維持するために以下の項目を優先的にアノテーション登録することを推奨します。
- 挨拶・自己紹介: キャラクター設定に合った一貫した挨拶。
- 定型応答: 「分かりません」や「エラーが発生しました」等のシステム的な応答もキャラクターの口調に合わせる。
- 基本情報: 企業名やサービス概要などの必須知識。
お役に立ちましたか？
😞
😐
🤩
最終更新日 February 20, 2026