docs/concepts/effort-and-models.md

Effort and models

One control sets how hard a turn works and which model does the work. Every answer says which model it ran on.

The three levels

LevelModelThinkingTeammatesGood for
Quickthe fast model (Haiku 4.5)offnonelookups, "did they reply", a date or a number
Standardthe agent's own modelthe agent's ownonemost questions and drafts
Deepthe strongest model (Opus 5.5)highseveral, side by sideresearch, plans, ranking many items, anything risky

Each level has a soft time target the agent works toward and two hard ceilings, time and spend. At a ceiling the turn answers with what it has, and you can pick Dig deeper to ask again one level up.

Who picks

  • You, per message. The effort gauge in the composer. Each level shows the model it runs on.
  • Auto, otherwise. A small model reads the request and picks the level, so a quick question stays quick and a plan gets the strongest model without you choosing. Auto never picks Quick for a turn that drafts something you will send or checks two or more systems; those run at Standard or above.
  • An agent or workspace can set a default (harness.turnEffort, defaults.turnEffort).

The effort gauge open in the chat composer: Auto, Quick on Haiku 4.5, Standard on this agent's model, and Deep on Opus 5.5

Every answer names its model

The line under an answer reads like Deep · Opus 5.5 · 30s: the level, the model the turn actually ran on, and how long it took. The same choice is on the turn's trace.

An answer from the Project Manager with its footer line reading Deep, Opus 5.5, 30s

For operators

  • Standard never changes the model. An agent pinned to a model in YAML (harness.model) runs on it at Standard.
  • On OpenAI the fast and strongest models are gpt-4o-mini and gpt-4o. On Bedrock they are the Haiku and Opus inference profiles.
  • Repoint either without code: VOCION_MODEL_FAST_<PROVIDER> and VOCION_MODEL_DEEP_<PROVIDER>, for example VOCION_MODEL_DEEP_ANTHROPIC.
  • Missions, automations and evals run on the agent's own model.