Supported models
Specify models inprovider:model format (for example, google_genai:gemini-3.6-flash, openai:gpt-5.4, or anthropic:claude-sonnet-4-6). The provider prefix selects the LangChain integration, and everything after the colon is passed through to that provider as the model identifier. For valid provider strings, see the model_provider parameter of init_chat_model. For provider-specific configuration, see chat model integrations.
The model identifier must match the format expected by the provider. Some providers use simple names like gpt-5.5; others use namespaced IDs or deployment paths like zai-org/GLM-5.2, so the full Deep Agents string would be baseten:zai-org/GLM-5.2. Check the provider’s model catalog or integration docs for the current identifiers.
Suggested models
These models perform well on the Deep Agents eval suite, which tests basic agent operations. Passing these evals is necessary but not sufficient for strong performance on longer, more complex tasks.
Open-weight models are available through providers like Baseten, Fireworks, OpenRouter, and Ollama.
Model evaluations
The Deep Agents eval suite tests popular models:Configure model parameters
Pass a model string tocreate_deep_agent in provider:model format, or pass a configured model instance for full control. Under the hood, model strings are resolved via init_chat_model.
To configure model-specific parameters, use init_chat_model or instantiate a provider model class directly:
Available parameters vary by provider. See the chat model integrations page for provider-specific configuration options.
Provider profiles
AProviderProfile packages initialization parameters that apply when you provide a provider:model string when creating the deep agent. It does not apply when you pass a preconfigured model with init_chat_model.
You can register at two levels, and both can coexist:
- Provider level: a bare provider key like
"openai"applies to every model from theopenaiprovider. - Model level: a
provider:modelkey like"openai:gpt-5.4"applies only to that specific model, and merges on top of any matching provider-level profile.
OpenAI and the Responses API
When you pass anopenai:... string as the model, Deep Agents uses the built-in OpenAI provider profile to enable the Responses API by default. That path supports OpenAI conversation state and related features; see the OpenAI provider and chat model docs for current API options.
The built-in OpenAI provider profile applies only to model strings. To set kwargs such as
use_responses_api, store, or include, pass a configured model instance, or, in Python, layer them through a provider profile init_kwargs. Build the instance with init_chat_model (Python) or initChatModel / ChatOpenAI (TypeScript).use_responses_api=False:
store=False) while still receiving encrypted reasoning output, set include so reasoning is returned as encrypted content:
Select a model at runtime
If your application lets users choose a model (for example using a dropdown in the UI), use middleware to swap the model at runtime without rebuilding the agent. Pass the user’s model selection through runtime context, then use awrap_model_call middleware to override the model on each invocation using the @wrap_model_call decorator:
View example trace
Open a public LangSmith run for this example.
Learn more
- Models in LangChain: chat model features including tool calling, structured output, and multimodality
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

