Ctrlk
註冊/登入
For the complete documentation index, see llms.txt. This page is also available as Markdown.

会話ビューア

会話の全内容と詳細情報を確認できます

機能概要

会話ビューアーは、MaiAgent の管理画面で会話を確認するためのページです。管理者やカスタマーサポート担当者は、会話の全記録をより見やすく、詳しく確認できます。メッセージの内容、時系列、使用したツールの記録など、1 件の会話のあらゆる詳細に集中して確認できます。

会話ビューアーは品質監視、カスタマーサポートの研修、問題の追跡などに適しており、会話内容をより効果的に分析できます。

会話ビューアーを開く

受信トレイから開く

  1. 会話一覧を開く

    • 左側のメニューでカスタマーサポートの会話をクリックします。

    • すべての会話をクリックします。

  2. 確認する会話を選ぶ

    • 会話一覧で対象の会話を探します。

    • 会話をクリックすると、会話ビューアーが開きます。

画面の説明

主な領域

領域名
表示内容

会話情報パネル

会話の基本情報 - ユーザー名 - 会話のプラットフォーム（LINE / Facebook / Web Chat） - 開始時刻 - 会話のステータス

メッセージの時系列

会話の全記録を時系列で表示 - ユーザーのメッセージ - AI の返信 - システムメッセージ - タイムスタンプ

会話の詳細情報

詳細情報を表示 - 使用した AI アシスタント - ツールの呼び出し記録 - ナレッジベースの検索結果 - Token 使用量

メッセージの表示

  • ユーザーのメッセージ：左側に明るい背景色で表示されます。

  • AI の返信：右側にブランドカラーの背景で表示されます。

  • システムメッセージ：中央に灰色の文字で表示されます。

  • タイムスタンプ：各メッセージの下に送信時刻が表示されます。

高度な機能

ツールの使用記録

会話ビューアーには、AI アシスタントが会話中に使用したツールが明確に表示されます。

ナレッジベースの引用追跡

AI の返信でナレッジベースの内容を引用した場合は、引用元が表示されます。

Token 使用量の統計

会話で消費した Token が表示されます。

  • ユーザー入力: 120 Tokens

  • AI の返信: 350 Tokens

  • ツール呼び出し: 80 Tokens

  • 合計: 550 Tokens

Token の統計は、会話のコストを分析し、AI アシスタントの設定を最適化するのに役立ちます。

利用例

シナリオ 1：品質監視

目的：責任者が毎日会話の品質を抜き取り確認し、AI の返信が基準を満たしているか確かめます。

手順：

  1. 毎日、受信トレイから会話をランダムに 10 件選びます。

  2. 会話ビューアーで各会話を確認します。

  3. 次の点を確認します。

    • AI の返信は正確か。

    • 文体は適切か。

    • ツールを正しく使用したか。

    • ナレッジベースの引用は関連しているか。

  4. 改善が必要な会話に印を付けます。

  5. AI のトレーニングチームにフィードバックします。

シナリオ 2：カスタマーサポートの研修

目的：実際の会話を使って、新しいカスタマーサポート担当者を研修します。

手順：

  1. 複雑な問題を適切に処理した会話など、優れた事例を選びます。

  2. 会話ビューアーを使い、手順ごとに説明します。

  3. 次の点を重点的に説明します。

    • 顧客の要望を理解する方法。

    • ツールを効果的に使う方法。

    • 会話を適切に進める方法。

    • 会話を適切に終える方法。

  4. 新人に似た状況を想定して練習してもらいます。

シナリオ 3：問題の診断

目的：利用者から AI の返信が正しくないと報告されたとき、原因を調べます。

手順：

  1. 検索機能で対象の会話を見つけます。

  2. 会話ビューアーで詳しく確認します。

  3. 問題を分析します。

    • 利用者の質問が正しく理解されたか確認します。

    • AI が呼び出したツールを確認します。

    • ナレッジベースの検索結果が関連していたか確認します。

    • AI の推論過程を確認します。

  4. 根本原因を特定します（ナレッジベースの情報不足／ツール設定の誤り／Prompt の調整が必要など）。

  5. 必要な調整を行います。

