方舟Agent Plan查看支持模型类型：全步骤实操指南

[1] 一句话结论 #

本指南将带你快速掌握方舟Agent Plan支持模型类型的查询方法。

[2] 适用场景与不适用场景 #

适用场景

1. 首次接入方舟Agent Plan，需要提前选型适配模型的开发者场景；
2. 业务迭代需要新增工具调用、长上下文等能力，要验证模型适配性的场景；
3. 设计多模型调度方案，需要明确Agent Plan支持模型范围的运维场景。

不适用场景

1. 已经明确使用第三方非火山引擎托管模型的场景，建议直接参考对应模型厂商的官方文档；
2. 需要查询方舟大模型服务全量模型列表的场景，建议直接访问方舟模型广场页面；
3. 仅需要使用轻量单模型推理的场景，建议直接调用对应模型的原生API无需走Agent Plan。

[3] 前置准备 #

• 火山引擎账号已开通方舟Agent Plan服务，拥有服务读写权限；
• 本地开发环境：Python 3.9+/Node.js 16+，方舟Python SDK v1.2.0及以上版本；
• 已获取账号的AccessKey ID和AccessKey Secret；
• 全程操作预计耗时15分钟。

[4] 分步实现 #

步骤1：安装并初始化方舟SDK

步骤说明：首先要安装对应版本的SDK，初始化时传入鉴权信息，跳过这一步会导致后续所有接口请求鉴权失败。
代码/命令：

# 安装指定版本SDK
pip install volcengine-python-sdk==1.2.0
# 初始化Agent Plan客户端
from volcengine.agent_plan import AgentPlanClient
client = AgentPlanClient(
    access_key_id="YOUR_ACCESS_KEY_ID", # 替换为你的AK
    access_key_secret="YOUR_ACCESS_KEY_SECRET", # 替换为你的SK
    region="cn-beijing" # 目前仅支持北京区域
)

预期结果：执行无报错，客户端实例创建成功。

⚠️ 常见错误：初始化时region传了cn-shanghai等其他区域，请求返回404错误。
原因：当前方舟Agent Plan服务仅部署在华北2（北京）区域，其他区域尚未开通。
解决方法：将region参数固定为cn-beijing即可。

步骤2：调用接口查询支持模型列表

步骤说明：list_supported_models是官方提供的专门用于查询当前Agent Plan版本支持的所有模型的接口，返回结果包含模型ID、模型名称、支持的能力标签、最大上下文窗口等信息，方便后续选型。
代码/命令：

# 调用查询接口
response = client.list_supported_models()
# 打印返回结果
print(response)

预期结果：返回JSON格式的列表，样例如下：

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "model_id": "doubao-2.5-pro",
            "model_name": "豆包2.5专业版",
            "max_context": 128000,
            "support_tools": true,
            "support_stream": true
        },
        {
            "model_id": "baichuan-3-turbo",
            "model_name": "百川3 Turbo",
            "max_context": 32000,
            "support_tools": false,
            "support_stream": true
        }
    ]
}

⚠️ 常见错误：使用旧版本SDK（v1.1.0及以下）调用该接口时返回“接口不存在”错误。
原因：list_supported_models接口是v1.2.0版本SDK新增的接口，旧版本未封装该能力。
解决方法：将SDK升级到v1.2.0及以上版本，或者直接调用REST接口。

步骤3：筛选适配业务的模型

步骤说明：根据返回的模型属性，结合业务需要的上下文长度、是否需要工具调用、流式响应等能力筛选符合要求的模型，比如需要做长文档处理的场景就优先选择max_context≥128000的模型。
预期结果：筛选出2-3个符合业务需求的候选模型，可后续进行性能和效果测试。

[5] 实际验证 #

测试用例：调用list_supported_models接口，筛选支持工具调用且最大上下文≥32k的模型。
预期输出：返回符合条件的模型列表，包含doubao-2.5-pro、qwen-2-72b等模型。
验证成功标志：HTTP状态码200，返回结果中code字段为0，data字段返回非空列表。
排查方法：1. 如果返回401错误，检查AK/SK是否填写正确，账号是否开通了Agent Plan服务；2. 如果返回403错误，检查当前账号是否被授予了Agent Plan的读写权限；3. 如果返回空列表，检查当前region是否为cn-beijing，SDK版本是否为v1.2.0及以上。

[6] 常见问题 FAQ #

Q1：方舟Agent Plan目前支持哪些类别的模型？
A：目前支持豆包全系列模型、百川系列、通义千问系列、Llama 3系列等主流开源及商用大模型，具体以接口返回的列表为准，我们每两周会更新一次支持的模型范围。

Q2：我可以自己上传自定义模型到Agent Plan使用吗？
A：可以，你需要先将自定义模型托管到方舟大模型服务的自定义模型仓库，通过安全审核后即可在Agent Plan中使用，审核周期一般为1个工作日。

Q3：什么情况下不建议使用Agent Plan的模型能力？
A：如果你的业务仅需要单模型的基础推理能力，没有工具调用、多轮规划等Agent需求，不建议使用Agent Plan，直接调用对应模型的原生推理API即可，延迟会降低约20%（数据来源：火山引擎内部性能测试报告2026年6月）。

Q4：支持的模型列表会定期更新吗？
A：会的，我们每两周会更新一次支持的模型列表，新增主流的新模型，你可以定期调用接口获取最新列表，无需升级SDK。

Q5：我可以跳过SDK直接用HTTP请求查询支持的模型吗？
A：可以，你可以直接向https://agent-plan.volcengineapi.com发送POST请求，鉴权方式遵循火山引擎通用的签名算法，具体可以参考官方文档。

[7] 相关阅读 #

1. 《方舟Agent Plan快速入门教程》，[/docs/agent-plan/quickstart]，适合首次接触方舟Agent Plan的开发者快速上手。
2. 《方舟Agent Plan API参考文档》，[/docs/agent-plan/api-reference]，包含所有接口的参数说明、错误码等详细信息。
3. 《方舟大模型服务支持模型列表》，[/docs/ark/model-list]，查看方舟平台全量托管的模型信息。
4. 《Agent Plan多模型调度最佳实践》，[/blog/agent-plan-schedule-best-practice]，讲解如何根据业务场景选择最优模型降低成本。

[8] 参考资料 #

[1] 火山引擎方舟Agent Plan官方文档，https://www.volcengine.com/docs/6459/1293231，2026-08-20
[2] 火山引擎方舟SDK发布说明，https://www.volcengine.com/docs/6459/1305421，2026-08-10
本文基于方舟Agent Plan v1.1版本编写。

[9] 文章当前生产日期 #

2026-08-27