模型

为深度智能体配置模型提供商和参数

深度智能体可与任何支持工具调用的 LangChain 聊天模型配合使用。

支持的模型

以 provider:model 格式指定模型（例如 google_genai:gemini-3.1-pro-preview、openai:gpt-5.4 或 anthropic:claude-sonnet-4-6）。提供商前缀选择 LangChain 集成，冒号后的部分作为模型标识符传递给该提供商。有关有效的提供商字符串，请参阅 init_chat_model 的 model_provider 参数。有关提供商特定配置，请参阅聊天模型集成。

模型标识符必须匹配提供商期望的格式。一些提供商使用简单名称如 gpt-5.4；其他的使用命名空间 ID 或部署路径，如 zai-org/GLM-5.1，因此完整的深度智能体字符串将是 baseten:zai-org/GLM-5.1。请查看提供商的模型目录或集成文档以获取当前标识符。

推荐模型

这些模型在深度智能体评测套件上表现良好，该套件测试基本的智能体操作。通过这些评测是必要条件，但不足以保证在更长、更复杂的任务上有强大表现。

提供商	模型
Google	gemini-3.1-pro-preview、gemini-3-flash-preview
OpenAI	gpt-5.4、gpt-4o、gpt-5.4、o4-mini、gpt-5.2-codex、gpt-4o-mini、o3
Anthropic	claude-opus-4-6、claude-opus-4-5、claude-sonnet-4-6、claude-sonnet-4、claude-sonnet-4-5、claude-haiku-4-5、claude-opus-4-1
开源权重	GLM-5、Kimi-K2.5、MiniMax-M2.5、qwen3.5-397B-A17B、devstral-2-123B

开源权重模型可通过 OpenRouter、Fireworks 或 Ollama 等提供商获取。

模型评测

深度智能体评测套件测试热门模型：

Model	File Ops	Retrieval	Tool Use	Memory	Conversation	Summarization
google_genai:gemini-3.1-pro-preview	100%	100%	25%	54%	48%	80%
openai:gpt-5.4	100%	100%	18%	51%	38%	100%
openai:gpt-5.5	92%	100%	20%	64%	52%	80%
anthropic:claude-opus-4-6	92%	100%	26%	69%	22%	100%
anthropic:claude-opus-4-7	100%	100%	18%	—	52%	100%
baseten:moonshotai/Kimi-K2.6	100%	100%	20%	—	—	60%
baseten:zai-org/GLM-5	92%	100%	87%	44%	29%	60%
ollama:minimax-m2.7:cloud	92%	90%	82%	38%	29%	60%
openrouter:deepseek/deepseek-v4-pro	100%	100%	25%	—	—	80%
openrouter:minimax/minimax-m2.7	92%	100%	20%	—	—	60%
openrouter:nvidia/nemotron-3-super-120b-a12b	0%	0%	0%	0%	0%	0%
openrouter:z-ai/glm-5.1	92%	100%	25%	—	33%	80%

更多信息请参阅评测运行记录。

配置模型参数

将 provider:model 格式的模型字符串传递给 createDeepAgent，或传入配置好的模型实例以获得完全控制。底层实现中，模型字符串通过 init_chat_model 解析。

要配置模型特定参数，请使用 init_chat_model 或直接实例化提供商模型类：

initChatModel

import { initChatModel } from "langchain/chat_models/universal";
import { createDeepAgent } from "deepagents";

const model = await initChatModel("google_genai:gemini-3.1-pro-preview", {
    reasoningEffort: "medium",
});
const agent = createDeepAgent({ model });

可用参数因提供商而异。请参阅聊天模型集成页面了解提供商特定的配置选项。

提供商配置文件

ProviderProfile 封装了当你在创建深度智能体时提供 provider:model 字符串时应用的初始化参数。当你使用 init_chat_model 传入预配置模型时，它不会生效。

你可以在两个级别注册，两者可以共存：

• 提供商级别 — 类似 "openai" 的纯提供商键适用于来自 openai 提供商的每个模型。
• 模型级别 — 类似 "openai:gpt-5.4" 的 provider:model 键仅适用于该特定模型，并在任何匹配的提供商级别配置文件之上合并。

from deepagents import ProviderProfile, register_provider_profile

# 提供商范围的默认值：每个 openai 模型都使用 temperature=0。
register_provider_profile(
    "openai",
    ProviderProfile(init_kwargs={"temperature": 0}),
)

# 模型级别覆盖：gpt-5.4 额外获得特定的推理力度。
# 从上面的提供商级别配置文件继承 temperature=0。
register_provider_profile(
    "openai:gpt-5.4",
    ProviderProfile(init_kwargs={"reasoning_effort": "medium"}),
)

完整字段列表、合并语义和插件打包请参阅配置文件。

要配置模型构建完成后智能体的行为方式，请使用框架配置文件。

运行时选择模型

如果你的应用允许用户选择模型（例如使用 UI 中的下拉菜单），请使用中间件在运行时切换模型，无需重建智能体。

import { initChatModel, createMiddleware } from "langchain";
import { createDeepAgent } from "deepagents";
import * as z from "zod";

const contextSchema = z.object({
  model: z.string(),
});

const configurableModel = createMiddleware({
  name: "ConfigurableModel",
  wrapModelCall: async (request, handler) => {
    const modelName = request.runtime.context.model;
    const model = await initChatModel(modelName);
    return handler({ ...request, model });
  },
});

const agent = await createDeepAgent({
  model: "google_genai:gemini-3.1-pro-preview",
  middleware: [configurableModel],
  contextSchema,
});

// 使用用户选择的模型调用
const result = await agent.invoke(
  { messages: [{ role: "user", content: "Hello!" }] },
  { context: { model: "openai:gpt-5.4" } },
);

有关更多动态模型模式（例如基于对话复杂度的路由或成本优化），请参阅 LangChain 智能体指南中的动态模型。

了解更多

• LangChain 中的模型：聊天模型功能包括工具调用、结构化输出和多模态

---

连接这些文档到 Claude、VSCode 等工具，通过 MCP 获取实时解答。

在 GitHub 上编辑此页面或提交问题。