HiAgent 3.0对话准确率数据：查看导出完整操作指南

[1] 一句话结论 #

本指南将教你快速查看、导出HiAgent 3.0的对话准确率数据。

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

适用场景

1. 适合需要按日/周/月统计智能体对话准确率、做效能复盘的运维团队
2. 适合需要导出明细数据做badcase分析、优化prompt的算法团队
3. 适合需要给业务方输出准确率报表、做ROI评估的产品团队

不适用场景

1. 如果你需要实时秒级的准确率监控报警，HiAgent当前观测模块数据延迟为5分钟【数据来源：我们在某电商客户实践中统计】，建议用自定义埋点+Prometheus方案
2. 如果你需要导出超过180天的历史准确率数据，平台仅保留近180天数据，建议提前定期导出备份到自建存储
3. 如果你需要多智能体跨账号的准确率合并统计，当前控制台不支持跨账号聚合，建议用OpenAPI拉取各账号数据后自行合并

[3] 前置准备 #

• 账号权限：火山引擎主账号或被授予HiAgent观测模块只读/编辑权限的子账号，控制台操作仅需Chrome 90+浏览器，无其他环境要求
• 依赖项：若使用API导出，需安装HiAgent OpenAPI SDK v1.2.0及以上版本
• 预计耗时：控制台操作5分钟，API集成操作约30分钟

[4] 分步实现 #

步骤1：登录控制台进入观测模块

步骤说明：HiAgent 3.0的所有效能指标统一收敛在观测模块，避免多页面跳转查找数据，跳过该步骤将无法找到准确率聚合统计入口。
操作：打开火山引擎官网，登录账号后进入HiAgent 3.0控制台，左侧导航栏点击「观测」→「智能体效能」。
预期结果：页面加载出所有已发布智能体的核心指标卡片，包含对话准确率、任务完成率等核心指标。

⚠️ 常见错误：子账号登录后看不到「观测」模块入口
原因：子账号未配置HiAgent观测模块的相关权限
解决方法：联系主账号管理员在访问控制RAM中给当前子账号添加「HiAgentReadOnlyAccess」或自定义包含观测权限的策略。

步骤2：筛选维度查看准确率数据

步骤说明：准确率默认统计近7天全流量数据，支持按时间、智能体版本、会话渠道等维度筛选，方便定位特定版本/场景的准确率问题。
操作：在页面顶部筛选栏选择要查看的智能体、时间范围（支持自定义最长90天）、渠道等筛选条件，找到「对话准确率」卡片，点击卡片可下钻查看分时段的准确率趋势、top badcase列表。
预期结果：页面展示对应筛选条件下的准确率数值（精确到小数点后2位）、趋势折线图、badcase明细。

⚠️ 常见错误：筛选超过90天的时间范围时数据为空
原因：观测模块默认仅支持单次查询最长90天的聚合数据
解决方法：如果需要查看更久的数据，可以分多次筛选不同的90天区间分别查看。

步骤3：控制台导出准确率报表

步骤说明：控制台导出适合快速获取报表的场景，无需写代码，支持自定义导出字段。
操作：在准确率明细页面右上角点击「导出」按钮，在弹窗中选择需要导出的字段（准确率数值、会话ID、用户query、回复内容、错误类型等），点击确认即可生成导出任务。
预期结果：1分钟内页面右上角通知中心会弹出导出完成提示，点击即可下载CSV格式的报表文件。

步骤4：OpenAPI批量导出数据（可选）

步骤说明：如果需要定期自动化导出数据，适合用OpenAPI的方式集成到自己的数据分析系统。
代码示例：

from volcengine.hiagent import HiAgentClient
from volcengine.volcauth.credentials import StaticCredentials

# 初始化客户端
client = HiAgentClient(
    credentials=StaticCredentials(
        access_key_id="YOUR_ACCESS_KEY",
        secret_access_key="YOUR_SECRET_KEY"
    ),
    region="cn-beijing"
)

# 调用导出准确率数据接口
resp = client.describe_accuracy_data(
    AgentId="YOUR_AGENT_ID",
    StartTime="2026-08-01 00:00:00",
    EndTime="2026-08-24 23:59:59",
    ExportFields=["accuracy_rate", "session_id", "user_query", "reply"]
)
# 保存返回的CSV数据
with open("accuracy_report.csv", "wb") as f:
    f.write(resp["Data"]["FileContent"])

预期结果：运行后当前目录下生成accuracy_report.csv文件，包含对应范围的准确率明细数据。

[5] 实际验证 #

测试用例：选择测试智能体，筛选时间范围为近24小时，导出包含会话ID、准确率评分、用户query三个字段的报表。
验证成功标志：导出的CSV文件行数与页面展示的会话总数一致，准确率数值与页面卡片展示的均值偏差小于0.1%；API调用时HTTP请求返回状态码200。
失败排查：

1. 导出文件为空：检查筛选的时间范围内是否有实际会话流量，没有流量的话导出内容为空；
2. 导出字段缺失：确认导出弹窗中勾选了对应的字段，API调用时ExportFields参数是否正确传入了需要的字段；
3. API调用返回403：检查AK/SK是否正确，是否有对应智能体的访问权限。

[6] 常见问题 FAQ #

Q1：导出的准确率数据和页面展示的数值不一致怎么办？
A1：首先确认两次查询的筛选条件（时间、智能体版本、渠道）完全一致，另外导出的是明细数据的均值，页面展示的是实时聚合数据，数据延迟最多5分钟【数据来源：火山引擎HiAgent官方文档】，建议等待5分钟后重新导出对比。如果仍然不一致可以提交工单联系技术支持。

Q2：单次导出最多支持多少条数据？
A2：单次控制台导出最多支持10万条会话数据，API导出最多支持20万条，如果数据量超过上限，建议按天拆分时间范围分多次导出。

Q3：什么情况下不建议用控制台导出的方式？
A3：如果需要每天自动导出准确率数据做定期分析，不建议用控制台手动导出，效率太低，建议使用OpenAPI定时拉取数据自动同步到你的数据分析系统。

Q4：对话准确率的统计规则是什么？
A4：HiAgent 3.0的对话准确率是指符合预期回复的会话数占总会话数的比例，预期回复的判定标准基于你配置的打分规则，默认是系统自动打分+人工标注校准的结果。

Q5：可以导出单条会话的准确率明细吗？
A5：可以，在badcase明细页勾选对应的会话，点击「导出选中项」即可导出单条或多条选中会话的完整准确率明细数据。

[7] 相关阅读 #

• 《HiAgent 3.0观测模块使用指南》[/docs/hiagent/3.0/guide/observation]：详细介绍观测模块所有效能指标的定义和使用方法
• 《HiAgent OpenAPI 参考文档》[/docs/hiagent/3.0/api-reference/export-accuracy]：准确率导出接口的完整参数说明和错误码列表
• 《HiAgent 对话准确率优化实战教程》[/blog/hiagent-accuracy-optimize]：教你如何基于导出的badcase数据优化智能体准确率
• 《HiAgent权限配置指南》[/docs/hiagent/3.0/guide/permission]：子账号观测模块权限的配置步骤说明

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/hiagent/3.0，2026-08-20
[2] HiAgent 3.0效能指标统计规范，https://www.volcengine.com/docs/hiagent/3.0/concept/metrics，2026-08-15
本文基于火山引擎HiAgent 3.0 v202608版本编写

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

2026-08-25