クエリ生成ログ
クエリジェネレーターに対するすべての呼び出しとその結果は、クエリ生成ログ [sn_query_gen_log] テーブルに記録されます。
ログの使用
検索項目 失敗したクエリや誤ったクエリを検査します。
- ユーザー、日付、または発言でエントリを検索します。
- セマンティックエンティティ/ディメンション/セグメント数を確認
- クエリ 構成子の出力 を開いて、選択された内容を確認します。
- 生のセマンティック一致については 、セマンティックフィルターの結果 と比較します。
| 症状 | 考えられる原因 | 修正 |
|---|---|---|
| 「理解できません」応答 | 一致するテーブルが見つかりません | エンティティの説明を改善します。テーブル名で言い換えます。AI 検索が実行されていることを確認します。すべてのインデックス付きソースが完全に処理されていることを確認します。 |
| 間違ったテーブルが選択されました | 類似したテーブル名、曖昧さ回避なし | 差別化するためにセマンティックな使用方法の指示を追加します。 |
| 間違ったテーブルが選択されました (権限) | ユーザーには、目的のテーブルまたはフィールドへの読み取りアクセス権がありません。 | 目的のデータに対してテーブルとフィールドの読み取り ACL を確認して付与します。 |
| 「テーブルデータへのアクセス中にエラーが発生しました」または「スコープアクセスが許可されていません」応答 | 一部のデータは保護されたアプリケーションスコープ内にあり、 AI データエクスプローラー アクセスできません。 | AI データエクスプローラー のスコープへのアクセスを許可する ACL を作成します。その後に生成された制限付き発信者アクセス (RCA) レコードを承認します。詳細については、「クエリ生成 の保護されたスコープアプリケーションへのアクセスを有効にする AI データエクスプローラーおよび」を参照してください。 |
| 結果にフィールドがありません | ディメンションがオフになっているか、ラベルが不明瞭であるか、フィールドがセマンティックレイヤーにありません | ディメンションがアクティブであることを確認します。更新ラベル。 |
| 関連フィールドが取り込まれていません | 参照テーブルがセマンティックレイヤーに存在しないか、参照ディメンションがオフになっています | 参照テーブルエンティティを追加して有効にします。参照ディメンションを有効にします。 |
| 適用されたフィルターが正しくありません | 不適切なセグメント一致 | セグメント名と説明を修正します。セグメントを無効にします。 |
| 想定どおりにフィルターなし | 一致するセグメントがありません。曖昧すぎる表現 | 手動セグメントを作成します。質問を言い換えます。 |
| レポートのセグメントが間違っています | 自動生成されたセグメントに古いか無関係なフィルターがあります | レポートセグメントソースまたは特定のセグメントを無効にします。 |
| 列 | 説明 | デフォルトで表示されますか? |
|---|---|---|
| 作成日時 | 呼び出しのタイムスタンプ クエリ生成 | はい |
| ユーザー | コールを発信したユーザー [sys_user] テーブルのユーザー。これが空白の場合は、[作成者] を試してください。 | はい |
| 発言 | ユーザーによって尋ねられた分かりやすい言葉での質問 | はい |
| ステータス | コールが成功したかどうか | はい |
| エラーメッセージ | ステータスが「エラー」の場合、これはユーザーに返されるエラーメッセージです。 | はい |
| 合計時間 | AI がクエリを処理して応答を返すまでにかかった時間 (ミリ秒) | はい |
| 「X」時間 | 各コンポーネント X がクエリの処理に費やした時間 (ミリ秒) | はい |
| セマンティックフィルターの結果 | クエリが参照するセマンティックレイヤーテーブル内のフィールド (JSON 形式) | はい |
| 発話バンクの結果 | 発話バンクで検出され、ユーザーの質問を解釈するために使用される、ユーザーの質問 (発言) に類似した質問 (JSON 形式) | はい |
| 応答 | クエリに対する JSON 応答 | はい |
| エンティティ | クエリによって参照されるエンティティテーブル内のレコード。各レコードはファクトテーブルに対応しています。 | はい |
| クエリ構成子の出力 | 生成されるクエリの JSON | はい |
| ソース | 質問が寄せられたアプリケーション。アプリケーションの一部ではないページで質問が開かれているときに Now Assist パネルから質問された場合は、代わりにそのページの UUID が表示されます。 | はい |
| 応答 | LLM が返す応答 | はい |
| 生成 AI ログ | クエリに使用される LLM | はい |
| 会話 | 一意のチャット会話 ID (クエリ生成の会話に対する Now Assist パネルなど) | はい |
| ACL 時間 | 基になるテーブルに対するユーザーのアクセスまたはセキュリティの検証に要した時間 | いいえ |
| 追加情報 | 開始時間、合計コール数、および AI 検索 実行に関するその他のメタデータ | いいえ |
| 作成者 | クエリを作成したユーザー。メンテナンス ServiceNow® ログオンしているスタッフメンバーが含まれます。 | いいえ |
| ドメイン | クエリが作成されたドメイン | いいえ |
| ドット連結済み | クエリにテーブル間のドット連結が含まれているかどうか (true/false) | いいえ |
| エンティティに使用状況スコアがあります | エンティティに使用状況スコア (true/false) があるかどうか | いいえ |
| エンティティソース | ソースが ENTITIES、USER SENSE、または SEGMENTS のいずれにあったか | いいえ |
| エラーコード | エラーが発生した場合のエラーコード | いいえ |
| フォローアップが生成されました | クエリに対して LLM が生成したフォローアップ質問の数 | いいえ |
| フォローアップが戻りました | 生成されたフォローアップの質問のうち実際に返される質問の数。質問は、たとえば、クエリを実行しているユーザーがアクセスでき、セマンティックレイヤーにあるテーブルを参照する必要があります。 | いいえ |
| LLM 時間 | 大規模言語モデル (LLM) がクエリに費やした時間 | いいえ |
| クエリコンストラクター時間 | クエリコンストラクターがクエリで費やした時間 | いいえ |
| RAG 時間 | 検索拡張生成 (RAG) がクエリで費やした時間 | いいえ |
| セマンティックディメンション数 | クエリのために検査されたテーブルレコード (ディメンション) の数 | いいえ |
| セマンティックエンティティ数 | クエリに対して検査されたテーブル (エンティティ) の数 | いいえ |
| セマンティックフィルターの結果 | セマンティックフィルターの実行結果 | いいえ |
| セマンティックフィルター時間 | セマンティックフィルターが費やした時間 | いいえ |
| セマンティックセグメント数 | クエリに対して検査されたセグメントの数 | いいえ |
| ソーステーブル | ソース ID に対応するテーブルの名前 | いいえ |
| タグ | ログに追加するタグ | いいえ |
| 更新日時 | ログエントリが最後に更新された日付スタンプ | いいえ |
| 更新者 | 前回のログエントリの更新を担当するユーザー | いいえ |
| 更新 | ログエントリの更新数 | いいえ |
| 発話バンクの結果 | 発話バンクから抽出された類似の例 | いいえ |
| 発話バンク時間 | 発話バンクの検索に要した時間 | いいえ |