AIエージェントの会話設計 — 自然な対話フローの構築

AIエージェントの品質は、コード生成能力だけでなく「どう話すか」で決まる。ペルソナ設計、会話フロー、トーン管理の3層で一貫した対話体験を構築する方法を解説する。

ペルソナ設計テンプレート

ペルソナとは、AIの人格・口調・振る舞いの定義書である。CLAUDE.mdに以下の構造で記述する。

## ペルソナ定義
- **名前**: 秘書室AI
- **役割**: プロジェクト管理と報告の窓口
- **口調**: 丁寧語。断定形を使い、曖昧表現を避ける
- **禁止表現**: 「〜かもしれません」「検討します」「様子を見ます」
- **応答長**: 要点のみ。3文以内で結論を先に出す
- **判断基準**: 不明点は合理的デフォルトで即決。質問で止めない

ペルソナの良し悪しは「禁止表現リスト」の具体性で決まる。曖昧な指示は曖昧な応答を生む。

会話フローの設計パターン

対話には3つの基本フローがある。

1. 報告フロー（Agent → User）

結論 → 根拠 → 次のアクション

悪い例: 「調査しました。いくつかの問題が見つかりました。詳細は以下です…」良い例: 「3件のバグを修正しました。原因はAPI応答のnullチェック漏れです。テスト追加済み。」

2. 確認フロー（Agent → User → Agent）

選択肢提示 → ユーザー選択 → 即実行

確認は選択肢を2-3個に絞る。「どうしますか？」は禁止。必ず選択肢を提示する。

3. 自律実行フロー（Agent内部）

判断 → 実行 → 結果報告

自律モードでは確認フローを挟まない。判断根拠を事後報告に含める。

トーン管理の実装

トーンはコンテキストで切り替える。CLAUDE.mdに条件分岐で定義する。

## トーン管理ルール
- **通常作業**: 簡潔・断定・結論先行
- **エラー報告**: 影響範囲を最初に明示。感情表現なし
- **成果報告**: 数値で示す。「うまくいきました」ではなく「応答時間が40%短縮」
- **承認依頼**: リスクレベルと選択肢を構造化して提示

トーン一貫性のチェックリスト

チェック項目	OK例	NG例
結論が先頭にある	「完了。3ファイル修正」	「作業を進めていたのですが…」
数値で示している	「テスト12件全通過」	「テストは問題なさそうです」
次のアクションがある	「次はデプロイ実行」	「確認お願いします」
曖昧表現がない	「原因はnull参照」	「おそらくnull関連かも」

エラー時の会話設計

エラー発生時の応答テンプレートを定義しておくと、緊急時にも一貫性を保てる。

## エラー応答テンプレート
[ERROR_REPORT]
SEVERITY: LOW / MEDIUM / HIGH / CRITICAL
IMPACT: （影響範囲を1文で）
CAUSE: （原因を1文で）
ACTION_TAKEN: （実施済みの対処）
NEXT_ACTION: （次にやること）

ペルソナ設計のアンチパターン

過度な丁寧さ: 敬語の重複は情報密度を下げる
感情の模倣: 「嬉しいです」「残念です」は不要。事実と数値で伝える
確認の連発: 自律モードでは確認せず実行する。判断ログを残す
長文応答: 3文で済む内容を10文で書かない

会話設計はAIエージェントのUXそのものである。ペルソナ・フロー・トーンの3層を構造的に定義することで、誰が使っても同じ体験を得られるエージェントになる。