本文介绍方舟 Managed Agents 在定义 Agent 或创建 Session 时可配置的 thinking、reasoning_effort 和 service_tier 参数,并列出当前各模型对思考与服务档位参数的支持情况。
Managed Agents 会根据目标模型版本分别校验 thinking、reasoning_effort 和 service_tier。在创建 Agent、更新 Agent 或临时覆写 Session 模型参数前,应先确认目标模型版本是否支持对应取值。
模型参数字段#
| 字段 | 可选取值 | 说明 |
|---|---|---|
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 快速档位。 |
默认值与校验规则#
- 不设置
thinking、reasoning_effort或service_tier,或在 Agent 定义中传空字符串时,Managed Agents 会优先使用模型元数据中的默认值。 - 如果模型元数据未配置默认值,Managed Agents 不会向底层模型调用传递对应字段,由底层模型服务按默认策略处理。
支持模型与参数列表#
表中取值后标注“默认”的值,表示该模型版本的默认值。
| 模型 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-260628doubao-seed-2-0-lite-260428
其他模型版本当前支持 auto 和 default,默认值为 default。
配置示例#
创建 Agent 时,可以在 model 对象中显式配置支持的运行参数:
{
"model": {
"id": "doubao-seed-2-1-turbo-260628",
"thinking": "enabled",
"reasoning_effort": "high",
"service_tier": "fast"
}
}
如果只希望使用模型默认策略,可以只设置 model.id。model.id 的取值可以是模型 ID 或推理接入点 ID;以下示例使用模型 ID:
{
"model": {
"id": "doubao-seed-2-1-turbo-260628"
}
}