6.11.2.7 AgentToolCall
Immutable
Records are never updated after creation.
6.11.2.7.1 Purpose¶
One invocation of a tool during a turn and its outcome: run, denied for lack of a capability or entitlement, refused by the user, or failed. It is the row the audit event and the usage ledger point to.
6.11.2.7.2 Questions it answers¶
- Which tools did this turn call, with what outcome?
- Was a write confirmed by the user, and by whom?
- Which audit event records a dangerous call?
6.11.2.7.3 Fields¶
| Field | Type | Cardinality | Description |
|---|---|---|---|
id |
string (uuid) |
1..1 |
Key. |
message |
AgentMessage | 1..1 |
|
tool |
AgentTool | 1..1 |
|
input_hash |
string |
1..1 |
Hash of the arguments; the arguments themselves stay in the message. |
outcome |
enum | 1..1 |
Values: ok, denied, confirmed, refused, failed.denied: the sender lacked the capability or entitlement; refused: the user did not confirm a write. |
latency_ms |
integer |
0..1 |
|
audit_event |
PlatformAuditEvent | 0..1 |
Set for dangerous tools and for every staff write. |
created_at |
datetime |
1..1 |
6.11.2.7.4 Relationships¶
References
AgentToolCall.message→ AgentMessage (1..1)AgentToolCall.tool→ AgentTool (1..1)AgentToolCall.audit_event→ PlatformAuditEvent (0..1)
6.11.2.7.5 Rules & constraints¶
- One tool invocation and its outcome; the row the audit and the ledger point to.