Do not add an imaginary flag.Choose effort at the shared model boundary, then verify the durable request header.
Declaration is not selection.
Declares the exact model's supported level IDs and wire spellings.
Sets the pi-ai provider profile's deployment default.
Records a selected effort on the Agent/request path.
Proves which provider, model, and effort actually ran.
Three supported operating paths.
Save a selection, then use the same DSH_HOME for a fresh headless Agent.
Set reasoning: max only when the exact model offers it.
Apply a removable adapter-specific override before the task positional.
Visible thinking text is not the verification boundary.
A provider can reason by default without selectable metadata. Inspect request/header and sanitized wire evidence.
Primary evidence.
Make the effective effort observable.
The complete guide covers shared defaults, profile settings, overlays, precedence, wire spelling, cost scope, and fifteen acceptance gates.
Read the complete guide