Skip to content

docs: add variant option to agents page #12457

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yukukotani wants to merge 2 commits into
base: dev
Choose a base branch
from
+23 −0
Open

docs: add variant option to agents page #12457

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d040666
docs: add variant option to agents page
yukukotani Feb 6, 2026
241d95f
simplify
yukukotani Feb 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions packages/web/src/content/docs/agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -363,6 +363,29 @@ The model ID in your OpenCode config uses the format `provider/model-id`. For ex

---

### Variant

Set the default [model variant](/docs/models#variants) for an agent with the `variant` option.

```json title="opencode.json"
{
"agent": {
"build": {
"model": "anthropic/claude-sonnet-4-20250514",
"variant": "max"
}
}
}
```

:::note
The variant only applies when the agent's configured `model` matches the model currently in use. You need to set both `model` and `variant` together.
:::

Available variant names depend on the provider. For example, Anthropic supports `high` and `max`, while OpenAI supports `low`, `medium`, `high`, and others. Learn more about [variants](/docs/models#variants).

---

### Tools

Control which tools are available in this agent with the `tools` config. You can enable or disable specific tools by setting them to `true` or `false`.
Expand Down
Loading