Tool parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
type | string | required | Must be "advisor_20260301". |
name | string | required | Must be "advisor". |
model | string | required | The advisor model ID, such as claude-opus-5. Billed at this model's rates for the sub-inference. |
max_uses | integer | unlimited | Maximum number of advisor calls allowed in a single request. Once the executor reaches this cap, further advisor calls return an advisor_tool_result_error with error_code: "max_uses_exceeded" and the executor continues without further advice. This is a per-request cap, not a per-conversation cap. See Cost control for conversation-level limits. |
max_tokens | integer | advisor model's output cap | Caps the advisor's total output (thinking plus text) per call. Minimum 1024. See Capping advisor output. |
caching | object | null | null (off) | Enables prompt caching for the advisor's own transcript across calls within a conversation. See Advisor prompt caching. |
The caching object has the shape \{"type": "ephemeral", "ttl": "5m" | "1h"\}. Unlike cache_control on content blocks, this is not a breakpoint marker. It is an on/off switch. The server determines where cache boundaries go.
The advisor tool also accepts the generic properties available on any tool definition: cache_control, allowed_callers, defer_loading, and strict (covered in structured outputs). See the Tool reference for their semantics.