> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/hook/execution-logs.md). # Hook の実行ログ Hook による各ブロックや書き換えのログを確認し、添付ファイルやツールの返却内容に対する確認元を追跡し、元のメッセージ内容を記録するかどうかを制御します。また、会話から個々のメッセージの Hook 実行詳細を追跡できます。 Hook によるブロック、書き換え、通過はすべて記録されます。規制対象の業界（金融、医療、政府）にとって、**「追跡可能であること」自体がコンプライアンス要件です**。問題が発生した場合、「どのメッセージが、どのルールによって、どのように処理され、いつ発生したか」を確認できる必要があります。

Hook 実行ログとカスタマイズ機能 — 実行ログ（Audit Log）は、該当したルール、処理アクション、処理結果、タイムスタンプなど、各処理を完全に記録します。キーワード検索、アシスタントによるフィルタリング、レポートのエクスポートに対応しています。

## 1. 実行ログを確認する左側のメニューから AgentOps → Hook 実行ログに移動します。各実行について、次の情報を確認できます。 * **AI アシスタント**——どの AI アシスタントがトリガーしたか * **Hook 名、Hook タイプ**——どの Hook が処理したか * **トリガーポイント**——どのタイミングで介入したか（ユーザーメッセージ受信時／AI 回答生成後） * **Hook アクション、結果**——何を行ったか（マスキングと書き換え／インターセプトとブロック／通過）および処理結果 * **メッセージ内容、作成日時**——どのメッセージを処理し、いつ発生したか **アシスタント、ルール、タイプ、アクション、アクション結果、トリガーポイント、日付範囲、キーワード**でフィルタリングできます。また、**レポートをエクスポート**して、さらに監査分析を行うこともできます。ページ上部には、**総実行回数、該当回数、該当率**の統計も表示されます。

Hook 実行ログ一覧 — 実行ログ一覧：各エントリには、AI アシスタント、Hook 名、トリガーポイント、アクション、結果が表示されます。個人情報マスキングで電話番号が [REDACTED_PHONE] に置き換えられた処理や、機密キーワードとプロンプトインジェクションがブロックされた処理などを確認できます。

### 個別ログの詳細を確認する任意のログを開くと、その処理の全体像が表示されます。**基本情報（Hook 名、タイプ、トリガーポイント、アクション、結果）、関連情報、メッセージ内容、Metadata** を確認でき、システムが行った処理を明確に把握できます。

Hook 実行ログの個別詳細 — 個別詳細：個人情報マスキングの例では、アクションが modify で、メッセージ内容が [REDACTED_PHONE] にマスキングされていることを確認できます。

### 添付ファイル、ナレッジベース、ツールの返却内容に対する確認を追跡する AI への入力前に実行される Hook は、ユーザーが入力した文字だけを確認するものではありません。添付ファイルの内容、ナレッジベースから取得した文章、Agent モードでのツールの返却内容も、すべて同じ Hook を通過します（詳しくは、[4 つのソース](/maiagent-user-guide/ja/build/hook.md#four-sources)を参照してください）。このような確認も実行ログとして記録され、トリガーポイントには「ユーザーメッセージ受信時」と表示されます。個別ログを開くと、**Metadata** セクションで次の情報を確認できます。 * `path`：`input_context`。このログが「ユーザー自身が直接入力したものではない」コンテンツに対する確認であることを示します * `source`：コンテンツの取得元。ツールの返却内容の場合はツール名が表示され、ナレッジベースから取得した文章の場合は取得コンテンツとして表示されます「モデルがどのツールやドキュメントから機密コンテンツを読み取ったか」を確認する場合、`source` を使用して取得元まで追跡できます。ブロックされたコンテンツはモデルに渡されず、会話自体は中断されません。 ## 2. 元のメッセージを記録するかどうかを制御する実行ログはデフォルトで、**「処理結果」のみを記録し、元の機密コンテンツを保持しません**。これにより、個人情報や機密メッセージがログ内に再度保存されることを防ぎます。デバッグ時に元の内容を確認する必要がある場合は、Hook の設定ページでマスキング前の元の値を記録の切り替えを `off` から `on` に変更できます。有効にすると、マスキングまたはブロック前の元の内容もログに保持されるため、調査が容易になります。

マスキング前の元の値を記録する切り替え — Hook 設定ページの「マスキング前の元の値を記録」フィールドで制御します。デフォルトは off（タイプと件数のみを記録し、元の個人情報は保持しません）です。デバッグが必要な場合にのみ on に変更してください。

{% hint style="warning" %} **プライバシー上のトレードオフ：**「元の値を記録」を有効にすると、元の個人情報やメッセージ内容が実行ログに保存されます。**セキュリティ上の理由から、通常は無効のままにすることを推奨します。** 問題の調査が必要な場合にのみ、一時的に有効にしてください。 {% endhint %} {% hint style="info" %} 「セマンティック個人情報マスキング」の実行ログには、元の文章が含まれません。検出サービスは個人情報の位置とタイプのみを返すため、ログにはマスキングされたタイプと件数だけが残ります。 {% endhint %} ## 3. 会話から Hook の実行詳細を確認する一元管理された実行ログに加えて、**実際の会話から処理をさかのぼって確認**することもできます。カスタマーサービス会話 → すべての会話に移動して任意の会話を開くと、その会話内で Hook によって処理（マスキングまたはブロック）されたメッセージと、その時点で実行された処理を確認できます。これにより、顧客との会話を確認しながら「このメッセージがマスキングまたはブロックされた理由」を直接把握でき、別のログと照合する必要がありません。 ## 4. 関連ページ * [Hook メッセージインターセプトの概要](/maiagent-user-guide/ja/build/hook.md)——Hook の概要、4 つのソース、7 種類の標準テンプレート * [Hook の追加と設定](/maiagent-user-guide/ja/build/hook/setup.md)——Hook の作成、パラメータの設定、AI アシスタントへの関連付け方法 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/hook/execution-logs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.