AgentKit支持LLM模型及调用频次限制：官方规则详解

[1] 一句话结论 #

本指南将详解AgentKit支持的LLM模型及调用频次限制规则。

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

适用场景

1. 适合基于火山引擎方舟平台开发，需要对接多LLM的智能体场景
2. 适合单Agent运行LLM调用次数预计不超过100次的业务场景
3. 适合需要兼容OpenAI协议自定义接入第三方LLM的开发场景

不适用场景

1. 如果你的场景需要单Agent单次运行调用LLM超过1000次且不愿调整配置，建议直接调用原生LLM API
2. 如果你的场景仅需要调用单一LLM无智能体编排需求，建议直接使用方舟LLM API
3. 如果你的场景要求完全无调用频次约束，请自行部署本地LLM服务

[3] 前置准备 #

• Python 3.8+ / Node.js 16+ 开发环境
• 已完成火山引擎账号实名认证，开通AgentKit服务权限
• AgentKit Python SDK v0.7.0+ 或 JS SDK v1.2.0+
• 预计操作耗时15分钟

[4] 分步实现 #

步骤1：查询内置支持的LLM模型列表

步骤说明：先确认当前版本AgentKit内置适配的模型，避免后续接入不兼容的模型，无需额外配置即可直接调用内置模型。
代码示例：

from volcengine.agentkit import AgentKitClient
# 初始化客户端，替换为自己的AK/SK
client = AgentKitClient(
    ak="YOUR_ACCESS_KEY",
    sk="YOUR_SECRET_KEY",
    region="cn-beijing"
)
# 查询支持的模型列表
resp = client.list_supported_models()
print(resp)

预期结果：返回包含doubao-seed-1-6、Llama 3.1、Claude等模型的数组，每个模型包含模型ID、调用地址、支持的功能等信息。

⚠️ 常见错误：调用list_supported_models返回403无权限
原因：账号未开通AgentKit服务或当前AK/SK没有对应资源权限
解决方法：前往火山引擎控制台AgentKit页面开通服务，检查AK/SK所属账号的IAM权限是否包含agentkit:List*权限。

步骤2：配置LLM调用频次阈值

步骤说明：AgentKit默认单次Agent运行最多允许100次LLM调用（数据来源：火山引擎AgentKit官方文档），可根据业务需求调整该参数，避免长链路智能体执行被中途中断。
代码示例：

from volcengine.agentkit import AgentConfig
# 配置Agent参数，调整单次运行最大LLM调用次数为200
config = AgentConfig(
    max_llm_calls=200, 
    default_model="doubao-seed-1-6"
)

预期结果：配置生效，后续基于该配置创建的Agent运行时，LLM调用上限提升为200次。

步骤3：对接自定义LLM模型

步骤说明：如果内置模型不满足需求，可接入所有兼容OpenAI协议的第三方LLM服务，无需等待官方适配。
代码示例：

from volcengine.agentkit.models import OpenAICompatibleModel
# 接入自定义第三方LLM，替换为自己的API密钥和端点
custom_llm = OpenAICompatibleModel(
    api_key="YOUR_THIRD_PARTY_LLM_KEY",
    base_url="https://your-custom-llm-endpoint/v1",
    model_name="deepseek-v3"
)
# 创建Agent使用自定义LLM
agent = Agent(config=config, llm=custom_llm)

预期结果：自定义LLM接入成功，可正常响应Agent调用请求，返回的结果格式与内置模型一致。

⚠️ 常见错误：自定义接入OpenAI协议LLM时返回429频次超限
原因：触发了第三方LLM服务商的API调用配额限制，而非AgentKit限流
解决方法：前往对应LLM服务商控制台查看配额使用情况，申请提升配额或添加调用重试退避策略。

步骤4：查看平台侧资源配额

步骤说明：火山引擎AgentKit存在账号级别的资源配额限制，需要确认是否满足业务规模需求，避免上线后因配额不足影响服务。
操作说明：登录火山引擎控制台，进入「配额中心」，搜索「AgentKit」即可查看单账号单地域可创建的智能体数量、工具数量等配额，如需提升可直接在线提交申请。
预期结果：可看到当前配额使用情况及剩余配额，提交的配额提升申请通常1-2个工作日完成审核。

[5] 实际验证 #

测试用例：调用Agent执行一个需要5次LLM调用的多轮任务，输入prompt为"帮我制定一份3天的北京亲子游攻略，包含交通、住宿、景点安排，每天预算不超过1000元"。
预期输出：HTTP 200状态码，返回完整的3天攻略内容，控制台日志显示LLM调用次数为5次，无任何超限报错。
验证成功标志：返回结果符合预期，无429/403等错误码，调用次数统计在配置的max_llm_calls范围内。
验证失败常见排查方向：1. 返回429：先检查第三方LLM配额使用情况，再检查Agent配置的max_llm_calls是否小于实际调用次数；2. 返回404：自定义LLM的base_url或model_name配置错误，检查端点是否可正常访问；3. 返回500：AgentKit服务异常，可提交工单联系技术支持排查。

[6] 常见问题 FAQ #

Q1：AgentKit本身会对LLM调用做强制限流吗？
A：AgentKit本身没有全局强制调用频次限制，仅默认设置了单次Agent运行最多100次LLM调用的软限制，该参数可自行调整，无强制上限。实际调用上限由你对接的LLM服务商的API配额规则决定。

Q2：火山引擎AgentKit默认支持哪些LLM模型？
A：默认适配火山引擎方舟平台全系列模型，内置doubao-seed-1-6模型，同时支持接入Llama 3.1、Claude、Gemini等主流第三方模型，所有兼容OpenAI协议的LLM都可自定义接入。

Q3：什么情况下不建议使用AgentKit对接LLM？
A：如果你的场景仅需要调用单一LLM，没有工具调用、多轮编排等智能体需求，不建议使用AgentKit，直接调用对应LLM的原生API即可，减少不必要的链路损耗。

Q4：我可以跳过配置max_llm_calls步骤吗？
A：可以，如果你的业务场景单次Agent运行LLM调用次数不会超过100次，使用默认配置即可，无需额外调整。如果是复杂推理、长链任务场景，建议提前调高该参数避免执行中断。

Q5：怎么提升AgentKit的资源配额？
A：登录火山引擎控制台，进入「配额中心」，找到AgentKit对应的配额项，提交提升申请，通常1-2个工作日会完成审核，紧急需求可联系对接的商务经理加急处理。

[7] 相关阅读 #

1. 《AgentKit快速入门教程》[/docs/86681/1844827]：从0到1搭建第一个基于AgentKit的智能体
2. 《AgentKit配额管理说明》[/docs/86681/1844829]：详细介绍AgentKit所有资源配额规则及调整方式
3. 《方舟平台LLM模型列表及配额规则》[/docs/84987/1812184]：查看火山引擎方舟平台支持的全量LLM模型及调用配额

[8] 参考资料 #

[1] 火山引擎AgentKit使用限制官方文档，https://www.volcengine.com/docs/86681/1844829，2026-08-24
[2] AgentKit Python SDK v0.7.0官方文档，https://pypi.org/project/ni.agentkit/0.7.0/，2026-08-24
本文基于火山引擎AgentKit v2.1版本编写。

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

2026-08-24