tool_call.started
⚠️
Preview — this feature is being built; the design below is the spec.
Received on the stream and in the event list. The agent called a tool.
Example
id: evt_01JC7M3B
data: {"type": "tool_call.started", "tool_call_id": "call_7", "name": "lookup_order", "arguments": {"order_id": "88123"}, "executor": "client"}Fields
| Field | Meaning |
|---|---|
executor | syntic when Syntic runs the tool (server tools, MCP, environment tools); client when your code must run it and reply with user.tool_result. |
Handling
When executor is client, run the tool and send the result promptly; the session waits in requires_action.
Was this page helpful?