From d8dc23bde9dfe5d7cba911253e51fa258d11b4b9 Mon Sep 17 00:00:00 2001 From: Dax Raad Date: Sun, 10 Aug 2025 21:34:28 -0400 Subject: pass through additional agent options to the provider --- packages/web/src/content/docs/docs/agents.mdx | 35 +++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) (limited to 'packages/web/src/content/docs') diff --git a/packages/web/src/content/docs/docs/agents.mdx b/packages/web/src/content/docs/docs/agents.mdx index 659c8ee5f..52bb8ed14 100644 --- a/packages/web/src/content/docs/docs/agents.mdx +++ b/packages/web/src/content/docs/docs/agents.mdx @@ -360,6 +360,41 @@ The `mode` option can be set to `primary`, `subagent`, or `all`. If no `mode` is --- +### Additional options + +Any other options you specify in your agent configuration will be passed through directly to the provider as model options. This allows you to use provider-specific features and parameters. + +```json title="opencode.json" +{ + "agent": { + "reasoning": { + "model": "openai/gpt-5-turbo", + "reasoningEffort": "high", + "textVerbosity": "medium" + } + } +} +``` + +For example, with OpenAI's reasoning models, you can control the reasoning effort: + +```json title="opencode.json" +{ + "agent": { + "deep-thinker": { + "description": "Agent that uses high reasoning effort for complex problems", + "model": "openai/gpt-5-turbo", + "reasoningEffort": "high", + "textVerbosity": "low" + } + } +} +``` + +These additional options are model and provider-specific. Check your provider's documentation for available parameters. + +--- + ## Create agents You can create new agents using the following command: -- cgit v1.2.3