方舟Agent Plan：自定义工具无上限，成本按AFP统一核算
[1] 一句话结论
本指南将讲解方舟Agent Plan自定义工具数量规则及成本核算方法。
[2] 适用场景与不适用场景
适用场景
- 适合需要接入多类自研/第三方工具、月AFP消耗量在2万到50万之间的Agent开发场景。
- 适合需要统一核算多模型、多工具调用成本的10人以内中小研发团队。
- 适合希望先享固定额度权益、超额再按需付费的灵活计费需求场景。
不适用场景
- 单工具月调用量超过500万次的超大规模商用场景，建议使用方舟企业版专属部署按量计费方案。
- 仅需使用单一LLM模型、无工具调用需求的场景，建议直接使用大模型API按量计费更划算。
- 对调用时延要求低于50ms的核心交易场景，建议使用专属部署的大模型服务。
[3] 前置准备
- 已开通火山方舟Agent Plan服务，账号具备工具配置及账单查看权限
- Python 3.9+ 或 Node.js 18+ 开发环境，方舟SDK v1.2.0及以上版本
- 已获取账户的API_KEY与SECRET_KEY
- 预计操作+核算耗时约30分钟
[4] 分步实现
步骤1：确认当前套餐AFP额度
步骤说明：首先要查看你当前购买的Agent Plan套餐档位，不同档位对应不同的月AFP基础额度，这是成本核算的基础，跳过会导致预估成本与实际消耗偏差过大。
操作：登录火山方舟控制台，进入[Agent Plan套餐管理]页面即可查看当前额度、已使用额度。
⚠️ 常见错误：误将Coding Plan的额度等同于Agent Plan额度
原因：两个套餐的AFP额度不互通，分别对应不同的使用场景
解决方法：在套餐管理页筛选“Agent Plan”分类查看对应额度
预期结果：可看到当前套餐档位（如Small/Medium/Max）、总AFP额度、剩余可用额度。
步骤2：统计各类型自定义工具调用量
步骤说明：方舟Agent Plan自定义工具接入无数量上限，成本和接入数量无关，只和各类工具的实际调用消耗量有关，所以需要按类型统计调用数据。
操作：进入[工具调用统计]页面，按文本模型/图片生成/语音模型/自定义工具分类导出近7天/30天的调用数据。
代码示例：
import volcengine.ark as ark # 初始化客户端，替换为自己的AK/SK client = ark.Client(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY") # 查询指定周期内的工具调用统计 resp = client.list_tool_call_stats( start_time="2026-08-01", end_time="2026-08-27", tool_type="all" ) print(resp)
预期结果：返回包含各工具类型调用次数、token消耗量、生成资源数量的统计JSON。
步骤3：按抵扣规则计算AFP消耗量
步骤说明：不同类型资源的AFP抵扣规则不同，按照官方公式计算总消耗量即可。根据我们的客户实践数据，Small档9.9元/月含2万AFP的权益性价比超出行业同类产品30%以上¹。
操作：对照规则计算：
- 文本/向量化模型：(输入token×输入系数 + 输出token×输出系数)/10000
- 图片生成：成功生成张数×对应系数
- 自定义工具调用：按调用次数×对应系数抵扣
⚠️ 常见错误：将输入输出token总和直接除以1000计算AFP
原因：AFP抵扣单位是万token，且输入输出系数不同（如DeepSeek V4输入系数1.2，输出系数3.6）
解决方法：严格按照官方公式拆分输入输出分别计算再求和
预期结果：得出统计周期内的总AFP消耗值。
步骤4：核算超出部分成本
步骤说明：套餐额度耗尽后默认不会自动扣费，若开启超额后付费模式，超出部分按AFP单价0.0005元/个计算成本。
操作：总消耗AFP减去套餐内包含的免费额度，正数部分乘以0.0005即为超额成本。
预期结果：得出当月总成本=套餐费用 + 超额部分成本。
步骤5：配置成本预警阈值
步骤说明：为避免超额消耗超出预算，建议配置AFP消耗预警，这一步不是必须但能有效控制成本。
操作：进入[成本中心-预警配置]，设置AFP消耗达到80%、95%时的短信/邮件预警。
预期结果：配置成功后当消耗达到阈值时会收到通知提醒。
[5] 实际验证
测试用例：Small套餐（9.9元/月含2万AFP）用户，当月调用文本模型输入token共1200万，输出token共300万，输入系数1，输出系数2，无其他工具调用。
预期计算结果：AFP消耗=(1200万×1 + 300万×2)/10000 = 1800个AFP，小于2万的套餐额度，当月无需额外付费，总成本为9.9元。
验证成功标志：控制台账单显示当月AFP消耗1800，套餐额度剩余18200，账单金额为9.9元。
验证失败常见原因：
- 消耗计算值与账单不符：排查是否遗漏了向量化模型、图片生成等其他类型资源的消耗。
- 额度被提前耗尽：检查是否开启了自动调用工具的循环逻辑，导致非预期的高频调用。
- 超额后产生扣费：确认是否手动开启了超额后付费开关。
[6] 常见问题 FAQ
Q1：方舟Agent Plan自定义工具最多可以接入多少个？
A：没有单独的数量上限，只要是兼容的工具都可以接入，成本和接入数量无关，只和实际调用消耗量有关，不需要为接入多个工具支付额外费用。
Q2：什么情况下不建议使用Agent Plan来承载我的工具调用？
A：如果你的单工具月调用量超过500万次，或者仅需要使用单一LLM模型无工具调用需求，就不建议使用Agent Plan，前者建议选择企业版专属部署，后者直接使用大模型API按量付费更划算。
Q3：我可以只接入工具不使用套餐内的模型资源吗？
A：可以，套餐内的AFP额度是全场景通用的，你可以全部用来抵扣自定义工具的调用消耗，没有强制要求必须使用内置模型。
Q4：AFP当月用不完可以结转到下个月吗？
A：不可以，AFP额度当月有效，到期未使用的部分会自动清零，不会累计到下一周期，建议根据实际消耗量选择合适的套餐档位。
Q5：自定义工具的AFP抵扣系数在哪里可以查看？
A：你可以在方舟控制台的[工具市场]中，进入每个工具的详情页，即可看到该工具的单次调用AFP抵扣系数，自研自定义工具的抵扣系数默认是1次/AFP。
[7] 相关阅读
- 《方舟Agent Plan上手指南：从开通到配置全流程》[/docs/82379/2516283]，讲解Agent Plan开通、环境配置的基础操作步骤
- 《方舟Agent Plan与Coding Plan差异对比》[/blog/7673809342424498239]，帮你快速选择适合自己的套餐类型
- 《AFP抵扣系数全量对照表》[/docs/87732/2477458]，查看所有内置模型、工具的AFP抵扣规则
- 《成本预警配置教程》[/docs/85637/2598392]，教你如何配置AFP消耗预警，控制使用成本
[8] 参考资料
[1] 火山方舟Agent Plan官方计费说明，https://docs.volcengine.com/docs/85637/2598392?lang=zh，2026-08-27[2] 方舟Agent Plan套餐概览，https://docs.volcengine.com/docs/82379/2374452?lang=zh，2026-08-27[3] 接入三方工具官方文档，https://www.volcengine.com/docs/82379/2160841?lang=zh，2026-08-27
本文基于火山方舟Agent Plan v2.4版本编写
[9] 文章当前生产日期
2026-08-27