会話の質問と回答の記録を取得する

MaiAgent では、用途に応じて 2 つの取得方法を利用できます。

用途
推奨方法
出力形式

AI の質問と回答の記録を一括で分析する

「AgentOps > AI アシスタントの監視」で絞り込んでエクスポートする

Excel

社内システムに AI の質問と回答の記録を定期的に同期する

質問と回答の記録 API を使用し、ページ分割と保存を自分で処理する

JSON

一括エクスポート

  1. 左側のメニューでAgentOps > AI アシスタントの監視を開きます。

  2. AI アシスタント、メンバー、日付、キーワードなどの条件で絞り込みます。

  3. 右上のエクスポートをクリックし、エクスポートリクエストを作成します。

  4. 左側のメニューでAgentOps > エクスポートリクエストを開きます。ステータスが完了になったら Excel ファイルをダウンロードします。一覧のユーザー列には、各エクスポートを作成した人が表示されます。

一括エクスポートされる Excel は、各「ユーザーの質問と AI の返信」を 1 単位とした記録で、品質分析に適しています。すべてのメッセージと添付ファイルの原本を含む完全なアーカイブではありません。

現在、エクスポートには対話形式の会話のみが含まれます。AI アシスタントの監視で取得元をスケジュール実行に絞り込むと、エクスポートボタンは無効になります。詳しくはメンバーと取得元で会話記録を絞り込むを参照してください。

API から取得する

定期的な同期や独自の JSON 形式が必要な場合は、組織の API Key を使って GET /api/v1/records/ を呼び出します。AI の質問と回答の記録をページごとに取得し、AI アシスタント、日付、キーワードで絞り込めます。

Authorization: Api-Key <API Key> で認証し、次のページがなくなるまでレスポンスのページ分割情報に従ってください。パラメータとレスポンスの項目については、MaiAgent API ドキュメントを参照してください。

添付ファイルの扱い

  • Excel の一括エクスポートと質問・回答記録 API には、利用者がアップロードした添付ファイルの原本は含まれません。

  • 現在、顧客が会話の添付ファイルを一括ダウンロードするための公開 API はありません。添付ファイルの保存が必要な場合は、適切なデータ提供方法について MaiAgent チームにお問い合わせください。

プライバシーに関する注意

エクスポートした会話記録には利用者の個人情報が含まれる場合があります。適切に保管し、プライバシーポリシーと関連法規を遵守してください。

よくある質問

Q：会話ビューアーと通常の会話画面はどう違いますか？

A：会話ビューアーでは、ツールの使用記録、ナレッジベースの引用追跡、Token 使用量の統計など、より詳しい情報を確認できます。分析、監視、研修に適しています。通常の会話画面は、日々の返信業務に適しています。

Q：会話ビューアーから直接返信できますか？

A：できません。会話ビューアーは閲覧専用で、確認と分析に使用します。返信する場合は、会話一覧に戻って操作してください。

Q：会話ビューアーには削除済みのメッセージも表示されますか？

A：表示されません。現在存在するメッセージの記録だけが表示されます。削除済みのメッセージは復元して表示できません。

Q：会話ビューアーの読み込みが遅い場合はどうすればよいですか？

A：考えられる原因と対処方法は次のとおりです。

  • 会話が長い：メッセージが 100 件を超える会話は読み込みに時間がかかる場合があります。しばらくお待ちください。

  • ネットワークの問題：ネットワーク接続を確認してください。

  • 大きな添付ファイル：画像やファイルが多すぎると、読み込みが遅くなる場合があります。

関連機能

関連情報

前へすべての会話で使える機能
次へ受信トレイ検索

最終更新

役に立ちましたか？