模型 - Docs by LangChain中文

Deep Agents 可与任何支持工具调用的 LangChain 聊天模型配合使用。

支持的模型

使用 provider:model 格式指定模型（例如 google_genai:gemini-3.6-flash、openai:gpt-5.4 或 anthropic:claude-sonnet-4-6）。提供商前缀用于选择 LangChain 集成，冒号后面的所有内容都会作为模型标识符传递给该提供商。有关有效的提供商字符串，请参见 init_chat_model 的 model_provider 参数。有关提供商特定的配置，请参见聊天模型集成。模型标识符必须符合提供商要求的格式。一些提供商使用简单的名称，如 gpt-5.5；其他提供商则使用命名空间 ID 或部署路径，如 zai-org/GLM-5.2，因此完整的 Deep Agents 字符串将是 baseten:zai-org/GLM-5.2。请查看提供商的模型目录或集成文档以获取当前的标识符。

提供商	模型
Google	`gemini-3.1-pro-preview`, `gemini-3.6-flash`
OpenAI	`gpt-5.5`, `gpt-5.4`
Anthropic	`claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6`
开放权重模型	`GLM-5.2`, `Kimi-K2.7 Code`, `MiniMax-M3`

模型评估

Deep Agents 评估套件对常用模型进行了测试：

模型	综合评分	文件操作	检索能力	工具使用	记忆能力	对话能力	总结能力
google_genai:gemini-3.6-flash	82%	100%	100%	90%	54%	38%	80%
openai:gpt-5.4	18%	100%	100%	18%	51%	38%	100%
openai:gpt-5.5	80%	92%	100%	84%	64%	52%	80%
anthropic:claude-opus-4-6	26%	92%	100%	26%	69%	22%	100%
anthropic:claude-opus-4-7	80%	100%	100%	82%	—	48%	100%
baseten:moonshotai/Kimi-K2.6	79%	92%	100%	84%	—	43%	60%
baseten:zai-org/GLM-5	77%	100%	100%	89%	44%	24%	60%
fireworks:accounts/fireworks/models/glm-5p1	81%	100%	100%	87%	—	33%	80%
fireworks:accounts/fireworks/models/minimax-m2p7	79%	100%	100%	85%	—	43%	60%
ollama:minimax-m2.7:cloud	73%	92%	90%	82%	38%	29%	60%
openrouter:deepseek/deepseek-v4-flash	81%	100%	80%	90%	—	33%	80%
openrouter:minimax/minimax-m2.7	80%	92%	100%	89%	—	43%	60%
openrouter:z-ai/glm-5.1	89%	92%	100%	89%	—	33%	80%

更多信息，请参阅评估运行。

配置模型参数

在 createDeepAgent 中使用 provider:model 格式传递模型字符串，或传递一个已配置的模型实例以进行完全控制。底层会通过 init_chat_model 解析模型字符串。要配置模型特定参数，请使用 init_chat_model 或直接实例化提供商模型类：

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

const model = await initChatModel("google-genai:gemini-3.6-flash", {
  reasoningEffort: "medium",
});
const agent = createDeepAgent({ model });

import { ChatGoogle } from "@langchain/google";
import { createDeepAgent } from "deepagents";

const model = new ChatGoogle({
  model: "gemini-3.1-pro-preview",
  reasoningEffort: "medium", // （高亮显示）
});
const agent = createDeepAgent({ model });

可用参数因提供商而异。有关提供商特定的配置选项，请参见聊天模型集成页面。

提供商配置文件

ProviderProfile 封装了初始化参数，这些参数在您创建 Deep Agent 时提供 provider:model 字符串时生效。当您传递已通过 init_chat_model 配置好的模型时，它不会生效。您可以在两个级别进行注册，两者可以共存：

提供商级别 — 像 "openai" 这样的裸提供商键适用于来自 openai 提供商的每一个模型。
模型级别 — 像 "openai:gpt-5.4" 这样的 provider:model 键仅适用于该特定模型，并会覆盖在任何匹配的提供商级别配置文件之上。

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

关于如何在模型构建后塑造代理行为，请使用工具配置文件。

在运行时选择模型

如果您的应用程序允许用户选择模型（例如通过 UI 中的下拉菜单），请使用中间件在运行时切换模型，而无需重新构建代理。

import { createMiddleware, initChatModel } 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.6-flash",
  middleware: [configurableModel],
  contextSchema,
});

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

有关更动态的模型模式（例如基于对话复杂性或成本优化进行路由），请参阅 LangChain 代理指南中的动态模型。

了解更多

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

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

Get started

Deployment

Execution environment

Context management

Delegation

Steering

Frontend

Protocols

模型

支持的模型

推荐模型

模型评估

配置模型参数

提供商配置文件

在运行时选择模型

了解更多

​支持的模型

​推荐模型

​模型评估

​配置模型参数

​提供商配置文件

​在运行时选择模型

​了解更多

支持的模型

推荐模型

模型评估

配置模型参数

提供商配置文件

在运行时选择模型

了解更多