文档中心

火山方舟

定义 Agent

模型支持的参数列表

本文介绍方舟 Managed Agents 在定义 Agent 或创建 Session 时可配置的 thinking、reasoning_effort 和 service_tier 参数，并列出当前各模型对思考与服务档位参数的支持情况。

Managed Agents 会根据目标模型版本分别校验 thinking、reasoning_effort 和 service_tier。在创建 Agent、更新 Agent 或临时覆写 Session 模型参数前，应先确认目标模型版本是否支持对应取值。

注意

模型支持范围可能随模型版本发布而变化，各字段实际支持的取值和默认值以目标模型版本为准。调用时，如果传入当前模型不支持的取值，Managed Agents 会返回 400 InvalidParameter。

模型参数字段

字段	可选取值	说明
model.id	模型 ID 或推理接入点 ID	Agent 使用的模型或推理接入点。使用推理接入点 ID 时，Managed Agents 根据接入点关联的模型校验运行参数。
model.thinking	enabled、disabled、auto	思考开关，对应底层模型调用的 thinking.type 字段。auto 表示由模型判断是否思考，不表示继承。
model.reasoning_effort	none、minimal、low、medium、high、xhigh、max	推理投入档位，对应底层模型调用的 reasoning_effort 字段。不同模型支持的档位不同。
model.service_tier	auto、default、fast	推理服务档位，对应底层模型调用的 service_tier 字段。只有部分模型版本支持 fast 快速档位。

说明

创建或更新 Agent 时，model.id 支持模型 ID 和推理接入点 ID。创建 Session 时，agent_with_overrides.model.id 仅支持模型 ID；Dream 的 model 字段也仅支持模型 ID。如果基础 Agent 使用推理接入点，Session 响应中的模型快照仍会返回该推理接入点 ID。

默认值与校验规则

不设置 thinking、reasoning_effort 或 service_tier，或在 Agent 定义中传空字符串时，Managed Agents 会优先使用模型元数据中的默认值。

如果模型元数据未配置默认值，Managed Agents 不会向底层模型调用传递对应字段，由底层模型服务按默认策略处理。

注意

Seedance Managed Agent 不使用 reasoning_effort 的模型默认值。创建 Seedance Managed Agent 时，省略 reasoning_effort 会由服务端补齐为 high；显式填写时只能设置为 high，其他值会返回 400 InvalidParameter。从控制台的 Seedance Managed Agent 创建页面展示的模型中选择，并确认该模型支持 high。

支持模型与参数列表

表中取值后标注“默认”的值，表示该模型版本的默认值。

模型 ID	thinking	reasoning_effort	service_tier
doubao-seed-evolving	enabled（默认）、disabled	low、medium、high（默认）、minimal	auto、default（默认）
doubao-seed-2-1-pro-260915	enabled（默认）、disabled	low、medium、high（默认）、minimal	auto、default（默认）
doubao-seed-2-1-lite-260915	enabled（默认）、disabled	low、medium、high（默认）、minimal	auto、default（默认）
doubao-seed-2-1-pro-260628	enabled（默认）、disabled	low、medium、high（默认）、minimal	auto、default（默认）
doubao-seed-2-1-turbo-260628	enabled（默认）、disabled	low、medium、high（默认）、minimal	auto、default（默认）、fast
doubao-seed-2-0-lite-260428	enabled（默认）、disabled	low、medium（默认）、high、minimal	auto、default（默认）、fast
deepseek-v4-pro-260425	enabled（默认）、disabled	low、high（默认）、max、minimal	auto、default（默认）
deepseek-v4-pro-ga-260813	enabled（默认）、disabled	none、low、high（默认）、max、minimal	auto、default（默认）
deepseek-v4-flash-ga-260731	enabled（默认）、disabled	none、low、high（默认）、max、minimal	auto、default（默认）
glm-5-2-260617	enabled（默认）、disabled	none、minimal、high、max（默认）	auto、default（默认）

支持快速服务档位的模型

以下模型版本支持 service_tier: "fast"：

doubao-seed-2-1-turbo-260628

doubao-seed-2-0-lite-260428

其他模型版本当前支持 auto 和 default，默认值为 default。

注意

service_tier: "fast" 只表示请求快速服务档位，不改变模型本身的能力边界。配置快速档位前，应确认业务能够接受对应模型版本的能力边界和推理参数限制。

配置示例

创建 Agent 时，可以在 model 对象中显式配置支持的运行参数：

如果只希望使用模型默认策略，可以只设置 model.id。model.id 的取值可以是模型 ID 或推理接入点 ID；以下示例使用模型 ID：

最近更新时间：2026.11.03 15:22:53

这个页面对您有帮助吗？

有用

无用