Skip to main content

​
get_plan_audit_logs

プラン、複数のプラン、またはポートフォリオ全体のガバナンス状態と監査証跡を取得します。予算追跡、検証履歴、コンプライアンスサマリーを返します。

​
リクエスト

{
  "tool": "get_plan_audit_logs",
  "arguments": {
    "plan_ids": ["plan_q1_2026_launch"],
    "include_entries": true
  }
}
結果は各プラン内で media_buy_id ごとにグループ化されます。 複数プラン — 1回の呼び出しで特定のプランを取得します: 
{
  "tool": "get_plan_audit_logs",
  "arguments": {
    "plan_ids": ["plan_q1_2026_launch", "plan_q1_2026_emea"],
    "include_entries": false
  }
}
ポートフォリオクエリ — 1つ以上のポートフォリオのすべてのメンバープランの統合監査データを取得します: 
{
  "tool": "get_plan_audit_logs",
  "arguments": {
    "portfolio_plan_ids": ["portfolio_nova_brands_2026"],
    "include_entries": true
  }
}
plan_ids と portfolio_plan_ids を組み合わせて、1回の呼び出しで特定のプランとポートフォリオの両方をクエリできます。

​
レスポンス

{
  "plans": [
    {
      "plan_id": "plan_q1_2026_launch",
      "plan_version": 1,
      "status": "active",
      "budget": {
        "authorized": 500000,
        "committed": 425000,
        "remaining": 75000,
        "utilization_pct": 85
      },
      "channel_allocation": {
        "olv": { "committed": 275000, "pct": 55 },
        "display": { "committed": 150000, "pct": 30 }
      },
      "media_buys": [
        {
          "media_buy_id": "mb_seller_456",
          "status": "active",
          "committed": 275000,
          "check_count": 8
        },
        {
          "media_buy_id": "mb_seller_789",
          "status": "active",
          "committed": 150000,
          "check_count": 7
        }
      ],
      "summary": {
        "checks_performed": 15,
        "outcomes_reported": 12,
        "statuses": {
          "approved": 12,
          "denied": 1,
          "conditions": 1,
          "escalated": 1
        },
        "findings_count": 2,
        "escalations": [
          {
            "check_id": "chk_esc_001",
            "reason": "Budget reallocation exceeds threshold",
            "resolution": "approved_by_human",
            "resolved_at": "2026-03-16T09:30:00Z"
          }
        ],
        "drift_metrics": {
          "escalation_rate": 0.07,
          "escalation_rate_trend": "stable",
          "auto_approval_rate": 0.80,
          "human_override_rate": 0.02,
          "mean_confidence": 0.88,
          "thresholds": {
            "escalation_rate_min": 0.02,
            "auto_approval_rate_max": 0.95,
            "human_override_rate_max": 0.15
          }
        }
      },
      "entries": [
        {
          "id": "chk_001",
          "type": "check",
          "timestamp": "2026-03-10T10:05:00Z",
          "caller": "https://orchestrator.pinnacle-media.com/agent",
          "tool": "get_products",
          "status": "approved",
          "binding": "proposed",
          "explanation": "Product discovery within budget and channel constraints.",
          "categories_evaluated": ["budget_authority", "strategic_alignment"],
          "policies_evaluated": ["us_coppa"]
        },
        {
          "id": "chk_003",
          "type": "check",
          "timestamp": "2026-03-15T11:05:00Z",
          "caller": "https://ads.seller-example.com/adcp",
          "tool": "create_media_buy",
          "status": "approved",
          "binding": "committed",
          "explanation": "Media buy within plan budget ($150,000 of $500,000 remaining). Geo targeting matches authorized markets. COPPA compliance verified.",
          "categories_evaluated": ["budget_authority", "regulatory_compliance", "brand_policy"],
          "policies_evaluated": ["us_coppa", "alcohol_advertising"],
          "findings": [
            {
              "category_id": "budget_authority",
              "severity": "info",
              "explanation": "Budget utilization at 70% after this buy."
            }
          ]
        },
        {
          "id": "out_001",
          "type": "outcome",
          "timestamp": "2026-03-15T11:10:00Z",
          "caller": "https://orchestrator.pinnacle-media.com/agent",
          "outcome": "completed",
          "committed_budget": 150000
        },
        {
          "id": "out_del_001",
          "type": "outcome",
          "timestamp": "2026-03-22T00:00:00Z",
          "caller": "https://ads.seller-example.com/adcp",
          "outcome": "delivery",
          "media_buy_id": "mb_seller_456",
          "outcome_status": "accepted"
        }
      ]
    }
  ]
}

​
フィールド

​
リクエスト

フィールド型必須説明
plan_idsstring[]plan_ids または portfolio_plan_ids のいずれか取得するプラン ID。
portfolio_plan_idsstring[]plan_ids または portfolio_plan_ids のいずれかポートフォリオプラン ID。メンバープランに展開されます。
include_entriesbooleanNo完全な監査証跡を含めます。デフォルト: false。

​
レスポンス

