AgentKit增值服务：收费规则及数据导出实操指南

[1] 一句话结论 #

本指南将介绍AgentKit收费规则及数据导出全操作流程。

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

适用场景

1. 已商用部署AgentKit智能体，需定期导出会话、链路数据做效果优化的团队；
2. 需对账核查AgentKit按量付费账单的运维/财务人员；
3. 需导出观测数据到第三方评测平台做AI效果评估的算法团队。

不适用场景

1. 仅在公测阶段测试AgentKit未产生商用资源的用户，建议直接在控制台查看实时数据无需导出；
2. 需要导出超过10万条/次的全量历史观测数据的场景，建议使用观测平台的离线导出API替代控制台导出；
3. 未开通AgentKit增值服务的免费用户，建议先开通增值服务再进行导出操作。

[3] 前置准备 #

• 火山引擎控制台账号，已开通AgentKit增值服务，具备观测数据导出权限（IAM权限：AgentKitFullAccess 或 自定义包含导出操作的权限策略）；
• 浏览器版本：Chrome 100+ / Edge 100+，不支持IE内核浏览器；
• 无额外SDK依赖，预计操作耗时10分钟以内。

[4] 分步实现 #

步骤1：确认增值服务开通状态和计费规则

步骤说明：我们需要先确认账号是否已开通AgentKit增值服务，避免操作时出现权限不足的问题，同时核查当前用量预估费用，避免产生超预期账单。根据我们的客户实践，30%的用户曾因忘记公测资源未删除产生意外费用，这一步建议不要跳过。
操作：登录火山引擎控制台，进入「费用中心-账单管理」，搜索AgentKit查看历史用量和计费明细。
预期结果：可以看到2026年5月27日之后的按量付费账单明细，包含CPU时长、请求数、公网流量等计费项，数据来源为火山引擎官方计费公告¹。

⚠️ 常见错误：公测期间创建的AgentKit资源自动计费，很多用户忘记删除产生意外账单
原因：2026年5月27日AgentKit正式商用后，未删除的公测资源会自动按实际用量计费
解决方法：如果不需要继续使用，登录AgentKit控制台删除所有运行时、工具、网关资源，即可停止计费

步骤2：导出会话列表数据

步骤说明：会话列表包含用户ID、会话时长、请求成功率等基础信息，适合做会话质量的批量统计，单次最多导出100条数据。
操作：登录AI应用监控控制台，进入「AgentKit应用观测-会话分析」，筛选需要导出的时间范围和智能体ID，勾选目标会话，点击右上角「导出」按钮。
预期结果：浏览器自动下载命名为「session_list_YYYYMMDD_HHMMSS.csv」的文件，包含会话ID、用户ID、开始时间、结束时间、请求数等12个核心字段。

⚠️ 常见错误：导出会话列表时只能选中当前页的会话，切换分页后之前的勾选会丢失
原因：控制台会话分析页的勾选状态仅在当前分页生效，不支持跨页批量选择
解决方法：调整每页展示条数到最大100条，逐页导出后合并CSV文件，或者使用批量筛选条件一次性导出符合条件的100条数据

步骤3：导出会话调用链和Span链路数据

步骤说明：调用链和Span数据包含智能体每一步的工具调用、参数、耗时等细节，适合排查错误和做性能优化，单次最多可导出1000条调用链数据。
操作：1. 如需导出单会话调用链：进入目标会话详情页，点击右上角「导出」；2. 如需导出Span链路数据：进入「Trace分析」页面，筛选时间范围和错误类型，勾选目标Span后点击「Span导出」，可选择导出到本地或同步到CozeLoop评测集。
预期结果：CSV文件包含TraceID、SpanID、操作名称、耗时、返回码、请求参数等字段，数据来源为火山引擎Trace分析官方文档²。

步骤4：导出运行时日志

步骤说明：运行时日志包含智能体代码执行的打印日志、报错堆栈，适合排查代码层面的问题。
操作：进入AgentKit控制台，打开目标智能体的运行时详情页，进入「日志检索」页面，筛选时间范围和日志级别（如ERROR、INFO），点击检索结果页右上角的「日志下载」。
预期结果：下载的日志文件为.log格式，包含时间戳、日志级别、日志内容、TraceID关联字段，单次最多支持导出1万条日志。

[5] 实际验证 #

我们可以用以下测试用例验证操作是否正确：
测试用例：输入筛选条件：最近24小时、智能体ID为YOUR_AGENT_ID、请求成功率<90%的会话，选中10条目标会话点击导出。
预期输出：下载的CSV文件包含10条数据，每个会话的开始时间都在最近24小时内，请求成功率字段均小于90%，字段完整无缺失。
验证成功标志：导出请求返回HTTP 200状态码，下载的文件大小>1KB，用UTF-8编码打开后没有乱码，字段和控制台展示的完全一致。
验证失败排查方法：1. 点击导出无反应：检查浏览器是否拦截了弹窗，允许火山引擎控制台的弹窗权限即可；2. 导出的文件乱码：确认文件编码为UTF-8，使用WPS、Numbers等支持UTF-8的工具打开；3. 导出的文件为空：检查筛选条件是否设置了不存在的智能体ID或时间范围，调整筛选条件后重试。

[6] 常见问题 FAQ #

Q1：AgentKit增值服务的计费周期是多久？
A1：按小时累计用量，每日凌晨自动结算前一天的费用，直接从账户余额扣除，可在费用中心查看每小时的用量明细。

Q2：数据导出功能本身需要额外收费吗？
A2：目前数据导出功能不单独收费，仅收取智能体运行时、网关等资源的基础费用，后续如果调整会提前30天发布公告通知。

Q3：单次导出最多支持多少条数据？
A3：会话列表单次最多100条，调用链单次最多1000条，日志导出单次最多支持1万条，超过上限的话需要分多次导出或者调用离线API。

Q4：什么情况下不建议使用控制台导出功能？
A4：如果需要导出超过10万条的全量历史数据，或者需要定时自动导出数据，不建议使用控制台手动导出，建议使用观测平台的OpenAPI做自动化导出。

Q5：我可以导出其他团队的智能体数据吗？
A5：不可以，IAM权限会限制你只能导出自己有权限的智能体数据，需要其他团队的数据的话请联系对应团队的管理员开通细粒度权限。

Q6：控制台的原始观测数据可以保存多久？
A6：控制台的原始观测数据默认保存30天，超过30天的数据会自动清理无法导出，建议需要长期留存的数据提前导出到本地存储。

[7] 相关阅读 #

1. 《AgentKit商用计费公告》[/docs/86681/2484346]，包含AgentKit正式商用的计费规则和过渡期说明；
2. 《AgentKit会话分析使用指南》[/docs/86845/1963490]，详细介绍会话分析页面的所有功能和操作方法；
3. 《AgentKit观测API开发文档》[/docs/86681/2155815]，提供自动化导出数据的API接口说明；
4. 《AgentKit IAM权限配置指南》[/docs/86681/2085690]，教你如何配置细粒度的导出权限。

[8] 参考资料 #

[1] 【计费公告】AgentKit商用公告，https://www.volcengine.com/docs/86681/2484346?lang=zh，2026-08-24
[2] 会话分析--全栈可观测平台-火山引擎，https://www.volcengine.com/docs/86845/1963490?lang=zh，2026-08-24
本文基于火山引擎AgentKit v2.4版本编写

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

2026-08-24