Skip to content

ToolCallContext

The evaluation input provided to policies at the Tool Call Interception point.

Schema ID: https://agentpolicyspecification.github.io/schemas/tool-call-context.schema.json

Properties

PropertyTypeRequiredDescription
tool_namestringYesThe name of the tool the LLM has requested to invoke
argumentsobjectYesThe arguments provided by the LLM
calling_messageAssistantMessageYesThe assistant message that produced the tool call
metadataMetadataYesAgent and session context

AssistantMessage

PropertyTypeRequiredDescription
role"assistant"YesAlways "assistant"
contentstringYesThe text content of the message

Metadata

PropertyTypeRequiredDescription
agent_idstringYesUnique identifier for the agent
session_idstringYesUnique identifier for the session
timestampstring (date-time)YesISO 8601 timestamp of the interception

Example

json
{
  "tool_name": "read_file",
  "arguments": { "path": "/workspace/data.csv" },
  "calling_message": {
    "role": "assistant",
    "content": "I will read the file to answer your question."
  },
  "metadata": {
    "agent_id": "agent-1",
    "session_id": "session-abc",
    "timestamp": "2026-03-31T10:00:01Z"
  }
}

Download

tool-call-context.schema.json

Released under the Apache 2.0 License.