ai_agent_run_completed事件模式

測量路徑

一次完成的執行成為可重複使用的分析合約

僅在所有者知道最終結果後才發出，然後在儀表板或評估工作流程依賴儲存的合約之前對其進行驗證。

1
執行完成
應用程式知道最終狀態、工具、切換、持續時間、權杖和成本。
2
合約發出
傳送有界欄位和批准的識別符號，而無需複製提示或工具負載。
3
夾具已驗證
檢查所需的型別、隱私欄位、重試和一種已知的替代結果。
4
分析重用
Power 按功能和版本審查了 SQL 的品質、可靠性和單位經濟性。

穀物

每個邏輯代理執行一個最終結果。

業主

產品結果確定後代理協調器

何時發出

成功後，失敗、取消或人工切換將成為最終決定。

現場合約

具有明確隱私邊界的型別化欄位

在生產查詢依賴現有欄位名稱和型別後，保持現有欄位名稱和型別穩定。可選上下文應受到特定決策的限制、記錄和證明。

欄位	型別	必填	隱私	含義
timestamp_utc	timestamp	yes	non-sensitive	結果邊界處的 UTC 時間。
event_id	string	yes	non-sensitive	用於重複資料刪除的穩定唯一識別符號。
release	string	yes	non-sensitive	發出事件的應用程式或服務版本。
account_id	string	yes	pseudonymous	穩定的內部帳戶識別符號，絕不是電子郵件或姓名。
run_id	string	yes	pseudonymous	由批准的步驟級事件共享的穩定識別符號。
workflow	string	yes	non-sensitive	由代理處理的版本化產品工作流程。
status	string	yes	non-sensitive	成功、失敗、取消或 human_handoff。
tool_call_count	number	yes	non-sensitive	邏輯執行中的工具呼叫總數。
estimated_cost_usd	number	no	non-sensitive	版本化的估計提供商成本分配。
task_completed	boolean	yes	non-sensitive	審查了產品級成功的定義。

合成 JSON 事件

{
  "timestamp_utc": "2026-07-29T09:29:40Z",
  "event_id": "evt_agent_01",
  "account_id": "acct_8f31",
  "release": "2026.07.3",
  "run_id": "run_f28c",
  "workflow": "support_resolution_v3",
  "status": "success",
  "tool_call_count": 3,
  "estimated_cost_usd": 0.021,
  "task_completed": true
}

隱私審查

攝取前檢查識別符號

此範例使用合成識別符號。假名值仍然可以是個人資料，並且審查欄位可以公開業務或提供商上下文。應用您自己的同意、保留、存取、居住和刪除要求。

account_id: pseudonymous
run_id: pseudonymous

驗證清單

在建置儀表板之前證明合約

Send one known ai_agent_run_completed fixture after the documented outcome boundary.
Verify all 9 required fields arrive with the documented types.
重試相同的事件識別符號並確認所選的重複資料刪除行為。
當工作流程支援時，傳送受控失敗或替代結果。
在固定視窗上執行相關 SQL 並將結果與固定裝置進行協調。

常見錯誤

保持一行等於一個持久結果

Emitting ai_agent_run_completed before agent orchestrator after the product outcome is determined knows the final outcome.
在一張資料表中混合多種穀物，這使得計數和比率不明確。
用原始 URL、有效負載、提示或錯誤文字替換受控類別。
儲存查詢和儀表板依賴於它後就地更改欄位型別。
新增識別符號，無需記錄調查、存取和保留需求。

使用合約