対話ビューア
会話の全内容と詳細情報を確認する
機能概要
会話ビューアは、MaiAgent の管理画面に用意された会話確認ページです。管理者やカスタマーサポート担当者が、会話の全記録をより見やすく、詳細に確認できます。会話ビューアのページでは、メッセージ内容、タイムライン、ツールの使用記録などの情報を含め、単一の会話のあらゆる詳細に集中して目を通すことができます。
会話ビューアを開く
受信トレイから開く
会話一覧を開く
左側メニューの「カスタマーサポート会話」をクリックします
「すべての会話」をクリックします
確認したい会話を選ぶ
会話一覧から対象の会話を探します
会話をクリックすると、会話ビューアのページに移動します
画面説明
主要なエリア
会話情報パネル
会話の基本情報を表示します - ユーザー名 - 会話プラットフォーム（LINE / Facebook / Web Chat） - 開始時刻 - 会話ステータス
メッセージタイムライン
時系列で会話の全記録を表示します - ユーザーメッセージ - AI の返信 - システムメッセージ - タイムスタンプ
会話の詳細情報
高度な情報を表示します - 使用された AI アシスタント - 呼び出されたツールの記録 - ナレッジベースの検索結果 - Token 使用量
メッセージの表示
ユーザーメッセージ：左側に表示され、淡い色の背景を使用します
AI の返信：右側に表示され、ブランドカラーの背景を使用します
システムメッセージ：中央に表示され、グレーの文字を使用します
タイムスタンプ：各メッセージの下に送信時刻が表示されます
高度な機能
ツールの使用記録
会話ビューアは、AI アシスタントが会話中に使用したツールを分かりやすく表示します。
ナレッジベース引用の追跡
AI の返信がナレッジベースの内容を引用している場合、引用元が表示されます。
Token 使用量の統計
その会話の Token 消費量を表示します。
ユーザー入力: 120 Tokens
AI の返信: 350 Tokens
ツール呼び出し: 80 Tokens
合計: 550 Tokens
活用シーン
シーン 1：品質モニタリング
ニーズ：管理者が毎日会話品質を抜き取り検査し、AI の返信が基準を満たしているか確認したい
操作の流れ：
毎日、受信トレイからランダムに 10 件の会話を選びます
会話ビューアを使って 1 件ずつ確認します
チェックのポイント：
AI の返信が正確か
口調が適切か
ツールを正しく使用しているか
ナレッジベースの引用が関連しているか
改善が必要な会話にマークを付けます
AI トレーニングチームにフィードバックを提供します
シーン 2：カスタマーサポートのトレーニング
ニーズ：実際の会話事例を使って新人のカスタマーサポート担当者をトレーニングしたい
操作の流れ：
優れた会話例（適切に処理された複雑な問題）を絞り込みます
会話ビューアを使って一つずつ解説します
重点的に説明する内容：
顧客のニーズをどう理解するか
ツールをどう効果的に使うか
会話の流れをどう導くか
会話をどう適切に締めくくるか
新人に同様のシーンを模擬演習させます
シーン 3：問題診断
ニーズ：ユーザーから AI の返信が正しくないと報告があり、原因を突き止めたい
操作の流れ：
検索機能を使ってその会話を見つけます
会話ビューアを使って詳細に確認します
問題点を分析します：
ユーザーの質問が正しく理解されているか確認します
AI がどのツールを呼び出したかを確認します
ナレッジベースの検索結果が関連しているか確認します
AI の推論プロセスを確認します
問題の根本原因を特定します（ナレッジベースの不足 / ツール設定の誤り / Prompt の最適化が必要）
それに応じた調整を行います
会話の Q&A 記録を取得する
MaiAgent では、利用シーンに応じて 2 つの取得方法を提供しています。
AI の Q&A 記録を一括分析する
「AgentOps > AI アシスタントモニタリング」で絞り込んでからエクスポートします
Excel
社内システムから AI の Q&A 記録を定期的に同期する
Q&A 記録 API を使用し、ページネーションと保存を独自に処理します
JSON
一括エクスポート
左側メニューの「AgentOps > AI アシスタントモニタリング」を開きます
AI アシスタント、日付、キーワードなどの絞り込み条件を選択します
右上の「エクスポート」をクリックしてエクスポートリクエストを作成します
エクスポートリクエストページに移動し、作成された Excel ファイルをダウンロードします
API で取得する
定期的な同期や JSON 形式のカスタマイズが必要な場合は、組織の API Key を使用して GET /api/v1/records/ を呼び出します。AI の Q&A 記録をページごとに取得し、AI アシスタント、日付、キーワードで絞り込みます。
Authorization: Api-Key <API Key> で認証し、次のページがなくなるまでレスポンスのページネーション情報に従って取得を続けてください。すべてのパラメータとレスポンスフィールドについては、MaiAgent API ドキュメントを参照してください。
添付ファイルの取り扱い
一括 Excel と Q&A 記録 API には、ユーザーがアップロードした添付ファイルの原本は含まれません。
現在、顧客が会話の添付ファイルを一括ダウンロードできる公開 API はありません。添付ファイルの保存が必要な場合は、適切なデータ提供方法について MaiAgent チームにお問い合わせください。
プライバシーに関する注意
エクスポートした会話記録には、ユーザーの個人情報が含まれる場合があります。適切に保管し、プライバシーポリシーおよび関連法規を遵守してください。
よくある質問
Q：会話ビューアと通常の会話画面はどう違いますか？
A：会話ビューアは、ツールの使用記録、ナレッジベース引用の追跡、Token 使用量の統計といった高度な情報を含む、より充実した情報を提供し、分析・モニタリング・トレーニングに適しています。一方、通常の会話画面は日常的な返信操作に適しています。
Q：会話ビューアから直接返信できますか？
A：できません。会話ビューアは読み取り専用の画面であり、主に確認と分析に使用します。会話に返信する場合は、会話一覧に戻って操作してください。
Q：会話ビューアには削除済みのメッセージが表示されますか？
A：表示されません。会話ビューアは現在存在するメッセージ記録のみを表示します。削除済みのメッセージを復元して表示することはできません。
Q：会話ビューアの読み込みが遅い場合はどうすればよいですか？
A：考えられる原因と対処方法：
会話が長すぎる：100 件を超えるメッセージのある会話は読み込みに時間がかかります。少々お待ちください
ネットワークの問題：ネットワーク接続の状態を確認してください
大きな添付ファイルを含む：画像やファイルが多すぎると読み込み速度に影響します
関連機能
最終更新
役に立ちましたか？