AgentKit收费标准及额度提醒设置:2步完成超支预警
[1] 一句话结论
本指南将介绍火山引擎AgentKit收费规则及收费额度提醒的完整操作步骤。
[2] 适用场景与不适用场景
适用场景
- 基于AgentKit开发智能体应用,日均请求量1千次以上,需要长期运行实例的开发者;
- 对项目成本可控性有明确要求,需要实时监控消费情况的企业技术负责人;
- 同时使用多个火山引擎云服务,需要统一配置消费预警的运维人员。
不适用场景
- 仅做个人临时测试,单月预计消费不足10元的场景,建议直接在控制台手动查看消费即可,无需额外配置额度提醒;
- 已接入火山引擎企业级费用管控平台的大型组织,建议直接使用企业统一的费用管控模块替代单独配置;
- 仅使用AgentKit开源框架不使用火山引擎托管服务的场景,本文托管收费规则不适用,建议自行统计服务器资源成本。
[3] 前置准备
- 火山引擎账号已完成实名认证,拥有费用中心读写权限;
- 若使用SDK配置本地提醒,需安装hermes-agent-kit 0.3.7+版本;
- 开发环境要求Python 3.8+;
- 预计操作耗时:5分钟。
[4] 分步实现
步骤1:了解AgentKit收费规则
步骤说明:AgentKit自2026年5月27日正式商用后采用按量后付费模式,按小时累计用量自动从账户余额扣费,提前了解计费项可避免不必要的成本支出,跳过本步可能导致对消费构成不清晰,超支后无法定位费用来源。
核心计费项及刊例价(数据来源:火山引擎AgentKit官方计费文档):
| 计费类别 | 具体项 | 单价 |
|---|---|---|
| 资源类 | 运行时/工具/网关CPU | 0.000097375元/vCPU/秒 |
| 资源类 | 运行时/工具/网关内存 | 0.000015456元/GB/秒 |
| 流量类 | 各组件公网下行流量 | 0.8元/GB |
| 调用类 | 网关服务请求 | 0.025元/千次 |
| 调用类 | 网关工具集检索任务 | 0.125元/千次 |
| 计数类 | 网关工具索引 | 0.014元/万个/小时 |
⚠️ 常见错误:开通实例后即使没有请求也持续产生账单
原因:配置了最小实例数>0,实例会持续运行占用CPU和内存资源,无论是否有请求都会产生资源费用
解决方法:测试场景下将最小实例数设为0,无请求时自动缩容到0,不会产生闲置资源费用
预期结果:能准确估算自身场景的月度消费范围,明确各个计费项的占比。
步骤2:控制台配置全账户额度提醒
步骤说明:火山引擎费用中心的全局额度提醒对所有云服务生效,配置后只要消费达到阈值就会推送通知,适合全账户的成本管控,不需要针对每个产品单独配置。
操作流程:
- 登录火山引擎控制台,点击右上角头像进入「费用中心」页面;
- 在左侧菜单栏选择「费用预警」-「额度提醒设置」;
- 自定义设置账户余额阈值(比如设置为100元)、日/小时消费上限阈值(比如设置为50元/天),勾选短信、站内信、邮件等需要的通知方式;
- 点击「保存」按钮完成配置。
预期结果:保存后页面提示「额度提醒配置成功」,后续消费达到阈值时会收到对应渠道的通知。
步骤3:SDK配置AgentKit专属消费提醒
步骤说明:如果仅需要针对AgentKit项目单独设置提醒,不需要关联其他云服务的消费,可以通过SDK本地配置cost-tracker钩子实现,适合单个项目的独立成本管控。
操作流程:
- 打开配置文件
~/.hermes/hooks/cost-tracker/cost_tracker.yaml,没有则新建; - 填入以下配置内容:
# 消费预警阈值,单位为人民币元 alert_threshold_cny: 30 # 通知方式,支持console、webhook、邮件 notify_channels: ["console", "webhook"] # 飞书/企业微信机器人webhook地址,不需要可删除 webhook_url: "YOUR_WEBHOOK_URL"
- 启动AgentKit时添加开启成本追踪的参数:
hermes-agent start --enable-cost-tracker
⚠️ 常见错误:配置了本地提醒但没有收到通知
原因:cost-tracker钩子默认关闭,需要在启动参数中添加--enable-cost-tracker才会生效
解决方法:重启AgentKit进程,启动命令加上上述参数即可
预期结果:当AgentKit单月消费达到设定的阈值时,会在控制台打印预警信息,同时推送消息到配置的webhook地址。
步骤4:验证提醒配置有效性
步骤说明:配置完成后手动测试通知是否能正常触达,避免真的超支时才发现配置未生效,导致成本超出预期。
操作流程:
- 控制台配置的提醒:在额度提醒设置页面点击「测试通知」按钮;
- SDK本地配置的提醒:运行测试命令
hermes-agent cost-test --amount 40,模拟消费超过阈值的场景。
预期结果:1分钟内收到对应渠道的消费预警通知。
[5] 实际验证
测试用例:
输入:1. 控制台设置日消费阈值为1元;2. 启动1个1vCPU 1G内存的AgentKit实例,最小实例数设为1,运行2小时;3. 主动调用1000次网关请求。
预期输出:收到短信/站内信提醒「您的账户今日消费已超过1元阈值,请关注」,实际消费约0.9元(2小时资源费0.81元+1千次请求费0.025元,合计0.835元,加上其他小额费用接近1元阈值)。
验证成功标志:消费达到阈值后10分钟内收到对应渠道的通知,控制台费用中心的消费记录与实际计算金额误差小于5%。
常见排查方法:
- 未收到通知:首先检查通知方式是否勾选正确,预留的手机号/邮箱/ webhook地址是否配置正确;
- 通知金额与预期不符:检查是否包含了其他关联云服务的消费,比如日志服务、知识库存储费用,这些产品需单独计费;
- 本地提醒未触发:检查启动参数是否添加了
--enable-cost-tracker,配置文件中的阈值单位是否为人民币元。
[6] 常见问题 FAQ
Q1:AgentKit有没有免费额度?
A:2026年5月27日商用后,新用户首次开通可获得价值50元的免费资源包,有效期30天,到期后自动转为按量付费,没有长期免费额度。
Q2:我可以只配置AgentKit单独的额度提醒,不配置全账户的吗?
A:可以,通过hermes-agent-kit SDK的cost-tracker钩子配置即可,仅统计当前AgentKit实例的消费,不会关联其他云服务的费用。
Q3:什么情况下不建议配置额度提醒?
A:如果你的实例是临时测试使用,运行时长不超过24小时,且预计消费不足5元,不需要额外配置提醒,直接在控制台手动查看消费记录即可,配置反而增加冗余操作。
Q4:配置额度提醒后,达到阈值会自动停服吗?
A:不会,额度提醒仅推送通知,不会自动停止你的实例,如果需要超支自动停服,需要搭配费用中心的「超支自动关停」功能使用。
Q5:AgentKit的流量计费是双向的吗?
A:不是,仅收取公网下行流量费用,内网流量和公网上行流量均免费,该规则来自火山引擎AgentKit官方计费文档。
[7] 相关阅读
- 《AgentKit 计费方式官方说明》[/docs/86681/2480916],详细介绍所有计费项和结算规则;
- 《AgentKit SDK 安装与配置指南》[/docs/86681/2085691],包含SDK的完整安装和参数配置教程;
- 《火山引擎费用中心使用手册》[/docs/6589/108162],介绍费用预警、超支关停等更多成本管控功能;
- 《AgentKit 最佳实践:成本优化方案》[/blog/agentkit-cost-optimize],我们团队总结的5种降低AgentKit运行成本的实战方法。
[8] 参考资料
[1] 《计费方式--AgentKit-火山引擎》,https://www.volcengine.com/docs/86681/2480916?lang=zh,2026-08-24
[2] 《通用FAQ--AgentKit-火山引擎》,https://www.volcengine.com/docs/86681/2085690?lang=zh,2026-08-24
本文基于火山引擎AgentKit v2.0版本、hermes-agent-kit 0.3.7版本编写。
[9] 文章当前生产日期
2026-08-24

