跳到主要内容

文档索引

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

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

Deep Agents CLI 支持任何与 LangChain 兼容的聊天模型提供者,从而可以驱动几乎任何支持工具调用 (tool calling) 的大语言模型 (LLM)。任何提供 OpenAI 兼容或 Anthropic 兼容 API 的服务也可以开箱即用——请参阅 兼容的 API

快速开始

CLI 自动与以下模型提供者集成:除了安装相关的提供者包之外,无需额外配置。
  1. 安装提供者软件包 每个模型提供者都需要安装其对应的 LangChain 集成包。为了保持应用程序轻量化,这些包在安装 CLI 时作为可选的额外组件 (extras) 提供:
    # 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 中,以便在所有项目中使用,或者在终端中导出它们:
    ANTHROPIC_API_KEY=sk-ant-...
    OPENAI_API_KEY=sk-...
    
    一些提供者使用其他凭据(例如,Vertex AI 使用 GOOGLE_CLOUD_PROJECT 加 ADC)。有关每个提供者所需的变量,请参阅下表。你还可以使用 DEEPAGENTS_CLI_ 前缀将凭据的作用域限制在 CLI。

提供者参考

使用的提供者不在列表中?请参阅 任意提供者:通过额外设置,任何与 LangChain 兼容的提供者都可以在 CLI 中使用。
提供商凭据环境变量模型配置文件
OpenAIlangchain-openaiOPENAI_API_KEY
Azure OpenAIlangchain-openaiAZURE_OPENAI_API_KEY
Anthropiclangchain-anthropicANTHROPIC_API_KEY
Google Gemini APIlangchain-google-genaiGOOGLE_API_KEY
Google Vertex AIlangchain-google-genaiGOOGLE_CLOUD_PROJECT
Basetenlangchain-basetenBASETEN_API_KEY
AWS Bedrocklangchain-awsAWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
AWS Bedrock Converselangchain-awsAWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
Hugging Facelangchain-huggingfaceHUGGINGFACEHUB_API_TOKEN
Ollamalangchain-ollama可选
Groqlangchain-groqGROQ_API_KEY
Coherelangchain-cohereCOHERE_API_KEY
Fireworkslangchain-fireworksFIREWORKS_API_KEY
Togetherlangchain-togetherTOGETHER_API_KEY
Mistral AIlangchain-mistralaiMISTRAL_API_KEY
DeepSeeklangchain-deepseekDEEPSEEK_API_KEY
IBM (watsonx.ai)langchain-ibmWATSONX_APIKEY
Nvidialangchain-nvidia-ai-endpointsNVIDIA_API_KEY
xAIlangchain-xaiXAI_API_KEY
Perplexitylangchain-perplexityPPLX_API_KEY
OpenRouterlangchain-openrouterOPENROUTER_API_KEY
LiteLLMlangchain-litellm每个提供者(请参阅文档
你可以通过添加 DEEPAGENTS_CLI_ 前缀将任何凭据的作用域限制在 CLI。例如,在 CLI 内部,DEEPAGENTS_CLI_OPENAI_API_KEY 的优先级高于 OPENAI_API_KEY,且不会影响其他工具。详见 DEEPAGENTS_CLI_ 前缀
模型配置文件 (Model Profile) 是随提供者软件包一起交付的一组元数据(模型名称、默认参数、能力等),主要由 models.dev 项目驱动。包含模型配置文件的提供者会将其模型自动列在交互式 /model 切换器中,前提是符合 过滤标准(特别是必须启用 tool_calling)。不包含模型配置文件的提供者需要你直接指定模型名称或通过 config.toml 添加模型。

模型路由和代理

OpenRouterLiteLLM 这样的模型路由通过单一端点提供对多个提供者模型的访问。 请为这些服务使用专用的集成包:
Router配置
OpenRouterlangchain-openrouteropenrouter:<model> (内置,请参阅 提供者参考)
LiteLLMlangchain-litellmlitellm:<model> (内置,请参阅 提供者参考)
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. ~/.deepagents/config.toml 中的 [models].default —— 用户刻意的长期偏好。
  3. ~/.deepagents/config.toml 中的 [models].recent —— 上次通过 /model 切换到的模型。自动写入;永远不会覆盖 [models].default
  4. 环境变量自动检测:回退到第一个可用的启动凭据,按此顺序检查:OPENAI_API_KEYANTHROPIC_API_KEYGOOGLE_API_KEYGOOGLE_CLOUD_PROJECT (Vertex AI)。
这种启动回退策略有意只检查这四个凭据。其他受支持的提供者(例如 Groq)仍可通过 --model/model 和保存的默认值([models].default / [models].recent)使用。

哪些模型会出现在切换器中

/model 选择器会从安装的提供者软件包中动态构建其列表。展开下方内容查看完整标准和故障排除。
交互式 /model 选择器是动态构建列表的——它不是内置在 CLI 中的硬编码列表。当满足以下所有条件时,模型会出现在切换器中:
  1. 提供者软件包已安装。 每个提供者(例如 langchain-anthropic, langchain-openai)必须与 deepagents-cli 一起安装——可以作为安装额外项 (install extra)(例如 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_inputstext_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 (请参阅配置)。
  • 在终端中
    deepagents --default-model anthropic:claude-opus-4-6
    
查看当前默认模型
deepagents --default-model
清除默认模型
  • 在终端中
    deepagents --clear-default-model
    
  • 通过命令: /model --default --clear
  • 通过模型选择器: 在当前固定的默认模型上按 Ctrl+S
如果没有设置默认模型,CLI 将默认使用最近使用的模型。

模型参数

向模型传递额外的构造函数关键字参数 (kwargs)——采样控制、推理/思考预算、上下文窗口大小、请求超时以及底层聊天模型类接受的任何其他内容。有三个地方可以设置它们,按优先级排序(最高优先):
  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 指向环境变量。
若要覆盖模型运行时 配置文件 (profile) 上的字段(max_input_tokens, tool_calling, 能力标志)——这与构造函数参数不同——请参阅 配置文件覆盖

高级配置

有关提供者参数、配置文件覆盖、自定义基础 URL、兼容 API、任意提供者和生命周期钩子的详细配置,请参阅 配置
© . This site is unofficial and not affiliated with LangChain, Inc.