Skip to content

docs: Provider reasoning capability probing matrix and documentation #267

@Oaklight

Description

@Oaklight

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:

  1. Per-provider reasoning effort support matrix — which effort values each provider/endpoint accepts or rejects
  2. Disabled behavior — how each provider handles none / disabled reasoning (omit vs thinking_disabled vs specific field values)
  3. Thinking typeenabled vs adaptive behavior per provider, model-level overrides
  4. Provider metadata round-tripreasoning_details, encrypted_content, thoughtSignature preservation
  5. 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

  • Consolidate all probing results into a single reference table
  • Document per-provider shim configuration and rationale
  • Write docs_en/docs/guide/provider-reasoning.md
  • Write docs_zh/docs/guide/provider-reasoning.md
  • Update mkdocs.yml nav in both doc worktrees
  • Cross-reference from existing reasoning guide page

Related issues

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1Priority 1: HighdocumentationImprovements or additions to documentationenhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions