跳到主要内容

文档索引

在以下地址获取完整的文档索引:https://docs.langchain.org.cn/llms.txt

在进一步探索之前,请使用此文件发现所有可用页面。

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

支持的模型

请以 provider:model 格式指定模型(例如 google_genai:gemini-3.1-pro-previewopenai:gpt-5.4anthropic:claude-sonnet-4-6)。提供商前缀用于选择 LangChain 集成,冒号后的所有内容都会作为模型标识符传递给该提供商。有关有效的提供商字符串,请参阅 init_chat_modelmodel_provider 参数。有关特定于提供商的配置,请参阅聊天模型集成 模型标识符必须与提供商预期的格式匹配。某些提供商使用简单的名称(如 gpt-5.4),而另一些则使用命名空间 ID 或部署路径(如 zai-org/GLM-5.1),因此完整的 Deep Agents 字符串将是 baseten:zai-org/GLM-5.1。请查阅提供商的模型目录或集成文档以获取当前的标识符。

推荐模型

这些模型在 Deep Agents 评估套件中表现良好,该套件测试了基本的代理操作。通过这些评估是必要的,但对于在更长、更复杂的任务中获得强大性能而言,仅通过评估是不够的。
提供商模型
Googlegemini-3.1-pro-preview, gemini-3-flash-preview
OpenAIgpt-5.4, gpt-4o, gpt-5.4, o4-mini, gpt-5.2-codex, gpt-4o-mini, o3
Anthropicclaude-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
开源权重模型可通过 OpenRouterFireworksOllama 等提供商使用。

模型评估

Deep Agents 评估套件会对主流模型进行测试
模型文件操作检索工具使用内存对话总结
google_genai:gemini-3.1-pro-preview100%100%25%54%48%80%
openai:gpt-5.4100%100%18%51%38%100%
openai:gpt-5.592%100%20%64%52%80%
anthropic:claude-opus-4-692%100%26%69%22%100%
anthropic:claude-opus-4-7100%100%18%52%100%
baseten:moonshotai/Kimi-K2.6100%100%20%60%
baseten:zai-org/GLM-592%100%87%44%29%60%
ollama:minimax-m2.7:cloud92%90%82%38%29%60%
openrouter:deepseek/deepseek-v4-pro100%100%25%80%
openrouter:minimax/minimax-m2.792%100%20%60%
openrouter:nvidia/nemotron-3-super-120b-a12b0%0%0%0%0%0%
openrouter:z-ai/glm-5.192%100%25%33%80%
如需更多信息,请参阅 评估运行记录 (Eval runs)

配置模型参数

provider:model 格式的模型字符串传递给 createDeepAgent,或者传递一个配置好的模型实例以获得完全控制权。底层模型字符串通过 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.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 键,仅适用于该特定模型,并会合并在任何匹配的提供商级别配置文件之上。
from deepagents import ProviderProfile, register_provider_profile

# Provider-wide default: every openai model gets temperature=0.
register_provider_profile(
    "openai",
    ProviderProfile(init_kwargs={"temperature": 0}),
)

# Model-level override: gpt-5.4 additionally gets a specific reasoning effort.
# Inherits temperature=0 from the provider-level profile above.
register_provider_profile(
    "openai:gpt-5.4",
    ProviderProfile(init_kwargs={"reasoning_effort": "medium"}),
)
有关完整的字段列表、合并语义和插件打包,请参阅配置文件 (Profiles)
要调整模型构建后代理 (agent) 的行为方式,请使用工具环境配置文件 (harness profile)

在运行时选择模型

如果您的应用程序允许用户选择模型(例如使用 UI 中的下拉菜单),请使用中间件 (middleware) 在运行时交换模型,而无需重建代理。
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,
});

// Invoke with the user's model selection
const result = await agent.invoke(
  { messages: [{ role: "user", content: "Hello!" }] },
  { context: { model: "openai:gpt-5.4" } },
);
对于更动态的模型模式(例如基于对话复杂性或成本优化进行路由),请参阅 LangChain 代理指南中的动态模型 (Dynamic model)

了解更多


© . This site is unofficial and not affiliated with LangChain, Inc.