模型管理

VeADK 默认基于 LiteLLM 构建模型客户端，因此支持 LiteLLM 的所有提供商。

参数	类型	默认值	说明
`model_name`	`str \| list[str]`	环境变量 `MODEL_AGENT_NAME`	模型名称。传入列表即开启容错：第一个为主模型，其余作为 fallback 依次重试。
`model_provider`	`str`	`MODEL_AGENT_PROVIDER`	模型提供商，如 `openai`。参见 LiteLLM 提供商列表。
`model_api_base`	`str`	`MODEL_AGENT_API_BASE`	模型 API 的 base URL。
`model_api_key`	`str`	`MODEL_AGENT_API_KEY`	模型 API Key。切勿硬编码，通过环境变量或 `config.yaml` 提供。
`model_extra_config`	`dict`	`{}`	透传给模型请求的额外配置，支持 `extra_headers` 与 `extra_body`，会与 VeADK 默认值合并。
`model`	`LiteLlm`	`None`	直接传入构造好的 LiteLLM 客户端。*一旦设置，上面的 `model_` 字段将被忽略**。
`enable_responses`	`bool`	`False`	启用方舟 Responses API，详见 Responses API 支持。
`enable_responses_cache`	`bool`	`True`	在 Responses API 下复用 `previous_response_id` 做多轮续接与缓存，仅在 `enable_responses=True` 时生效。
`context_cache_config`	`ContextCacheConfig`	`None`	上下文缓存配置，用于降低长上下文的重复计算成本。

使用不同模型

指定提供商或本地模型（API Key 仍通过环境变量提供）：

agent.py

agent = Agent(
    model_provider="openai",
    model_name="doubao-seed-1-8-251228",
    model_api_base="https://ark.cn-beijing.volces.com/api/v3/",
)

模型容错（Fallbacks）

将 model_name 传入列表即开启容错：按顺序优先尝试第一个模型，失败后依次尝试后续模型，直至成功。

agent.py

agent = Agent(model_name=["doubao-seed-1-8-251228", "deepseek-r1-250528"])

自定义模型客户端

如需高度自定义，直接传入一个 LiteLLM 客户端：

agent.py

from google.adk.models.lite_llm import LiteLlm

agent = Agent(model=LiteLlm(model="doubao-seed-1-8-251228"))

配置额外参数

根据方舟平台能力指定额外选项。例如关闭思考以获得更快响应：

agent.py

agent = Agent(
    model_name="doubao-seed-1-8-251228",
    model_extra_config={"extra_body": {"thinking": {"type": "disabled"}}},
)

模型管理

使用不同模型

模型容错（Fallbacks）

自定义模型客户端

配置额外参数

本页导航