フィールド型説明
plansarrayリクエストされた各プランの監査データ。
plans[].plan_idstringプラン識別子。
plans[].plan_versionnumber現在のプランバージョン。
plans[].statusenumactive、suspended、または completed。
plans[].budgetobject予算状態。
plans[].budget.authorizednumberプランで認可された総予算。
plans[].budget.committednumber確認済みの結果からコミットされた総予算。
plans[].budget.remainingnumber認可額からコミット済み額を引いたもの。
plans[].budget.utilization_pctnumber認可額に対するコミット済み額のパーセンテージ。
plans[].channel_allocationobject現在のチャンネルミックス。チャンネル ID をキーとします。
plans[].channel_allocation[channel].committednumberこのチャンネルにコミットされた予算。
plans[].channel_allocation[channel].pctnumber認可された総予算に対するチャンネルのシェア。
plans[].media_buysarrayメディアバイごとの内訳。
plans[].media_buys[].media_buy_idstringセラーが割り当てたメディアバイ識別子。
plans[].media_buys[].statusenumactive、suspended、または completed。
plans[].media_buys[].committednumberこのメディアバイにコミットされた予算。
plans[].media_buys[].check_countinteger実行されたガバナンスチェックの数。
plans[].summaryobject集計された検証と結果の統計。
plans[].summary.checks_performednumber実行されたガバナンスチェックの総数。
plans[].summary.outcomes_reportednumber報告された結果の総数。
plans[].summary.statusesobject各ガバナンスチェックステータスのカウント（approved、denied、conditions、escalated）。
plans[].summary.findings_countnumberすべてのチェックと結果にわたる検出事項の総数。
plans[].summary.escalationsarrayすべてのエスカレーションとその解決策。
plans[].summary.escalations[].check_idstringエスカレーションされたガバナンスチェック。
plans[].summary.escalations[].reasonstringエスカレーションされた理由。
plans[].summary.escalations[].resolutionstring解決方法（例: approved_by_human、rejected_by_human）。
plans[].summary.escalations[].resolved_atstringISO 8601 解決タイムスタンプ。
plans[].summary.drift_metricsobject監視ドリフトを検出するための集計ガバナンスメトリクス。仕様を参照。
plans[].summary.drift_metrics.escalation_ratenumberエスカレーションに至ったチェックの割合（0-1）。
plans[].summary.drift_metrics.escalation_rate_trendenumincreasing、stable、または declining。
plans[].summary.drift_metrics.auto_approval_ratenumber人間の介入なしに承認されたチェックの割合（0-1）。
plans[].summary.drift_metrics.human_override_ratenumber人間がエージェントをオーバーライドしたエスカレーションの割合（0-1）。
plans[].summary.drift_metrics.mean_confidencenumber検出事項全体の平均信頼スコア（0-1）。検出事項に信頼度が含まれる場合に存在します。
plans[].summary.drift_metrics.thresholdsobjectドリフトメトリクスの組織定義の閾値。メトリクスが閾値を超えると、ガバナンスエージェントは検出事項を含めます。
plans[].summary.drift_metrics.thresholds.escalation_rate_maxnumber許容できる最大エスカレーション率。
plans[].summary.drift_metrics.thresholds.escalation_rate_minnumber許容できる最小エスカレーション率。この値を下回る率は監視の侵食を示す可能性があります。
plans[].summary.drift_metrics.thresholds.auto_approval_rate_maxnumber許容できる最大自動承認率。
plans[].summary.drift_metrics.thresholds.human_override_rate_maxnumber許容できる最大人間オーバーライド率。
plans[].entriesarray順序付けられた監査証跡（include_entries が true の場合のみ）。
plans[].entries[].idstringエントリー識別子。
plans[].entries[].typeenumcheck または outcome。
plans[].entries[].timestampstringISO 8601 タイムスタンプ。
plans[].entries[].plan_idstringこのエントリーが属するプラン。複数のプランまたはポートフォリオをクエリする場合に存在します。
plans[].entries[].callerstringリクエストを行ったエージェントの URL。ガバナンスコールバックで使用されたクレデンシャルから解決されます。
plans[].entries[].toolstringAdCP ツール（check エントリーに存在）。
plans[].entries[].statusenumガバナンスチェックステータス（check エントリーに存在）。
plans[].entries[].bindingenumproposed または committed（check エントリーに存在）。
plans[].entries[].explanationstringガバナンス決定の人間が読める説明（check エントリーに存在）。
plans[].entries[].policies_evaluatedarrayこのチェック中に評価されたレジストリポリシー ID。
plans[].entries[].categories_evaluatedarray評価されたガバナンスカテゴリ（例: budget_authority、regulatory_compliance）。
plans[].entries[].findingsarrayこのチェックからの検出事項。カテゴリ、深刻度、ポリシー ID、説明、信頼度を含みます。
plans[].entries[].outcomeenum結果タイプ（outcome エントリーに存在）。
plans[].entries[].committed_budgetnumberコミットされた予算（completed 結果エントリーに存在）。
plans[].entries[].media_buy_idstringメディアバイ ID（delivery 結果エントリーに存在）。
plans[].entries[].outcome_statusstring結果ステータス（outcome エントリーに存在）。

​
エラーコード

コード回復説明
PLAN_NOT_FOUNDcorrectableこの ID のプランが存在しません。

​
関連タスク

  • sync_plans — プランをプッシュまたは更新します
  • check_governance — プランに対してアクションを検証します
  • report_plan_outcome — プラン状態を更新するために結果を報告します