> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pick a model family for each DinoAI agent

> Pin each DinoAI agent to a model family covering its main, sub-agent, and planning models, set in the builder, in YAML, or per run over the API.

*September 9, 2026*

Until now every DinoAI agent ran on the workspace's default models. An agent can now be pinned to a **model family**: a named set that says which model does the main work, which runs sub-agents, and which handles planning.

* **In the builder.** The **Model** section of the [agent builder](/products/dino-ai/programmable-agents/creating-agents-in-the-app#model) lists the families configured for your workspace, each showing its three role models and their credit rates. Pick one and it is saved with the agent.
* **In YAML.** Agents defined in your repo take a `model_family: <slug>` field, and the builder round-trips it, so the form and the YAML view stay in agreement. The older `model:` field is still accepted and still ignored.
* **Per run.** The [trigger mutation](/developers/graphql-api/api-reference/dinoai-programmable-agents-api) takes an optional `modelFamily` argument that overrides the agent's own choice for that run.
* **Visible after the fact.** A session's header carries a chip naming the family the run actually used, with the three role models in its tooltip. The family is resolved once when the session starts, so editing an agent mid-run cannot move that run onto different models.

If a family names a model your workspace does not have, or an agent references a family that no longer exists, the run falls back to the default family and says so rather than failing. Workspaces with no families configured keep today's automatic behavior.

Shipped in Paradime v6.12.0.


## Related topics

- [Changelog](/changelog/overview.md)
- [Creating Agents in the App](/products/dino-ai/programmable-agents/creating-agents-in-the-app.md)
- [Supported models](/products/dino-ai/supported-models.md)
- [DinoAI Programmable Agents API](/developers/graphql-api/api-reference/dinoai-programmable-agents-api.md)
- [YAML Configuration](/products/dino-ai/programmable-agents/yaml-configuration.md)