跳到主要内容

文档索引

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

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

Deep Agents CLI 支持任何与 LangChain 兼容的聊天模型提供商，几乎可以解锁任何支持工具调用的 LLM 的使用。任何公开 OpenAI 兼容或 Anthropic 兼容 API 的服务也都可以直接使用——请参阅兼容的 API。

​
快速开始

CLI 会自动集成以下模型提供商：除了安装相关的提供商包之外，无需额外配置。
  1. 安装提供商包 每个模型提供商都需要安装其对应的 LangChain 集成包。这些包在安装 CLI 时作为可选附加项提供，这是为了保持应用程序轻量化而特意设计的：
    # Quick install with chosen providers
# OpenAI, Anthropic, and Gemini are included by default
DEEPAGENTS_EXTRAS="baseten,groq" curl -LsSf https://langch.in/gh-da-cli | bash

# Or install directly with uv
uv tool install 'deepagents-cli[baseten,groq]'

# Add additional packages at a later date
uv tool install deepagents-cli --with langchain-ollama

# All providers
uv tool install 'deepagents-cli[anthropic,baseten,bedrock,cohere,deepseek,fireworks,google-genai,groq,huggingface,ibm,litellm,mistralai,nvidia,ollama,openai,openrouter,perplexity,vertexai,xai]'
  2. 设置凭据 将 API 密钥存储在 ~/.deepagents/.env 中，以便在所有项目中可用，或者在您的 shell 中导出它们：
    ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
    某些提供商使用其他凭据（例如，Vertex AI 使用 GOOGLE_CLOUD_PROJECT 加 ADC）。请参阅下表了解每个提供商所需的变量。您还可以使用DEEPAGENTS_CLI_ 前缀将凭据限定在 CLI。

​
提供商参考

Deep Agents CLI 是用 Python 构建的，请使用Python 提供商参考文档。

​
模型路由器和代理

模型路由器，例如OpenRouter和LiteLLM通过单个端点提供对多个提供商模型的访问。 使用这些服务的专用集成包：
Router包
OpenRouterlangchain-openrouter
OpenRouter 是一个内置提供商——安装包并直接使用它 
uv tool install 'deepagents-cli[openrouter]'
LiteLLM 也是一个内置提供商 
uv tool install 'deepagents-cli[litellm]'

​
切换模型

要在 CLI 中切换模型，可以
  1. 使用交互式模型切换器，通过 /model 命令。此命令显示来自每个已安装的 LangChain 提供商包的模型配置文件的可用模型。
    并非所有模型都显示在此处。如果您的模型缺失，请直接传递模型名称（例如 /model gpt-5.5）。请参阅切换器中显示哪些模型了解详情。
  2. 直接指定模型名称作为参数，例如 /model gpt-5.5。您可以使用所选提供商支持的任何模型，无论它是否出现在选项 1 的列表中。模型名称将传递给 API 请求。
  3. 在启动时指定模型，通过 --model，例如 
    deepagents --model openai:gpt-5.5
CLI 启动时，它会按以下顺序解析要使用的模型
  1. --model 标志，如果提供，则始终优先。
  2. [models].default 位于 ~/.deepagents/config.toml 中——用户的长期首选设置。
  3. [models].recent 位于 ~/.deepagents/config.toml 中——通过 /model 切换到的最后一个模型。自动写入；从不覆盖 [models].default。
  4. 环境自动检测：回退到第一个可用的启动凭据，按顺序检查：OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY、GOOGLE_CLOUD_PROJECT (Vertex AI)。
此启动回退机制有意仅检查这四个凭据。其他受支持的提供商（例如 Groq）仍可通过 --model、/model 以及保存的默认值（[models].default / [models].recent）获得。

​
切换器中显示哪些模型

/model 选择器从已安装的提供商包中动态构建其列表。展开下方查看完整标准和故障排除。
交互式 /model 选择器动态构建其列表——它不是 CLI 中硬编码的列表。当满足以下所有条件时，模型会出现在切换器中：
  1. 提供商包已安装。每个提供商（例如 langchain-anthropic、langchain-openai）必须与 deepagents-cli 一起安装——可以作为安装附加项（例如 uv tool install 'deepagents-cli[ollama]'）或稍后使用 uv tool install deepagents-cli --with <package> 添加。如果缺少某个包，则其整个提供商部分将不会出现在切换器中。
  2. 模型具有一个包含 tool_calling 功能的配置文件。CLI 需要工具调用支持，因此没有在配置文件中设置 tool_calling: true 的模型会被排除。这是模型从列表中缺失的最常见原因。对于不捆绑配置文件的提供商（请参阅提供商参考表），您可以在 config.toml 中定义一个。 
    [models.providers.ollama.profile."qwen3:4b"]
tool_calling = true
max_input_tokens = 32768
max_output_tokens = 8192
    这并非模型出现在切换器中的严格要求——将其添加到models 列表也有效，并且更简单。当您希望 CLI 了解模型的上下文窗口和自动摘要等功能时，配置文件会很有用。请参阅配置文件覆盖了解所有可覆盖的字段。
  3. 模型接受并生成文本。其配置文件明确将 text_inputs 或 text_outputs 设置为 false（例如嵌入或图像生成模型）的模型将被排除。
