本文へ移動
イベント記録のテンプレート

AI エージェントのセキュリティ監査テンプレート

ツール認可の決定、ポリシーのバージョン、人間による承認、およびプライバシーに配慮した構造化イベントによる最終結果を計測します。

レビュー者 Telemetry 製品チーム に . イベント名、推奨項目、クエリで答える問い、除外するデータを確認しました. このページのレビュー担当

これにより解き明かされる質問
  • どの高リスクツールが拒否されているか、承認が必要ですか?
  • ポリシーまたはエージェントのリリースによって意思決定の構成が変わりましたか?
  • 許可されているツール呼び出しのうち、後で失敗するかインシデントレビューに入るのはどれですか?
テンプレートの証拠パス

AI agent security audit template: 実装から決定まで

プロンプトを実装の概要として扱います。有用な成果物は、コピーされたコードだけではなく、信頼できる答えを生成するレビューされたイベント コントラクトです。

  1. 1

    境界を設定する

    Instrument the point where agent_tool_authorization_decided becomes final.

  2. 2

    契約書を作成する

    Start with agent_tool_authorization_decided, agent_tool_completed, agent_policy_changed and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    フィクスチャを実行する

    集計結果に依存する前に、既知の成功、失敗、再試行、および空の結果のケースを実行してください。

  4. 4

    質問に答えてください

    どの高リスクツールが拒否されているか、承認が必要ですか?

テンプレートとユースケースの比較

このテンプレートでイベントを追加する

測定目標がすでに明確な場合は、このテンプレートをコピーします。一致するユースケース ガイドを使用して、イベントの境界、成功の定義、および結果の SQL がサポートする必要がある決定を確認します。

読み取り AIエージェントのセキュリティ監視

テンプレート

これをコーディングエージェントに貼り付けます

交換する YOUR_API_KEY、フローをローカルで実行し、生成されたイベントとダッシュボードを確認します。

ai-agent-security-audit

AI エージェントのセキュリティ監査テンプレート

text
Instrument AI agent security decisions with Telemetry. Use /skill.md and this Telemetry API key: YOUR_API_KEY At the authorization boundary, log agent_tool_authorization_decided with: event_id, run_id, tool_call_id, workflow, agent_name, tool_name, action_class, risk_level, decision, reason_code, policy_version, release, environment, and timestamp_utc. Use controlled values for action_class, risk_level, decision, and reason_code. Emit the authorization decision before execution, then log agent_tool_completed separately with the same correlation identifiers, status, duration_ms, and a bounded error_type. Create reviewed SQL for decision volume, denial rate, approval-required volume, policy-version changes, and allowed actions that later fail. Keep absolute counts beside rates. Do not log prompts, completions, credentials, authorization headers, tool arguments, tool results, retrieved content, customer data, or free-form policy explanations. Keep enforcement で the policy layer. Use Telemetry to query the resulting events.

キャプチャするイベント

agent_tool_authorization_decidedagent_tool_completedagent_policy_changedagent_approval_resolvedagent_run_completed

検証チェックリスト

完全なインストルメンテーション パスが後に残すもの

イベント

合成イベントは、安定した名前とフィールド タイプで目的のテーブルに到達します。

クエリ

最初の SQL クエリは、明示的な時間枠を使用して妥当な行を返します。

ビュー

ダッシュボードでは実際のフィールドが使用され、変更を説明するのに十分なコンテキストが含まれています。

安全性

プロンプト、本文、資格情報、署名、およびプライベート コンテンツの編集がチェックされました。

イベントスキーマの例

クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。

関連製品の機能

このワークフローを続行します AIエージェントの監視

レビュー可能な SQL を使用して、エージェントの実行、ツールの使用、モデルのコスト、品質、製品の結果を結び付けます。

関連する SQL レシピ

その他のSQL例

このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。

すべてのレシピを参照する

その他のテンプレート