チャットログ一覧
この操作手順書は作成中です。内容は順次更新します。
1. 画面の基本情報

- 画面名: チャットログ一覧
- 画面の配置: サイドメニュー > 分析 > チャットログ一覧
- 画面の性質: 一覧画面
- 画面の目的: エンドユーザーとチャットボットの対話履歴(質問内容 user_query を軸としたログ)を横断的に確認・分析し、回答精度の課題や改善対象を発見・抽出します。チャットのセッション単位ではなく、チャット単位で確認できます。
- 閲覧権限: 管理者、編集者、閲覧者
- 出力: CSV形式でデータをエクスポート可能です。
- データの保持期間: 3か月
2. 項目仕様と動作
2-1. 期間変更
- 概要: 特定の期間に発生したログを絞り込んで確認します。
- 画面の場所: ページ右上
- 制限と仕様: 簡易的に指定可能な期間は過去7日間、過去30日間、先月の3つですが、カレンダーより、任意の期間を自由に設定可能です。制限はありません。
- 動作: 過去7日間、過去30日間、先月のボタンをクリックするか、カレンダーより開始日と終了日を選択して「適用」ボタンをクリックすると、該当期間のログが再読み込みされます。デフォルトは1か月のデータが表示され、「日時」の「新しい順(降順)」ですが、他の項目名をクリックすることで並び替えができます。
2-2. 関係者IP除外
- 概要: 除外対象となる社内テストのログを分析対象から外し、一般ユーザーの利用データのみを抽出するフィルタ機能です。
- 画面の場所: ページ右上
- フォーマット: ON / OFF
- 初期状態(デフォルト値): OFF
- 利用タイミング: 実利用データを正確に集計・確認したいとき
- 無効時の挙動: 社内関係者のログも一覧に含まれます。
- 有効時の挙動: 社内関係者と判定されたログが一覧から非表示になります。
- 制限と仕様: 除外対象となる社内IPアドレスがあらかじめ登録されている必要があります。
- 関係者アクセス(分析除外対象)を識別する手段:
- 全体設定からIP除外: 除外するIPがすでに分かっている場合、設定することをおすすめします。
- 方法: 社内IPアドレスを「全体設定」画面の「内部アクセスIPアドレスリスト」から追加します。
- チャット送信時のプレフィックス指定(社外・リモート環境用): IPを除外できていない場合に以下の方法で関係者判定をさせます。
- 方法: チャットの入力欄で先頭に
@testを付与して送信します(例:@test この製品の仕様を教えて)。 - 効果: 社外ネットワーク等からアクセスした場合でも、該当セッションが管理画面上で「関係者アクセス」として自動判定・処理されます。
- 方法: チャットの入力欄で先頭に
- 管理画面からの事後手動フラグ変更(付け忘れ時のリカバリー用):
@testを付け忘れた場合に後から関係者判定にさせる方法です。- 方法:
- 管理画面の「セッション一覧」画面を開きます。
- 該当セッションの「セッション詳細(タイムライン)」画面を開きます。
- 「詳細へ」をクリックして「セッション詳細」画面へ遷移します。
- 「関係者アクセス」のトグルスイッチを ON に変更します。
- 効果: プレフィックス(
@test)を付け忘れて送信されたセッションであっても、事後操作で「関係者アクセス」に変更され、関係者IP除外フィルターの対象に含めることができます。
- 方法:
- 全体設定からIP除外: 除外するIPがすでに分かっている場合、設定することをおすすめします。
2-3. フィルタ
- 概要: 回答ログ分析一覧のためのフィルタ条件を指定できます。表示項目は以下の通りです。※FBのGOOD / BADはフィルタで絞り込むことができません。
| カラム名 | 表示形式 | 説明および仕様 |
|---|---|---|
| NO_ANSWERを除外 | チェックボックス | フィルタした際の挙動:NO_ANSWER(SiteAskが回答ができなかった質問)を除外します。 |
| ブロックを除外 | チェックボックス | フィルタした際の挙動:ブロックした回答を除外します。 ※特定のブロック理由だけ指定することはできません。 |
| page_url | URL | URL検索窓にページのURLを入力すると、検索したURLのログのみを表示します。 ※完全一致ではなく、部分一致でも絞り込みが可能です。 |
| 質問キーワード | テキスト入力 | 質問キーワード検索窓に任意のキーワードを入力すると、検索したキーワードを含むチャットログの一覧を表示します。この検索窓に入力したキーワードは、「ユーザーの質問内容」だけを対象に検索する為、「ブロック理由」や「質問意図」の検索は不可能です。また、チャットログ一覧の質問キーワード検索窓はスペース区切りによる複数キーワード検索(AND検索 / OR検索)ができません。 |
2-4. チャットログ一覧
- 概要: ユーザーのチャットログ一覧を確認します。
- 表全体に対する操作: チャットログ一覧はCSVエクスポートで出力可能です。各項目名をクリックで降順 / 昇順の並び替えができます。行全体をクリックすることで「チャットログ詳細」画面へ遷移できます。
| カラム名 | 表示形式 | 説明および仕様 | アクション |
|---|---|---|---|
| 日時 | 日時(YYYY/MM/DD HH:MM:SS) | 質問が発生した日時を表示します。 | クリックして並び替えます。 |
| SID | 数値 | 各質問を識別するための管理番号を表示します。 ※SiteAskが独自に付与します。 | クリックして並び替えます。 |
| 回答結果 | テキスト | 回答の結果を表示します。 項目は以下の通りです。 OK(生成):Agent Searchが回答を生成した OK(固定):ユーザーが直接入力した質問の回答が、よくある質問の回答と一致した場合のステータス OK(識別固定):ユーザーがよくある質問を選んで回答が返った場合のステータス BLOCK:質問ガードまたは回答ガードがブロックした GENERAL:サイトに情報が足りず、生成AIが一般的な回答を返した NG:Agent Searchが回答を生成できなかった ERROR:処理中に内部エラーが発生した | クリックして並び替えます。 |
| URL | URL | 質問が発生したページのURLを表示します。 | クリックして並び替えます。 |
| ブロック理由 | テキスト | 回答ガードで設定されたブロック設定により回答がブロックされ、その理由を表示します。 表示項目例: 不適切表現 範囲外 脱獄・機密要求 人を無効化する差別的表現の疑い 攻撃的・排除を示唆する不適切要求 意味不明 案内 サイト自体への質問 チャット使用の質問 サイト機能の質問 サイト外質問 | クリックして並び替えます。 |
| 質問 | テキスト | ユーザーが送信した質問内容(補正前)を表示します。 | クリックして並び替えます。 |
| FB | テキスト | チャットに表示される「役に立ちましたか」という質問に対するユーザーのフィードバック(FB)、「GOOD / BAD」を表示します。 ※ユーザーのフィードバックがない場合は表示されません。 ※フィルタ機能で絞り込みできません。 | クリックして並び替えます。 |
| 質問意図 | テキスト | 引用元コントロール設定で設定した「質問意図」を表示します。 設定されていない場合は表示されません。 | クリックして並び替えます。 |
| 訴求ラベル | テキスト | 訴求設定で設定した「訴求ラベル」を表示します。 有効化されていない、またラベルが設定されていない場合は表示されません。 | クリックして並び替えます。 |
| 修正行程 | テキスト | AIが回答の修正を試みた回数を表示します。 「ガードレール設定」画面内の「グラウンディングスコア調整」がONになっている場合のみ表示されます。 | クリックして並び替えます。 |
| ページネーション | ボタン | 1ページあたり100件表示します。 100件以上は2ページ目以降に表示されます。 ※ユーザーがページごとの表示件数を変更することはできません。 | 「Next」または現ページより大きい数字をクリックすると次ページへ遷移、「Previous」または現ページより小さい数字をクリックすると前ページへ遷移します。 |
| CSVエクスポート | ボタン | CSV形式のファイルをダウンロード可能です。 →CSVをダウンロードした際、エクスポートされるのは「フィルタ条件に合致する全件(ページネーションの裏側にあるものも含む)」です。 | クリックしてダウンロードします。 |
3. 操作手順
3-1. チャット詳細を確認する
- 「チャットログ一覧」画面でログを一覧し、左上のフィルタで確認したいログの条件を指定します。
- 詳細を確認したいログをクリックして、「チャットログ詳細」画面を開きます。チャットの処理状況などを確認できます。
- 「セッション詳細(タイムライン)」をクリックします。このチャットを含むセッションがタイムライン形式で表示されます。ユーザーがこのチャットをどのような文脈でしたのかを確認できます。
4. 関連機能と他画面との連動
4-1. 他画面への影響(設定変更の波及)
| 自画面の設定項目 | 影響を受ける画面 | 対象画面での影響内容・表示変化 |
|---|---|---|
| 「チャットログ一覧」の「ログ(行)」 | チャットログ詳細 | 「チャットログ一覧」画面の「ログ(行)」をクリックすると、「チャットログ詳細」画面へ遷移します。 |
4-2. 他画面からの影響(前提条件)
| 設定項目名 | 前提となる設定画面 | 必要な設定状態・条件 |
|---|---|---|
| 質問意図 | 引用元コントロール設定画面内「質問意図設定」 | 引用元コントロール設定で設定した「質問意図」のラベルを表示します。 設定していない場合はラベルが表示されません。 |
| 訴求ラベル | 「訴求設定」画面 | 訴求設定で設定した訴求ラベルを表示します。 有効化されていない、またラベルが設定されていない場合は表示されません。 |
| ブロック理由 | ガードレール設定 > プロンプト設定の「3-1. 回答ガード」 | ガードレール設定 > プロンプト設定の「3-1. 回答ガード」で設定したブロック理由が表のブロック理由に表示されます。 回答ガードの利用をONにしてない場合は表示されません。 |
| 回答結果 | よくある質問 / ガードレール設定 | よくある質問が設定されていると「OK(固定) / OK(識別固定)」のステータスが表示されます。 ガードレール設定で質問ガードおよび回答ガードの設定をONにしている場合は、BLOCKのステータスが表示されます。 ガードレール設定の一般回答の利用設定がONになっている場合、GENERALとステータスが表示されます。 |
| FB | UI設定 | フィードバックボタンの表示設定をONにした場合、GOOD / BADの表示ステータスが表示されます。 |
5. 注意事項と運用上のポイント
- 注意事項: ログの保持期間は3か月です。期間を過ぎたログは復元できませんので、長期的な分析や記録保管が必要な場合は定期的にCSVエクスポートを実行してください。
- 運用上のポイント: 頻出する問い合わせは「モデル質問」に追加することを推奨します。