在 config.toml 中 [models.providers.<name>].models 下定义的模型会绕过配置文件过滤器——它们始终会出现在切换器中，无论配置文件元数据如何。这是添加列表中缺失模型的推荐方法。
凭据状态不影响模型是否列出。切换器会显示所有符合条件的模型，并在每个提供商标题旁边显示一个凭据指示器：已确认凭据显示勾选标记，缺少凭据显示警告，凭据状态未知显示问号。您仍然可以选择缺少凭据的模型——提供商会在请求时报告身份验证错误。

​
缺失模型故障排除

症状可能原因解决方法
切换器中缺少整个提供商提供商包未安装安装包（例如 uv tool install deepagents-cli --with langchain-groq）
提供商已显示但特定模型缺失模型配置文件中 tool_calling: false 或不存在配置文件将模型添加到 config.toml 的 [models.providers.<name>].models 中，或者直接使用 /model <provider>:<model> 命令
提供商显示 ⚠“缺少凭据”API 密钥环境变量未设置根据提供商参考表设置凭据环境变量
提供商显示 ?“凭据未知”提供商使用 CLI 无法验证的非标准身份验证方式凭据可能仍然有效——尝试切换到该模型。如果身份验证失败，请查阅提供商的文档

​
设置默认模型

您可以设置一个持久的默认模型，该模型将用于所有未来的 CLI 启动
  • 通过模型选择器：打开 /model，导航到所需模型，然后按 Ctrl+S 以将其设为默认。再次按下 Ctrl+S 清除当前默认值。
  • 通过命令：/model --default provider:model（例如，/model --default anthropic:claude-opus-4-6）
  • 通过配置文件：在 ~/.deepagents/config.toml 中设置 [models].default（请参阅配置）。
  • 从 Shell 
    deepagents --default-model anthropic:claude-opus-4-6
查看当前默认值 
deepagents --default-model
清除默认值
  • 从 Shell 
    deepagents --clear-default-model
  • 通过命令：/model --default --clear
  • 通过模型选择器：在当前已固定的默认模型上按 Ctrl+S。
如果没有设置默认值，CLI 将默认为最近使用的模型。

​
模型参数

将额外的构造函数关键字参数传递给模型——包括采样控制、推理/思考预算、上下文窗口大小、请求超时以及底层聊天模型类接受的任何其他参数。有三个地方可以设置它们，按优先级排序（最高优先级在前）：
  1. 启动时一次性设置，使用 --model-params。JSON 字符串，仅限当前会话 
    # OpenAI reasoning effort
deepagents --model openai:gpt-5.5 --model-params '{"reasoning": {"effort": "high"}}'

# Anthropic extended thinking
deepagents --model anthropic:claude-opus-4-7 --model-params '{"thinking": {"type": "enabled", "budget_tokens": 10000}, "max_tokens": 16000}'
  2. 会话期间通过 /model --model-params。相同的 JSON 语法——无需重启即可切换参数（以及可选地切换模型） 
    /model --model-params '{"temperature": 0.7}' anthropic:claude-opus-4-7
/model --model-params '{"num_ctx": 16384}'           # opens selector, applies params to choice
  3. 持久化在 config.toml 中。提供商级别的默认值（可选地带有每个模型的子表），在每次启动时应用 
    [models.providers.anthropic.params]
thinking = { type = "enabled", budget_tokens = 10000 }
max_tokens = 16000

[models.providers.openai.params]
reasoning = { effort = "high", summary = "auto" }
output_version = "responses/v1"

[models.providers.ollama.params]
num_ctx = 16384
temperature = 0

# Per-model override—wins over provider-level keys
[models.providers.ollama.params."qwen3:4b"]
temperature = 0.5
CLI 标志会覆盖配置文件中的 params，并且仅限于当前会话（会话中的更改不会持久保存）。config.toml 中的每个模型子表会覆盖提供商级别的键（浅合并——请参阅模型构造函数参数了解完整语义）。--model-params 不能与 --default 结合使用。
底层聊天模型构造函数接受的任何关键字参数都有效。请查阅提供商的参考文档以获取完整列表——例如ChatAnthropic、ChatOpenAI、ChatOllama。未知关键字参数会转发到上游 API 请求，因此新发布的参数无需 CLI 更新即可工作。
不要将凭据（api_key）放入 params 中——请使用api_key_env指向环境变量。
要覆盖模型运行时配置文件（max_input_tokens、tool_calling、能力标志）中的字段——这与构造函数参数不同——请参阅配置文件覆盖。

​
高级配置

有关提供商参数、配置文件覆盖、自定义基础 URL、兼容 API、任意提供商和生命周期钩子的详细配置，请参阅配置。
将这些文档连接到 Claude、VSCode 等，以获得实时答案。
在 GitHub 上编辑此页面或提交问题。
© . This site is unofficial and not affiliated with LangChain, Inc.