Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nvd-54.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

深度智能体可与任何支持工具调用的 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。请查看提供商的模型目录或集成文档以获取当前标识符。

​
推荐模型

这些模型在深度智能体评测套件上表现良好，该套件测试基本的智能体操作。通过这些评测是必要条件，但不足以保证在更长、更复杂的任务上有强大表现。
提供商模型
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
开源权重模型可通过 OpenRouter、Fireworks 或 Ollama 等提供商获取。

​
模型评测

深度智能体评测套件测试热门模型：
ModelFile OpsRetrievalTool UseMemoryConversationSummarization
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%
更多信息请参阅评测运行记录。

​
配置模型参数

将 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 封装了当你在创建深度智能体时提供 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 智能体指南中的动态模型。

​
了解更多

连接这些文档到 Claude、VSCode 等工具，通过 MCP 获取实时解答。
在 GitHub 上编辑此页面或提交问题。