agent_tool_authorization_decided事件模式

合同证据路径

agent_tool_authorization_decided：从拥有边界到可信查询

将 agent_tool_authorization_decided 视为持久的分析合约：所有者发出一个记录的谷物，一个固定装置证明字段，并且经过审查的查询回答所述问题。

1
结果成为最终结果
Agent authorization or policy-enforcement layer emits only after policy evaluation is final and before the tool is allowed to execute.
2
合同是有约束力的
12 required fields preserve the declared grain: One final authorization decision per logical tool-call attempt.
3
夹具已验证
检查类型、UTC 时间、替代结果、幂等性以及每个假名或评论分类字段。
4
问题得到解答
允许、拒绝哪些智能体工具操作或将其转交人工批准？

谷物

每次逻辑工具调用尝试都会做出一个最终授权决策。

业主

智能体授权或策略执行层

何时发出

在策略评估最终确定之后且在允许执行该工具之前。

现场合同

具有明确隐私边界的类型化字段

在生产查询依赖现有字段名称和类型后，保持现有字段名称和类型稳定。可选上下文应受到特定决策的限制、记录和证明。

字段	类型	必填	隐私	含义
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	与批准的结果事件共享稳定的智能体运行标识符。
tool_call_id	string	yes	pseudonymous	逻辑工具调用尝试的稳定标识符；永远不要嵌入参数。
workflow	string	yes	non-sensitive	版本化、低基数智能体工作流程。
tool_name	string	yes	non-sensitive	批准的低基数工具标识符。
risk_level	string	yes	non-sensitive	审查风险等级，例如低、中或高。
decision	string	yes	non-sensitive	允许、拒绝或 approval_required。
reason_code	string	yes	non-sensitive	政策管制原因；从来没有自由形式的模型解释。
policy_version	string	yes	non-sensitive	做出决定的保单合同版本。

合成 JSON 事件

{
  "timestamp_utc": "2026-07-30T16:24:12Z",
  "event_id": "evt_agent_authz_01",
  "account_id": "acct_8f31",
  "release": "2026.07.4",
  "run_id": "run_f28c",
  "tool_call_id": "tool_call_a913",
  "workflow": "support_resolution_v3",
  "tool_name": "database_write",
  "risk_level": "high",
  "decision": "approval_required",
  "reason_code": "external_state_change",
  "policy_version": "agent-policy-12"
}

隐私审查

摄取前检查标识符

此示例使用合成标识符。假名值仍然可以是个人数据，并且审核字段可以公开业务或提供商上下文。应用您自己的同意、保留、访问、居住和删除要求。

account_id: pseudonymous
run_id: pseudonymous
tool_call_id: pseudonymous

验证清单

在构建仪表板之前证明合同

Send one known agent_tool_authorization_decided fixture after the documented outcome boundary.
Verify all 12 required fields arrive with the documented types.
重试相同的事件标识符并确认所选的重复数据删除行为。
当工作流支持时，发送受控失败或替代结果。
在固定窗口上运行相关 SQL 并将结果与固定装置进行协调。

常见错误

保持一行等于一个持久结果

Emitting agent_tool_authorization_decided before agent authorization or policy-enforcement layer knows the final outcome.
在一张表中混合多种谷物，这使得计数和比率不明确。
用原始 URL、有效负载、提示或错误文本替换受控类别。
保存查询和仪表板依赖于它后就地更改字段类型。
添加标识符，无需记录调查、访问和保留需求。

使用合同