Context
We have accumulated significant probing data across multiple providers and API formats for reasoning effort support, thinking type behavior, and disabled strategies. This data is currently scattered across multiple issues and comments. We need a consolidated arching issue to track all probing work and ultimately produce a documentation page.
Goal
Create a comprehensive documentation page (in both docs_en and docs_zh) covering:
- Per-provider reasoning effort support matrix — which effort values each provider/endpoint accepts or rejects
- Disabled behavior — how each provider handles
none / disabled reasoning (omit vs thinking_disabled vs specific field values)
- Thinking type —
enabled vs adaptive behavior per provider, model-level overrides
- Provider metadata round-trip —
reasoning_details, encrypted_content, thoughtSignature preservation
- Shim configuration reference — how
ReasoningCapability fields map to upstream behavior
Existing probing data
Argo parameter probing
Reasoning effort probing (official upstream APIs)
Reasoning effort IR design
Thinking type normalization
Sub-tasks
Related issues
Context
We have accumulated significant probing data across multiple providers and API formats for reasoning effort support, thinking type behavior, and disabled strategies. This data is currently scattered across multiple issues and comments. We need a consolidated arching issue to track all probing work and ultimately produce a documentation page.
Goal
Create a comprehensive documentation page (in both
docs_enanddocs_zh) covering:none/ disabled reasoning (omitvsthinking_disabledvs specific field values)enabledvsadaptivebehavior per provider, model-level overridesreasoning_details,encrypted_content,thoughtSignaturepreservationReasoningCapabilityfields map to upstream behaviorExisting probing data
Argo parameter probing
Reasoning effort probing (official upstream APIs)
Reasoning effort IR design
reasoning.effort"none" and "xhigh" handling in Responses endpointThinking type normalization
thinking_typefield inReasoningCapability, model-level overrides viamodel_reasoningSub-tasks
docs_en/docs/guide/provider-reasoning.mddocs_zh/docs/guide/provider-reasoning.mdmkdocs.ymlnav in both doc worktreesRelated issues