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、有效负载、提示或错误文本替换受控类别。
保存查询和仪表板依赖于它后就地更改字段类型。
添加标识符，无需记录调查、访问和保留需求。

使用合同