Hook の実行ログ
Hook による各ブロックや書き換えのログを確認し、添付ファイルやツールの返却内容に対する確認元を追跡し、元のメッセージ内容を記録するかどうかを制御します。また、会話から個々のメッセージの Hook 実行詳細を追跡できます。
Hook によるブロック、書き換え、通過はすべて記録されます。規制対象の業界（金融、医療、政府）にとって、「追跡可能であること」自体がコンプライアンス要件です。問題が発生した場合、「どのメッセージが、どのルールによって、どのように処理され、いつ発生したか」を確認できる必要があります。
1. 実行ログを確認する
左側のメニューから AgentOps → Hook 実行ログに移動します。各実行について、次の情報を確認できます。
AI アシスタント——どの AI アシスタントがトリガーしたか
Hook 名、Hook タイプ——どの Hook が処理したか
トリガーポイント——どのタイミングで介入したか（ユーザーメッセージ受信時／AI 回答生成後）
Hook アクション、結果——何を行ったか（マスキングと書き換え／インターセプトとブロック／通過）および処理結果
メッセージ内容、作成日時——どのメッセージを処理し、いつ発生したか
アシスタント、ルール、タイプ、アクション、アクション結果、トリガーポイント、日付範囲、キーワードでフィルタリングできます。また、レポートをエクスポートして、さらに監査分析を行うこともできます。ページ上部には、総実行回数、該当回数、該当率の統計も表示されます。
個別ログの詳細を確認する
任意のログを開くと、その処理の全体像が表示されます。基本情報（Hook 名、タイプ、トリガーポイント、アクション、結果）、関連情報、メッセージ内容、Metadata を確認でき、システムが行った処理を明確に把握できます。
添付ファイル、ナレッジベース、ツールの返却内容に対する確認を追跡する
AI への入力前に実行される Hook は、ユーザーが入力した文字だけを確認するものではありません。添付ファイルの内容、ナレッジベースから取得した文章、Agent モードでのツールの返却内容も、すべて同じ Hook を通過します（詳しくは、4 つのソースを参照してください）。このような確認も実行ログとして記録され、トリガーポイントには「ユーザーメッセージ受信時」と表示されます。個別ログを開くと、Metadata セクションで次の情報を確認できます。
path：input_context。このログが「ユーザー自身が直接入力したものではない」コンテンツに対する確認であることを示しますsource：コンテンツの取得元。ツールの返却内容の場合はツール名が表示され、ナレッジベースから取得した文章の場合は取得コンテンツとして表示されます
「モデルがどのツールやドキュメントから機密コンテンツを読み取ったか」を確認する場合、source を使用して取得元まで追跡できます。ブロックされたコンテンツはモデルに渡されず、会話自体は中断されません。
2. 元のメッセージを記録するかどうかを制御する
実行ログはデフォルトで、「処理結果」のみを記録し、元の機密コンテンツを保持しません。これにより、個人情報や機密メッセージがログ内に再度保存されることを防ぎます。
デバッグ時に元の内容を確認する必要がある場合は、Hook の設定ページで マスキング前の元の値を記録の切り替えを off から on に変更できます。有効にすると、マスキングまたはブロック前の元の内容もログに保持されるため、調査が容易になります。
プライバシー上のトレードオフ：「元の値を記録」を有効にすると、元の個人情報やメッセージ内容が実行ログに保存されます。セキュリティ上の理由から、通常は無効のままにすることを推奨します。 問題の調査が必要な場合にのみ、一時的に有効にしてください。
3. 会話から Hook の実行詳細を確認する
一元管理された実行ログに加えて、実際の会話から処理をさかのぼって確認することもできます。カスタマーサービス会話 → すべての会話に移動して任意の会話を開くと、その会話内で Hook によって処理（マスキングまたはブロック）されたメッセージと、その時点で実行された処理を確認できます。
これにより、顧客との会話を確認しながら「このメッセージがマスキングまたはブロックされた理由」を直接把握でき、別のログと照合する必要がありません。
4. 関連ページ
Hook メッセージインターセプトの概要——Hook の概要、4 つのソース、7 種類の標準テンプレート
Hook の追加と設定——Hook の作成、パラメータの設定、AI アシスタントへの関連付け方法
最終更新
役に立ちましたか？