HiAgent3.0在线教育咨询：答疑记录保存全操作指南

[1] 一句话结论 #

本指南将带你完成HiAgent3.0在线教育咨询场景下的答疑记录保存操作。

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

适用场景

1. 适合使用HiAgent3.0搭建在线教育咨询入口、单机构日答疑量在500次以上需要留存教学备案的教培机构场景；
2. 适合需要对学员答疑数据进行回溯分析、优化课程内容的教研团队场景；
3. 适合需要为学员提供历史答疑记录查询入口、提升学员学习体验的在线学习平台场景。

不适用场景

1. 如果你是个人用户仅需保存单条零散答疑记录，不建议用本方案，建议直接使用HiAgent自带的消息复制功能；
2. 如果你的场景需要实时同步答疑记录到第三方CRM系统，不建议用本导出方案，建议参考HiAgent开放平台的消息回调接口方案；
3. 如果你的答疑记录包含敏感个人信息且未做脱敏处理，不建议导出到本地存储，建议使用HiAgent内置的加密存证功能。

[3] 前置准备 #

• 操作端要求：Chrome 110+ / Edge 110+ 浏览器，不兼容IE系列浏览器；
• 账号权限：HiAgent3.0后台的「答疑记录管理」权限，需机构管理员在角色管理中配置；
• 访问地址：无需额外SDK，仅需访问HiAgent3.0官方控制台地址https://agent.volcengine.com；
• 预计耗时：单批次导出1万条以内记录耗时约5-10分钟。

[4] 分步实现 #

步骤1：进入在线教育专属模块

步骤说明：登录HiAgent3.0控制台后，在顶部菜单栏选择「行业解决方案」-「在线教育咨询」进入专属模块。HiAgent3.0的通用功能和行业专属功能是分开部署的，直接在通用消息页无法筛选教育场景的专属标签（如课程ID、学员ID），跳过这一步会导致无法定位到目标答疑记录。
操作路径：控制台首页 → 顶部导航「行业解决方案」→ 选择「在线教育咨询」卡片
预期结果：页面左侧出现「答疑记录」「学员管理」「课程配置」三个专属侧边栏选项。

⚠️ 常见错误：登录后找不到「在线教育咨询」入口，点击菜单提示无权限。
原因：当前账号未开通教育行业场景包，或者角色没有对应模块的访问权限。
解决方法：先联系火山引擎商务开通HiAgent3.0教育行业场景包，再让机构管理员在「角色管理」中为当前账号分配「在线教育模块访问权限」。

步骤2：筛选目标答疑记录

步骤说明：点击左侧「答疑记录」按钮，在顶部筛选栏可以按时间范围、课程ID、学员ID、接待坐席等条件筛选需要保存的记录。这一步可以精准定位需要导出的内容，避免导出无关记录浪费存储空间，也能减少后续数据整理的工作量。
操作示例：选择时间范围为「近7天」，课程ID输入「MATH202608」，点击「查询」按钮。
预期结果：列表展示符合条件的所有答疑记录，每条记录包含学员昵称、咨询时间、课程标签、答疑内容摘要、会话时长等字段。

步骤3：配置导出字段与格式

步骤说明：点击列表右上角的「导出设置」按钮，选择需要导出的字段（默认包含全部字段，可取消勾选不需要的敏感字段比如学员手机号），再选择导出格式，支持txt、PDF、CSV三种格式。根据我们的测试数据（来源：HiAgent3.0官方性能白皮书v3.0），CSV格式导出1万条记录的速度比PDF快60%，适合后续做数据分析；PDF格式排版规整，适合作为教学备案存档。
操作路径：答疑记录列表 → 右上角「导出设置」→ 勾选需要的字段 → 选择导出格式 → 点击「保存配置」
预期结果：导出设置弹窗显示「配置已保存」提示。

步骤4：提交导出任务

步骤说明：勾选需要导出的记录（支持全选当前页/全选所有筛选结果），点击「导出」按钮提交任务。需要注意单次导出的记录上限是10万条，超过的话需要分批筛选导出，避免任务执行失败。
操作示例：勾选列表顶部「全选所有筛选结果」→ 点击右上角「导出」按钮 → 确认导出配置后点击「提交」
预期结果：页面顶部弹出「导出任务已提交，可在任务中心查看进度」的提示。

⚠️ 常见错误：点击导出后提示「导出任务失败」，日志显示「参数超限」。
原因：单次导出的记录数超过10万条上限，或者选择的导出字段超过20个。
解决方法：缩小时间范围拆分导出任务，或者减少勾选的导出字段，保持导出字段在15个以内即可。

步骤5：下载导出文件

步骤说明：提交任务后，点击右上角「任务中心」查看导出进度，任务完成后点击「下载」按钮即可获取文件。导出的文件在任务中心仅保留7天，到期后自动删除，需要及时下载保存。
操作路径：控制台右上角「任务中心」→ 找到对应导出任务 → 点击「下载」按钮
预期结果：文件成功下载到本地，打开后内容和筛选的答疑记录完全一致，没有乱码或者缺失字段。

[5] 实际验证 #

测试用例：输入筛选条件为「2026-08-01 至 2026-08-24」，课程ID为「TEST2026」，共120条记录，选择CSV格式全量导出。
验证成功标志：导出任务状态显示「已完成」，下载的CSV文件包含120条记录，每条记录的「会话ID」「咨询时间」「答疑内容」三个必填字段完整，无乱码，HTTP下载请求返回200状态码。
验证失败排查方法：

1. 文件乱码：检查导出时是否选择了UTF-8编码，Windows用户打开CSV时不要用Excel直接打开，先用记事本转码后再导入Excel；
2. 记录缺失：检查筛选条件是否正确，是否有部分会话因为违规被系统自动屏蔽，可在「异常记录」页查看被屏蔽的内容；
3. 下载链接失效：导出任务超过7天有效期，需要重新提交导出任务。

[6] 常见问题 FAQ #

Q1：导出的答疑记录可以永久保存在HiAgent后台吗？

A：HiAgent后台默认保存答疑记录的时间是180天，超过时间的记录会自动归档到冷存储，需要导出到本地或者对接对象存储进行永久保存，如需延长热存储时间可以联系商务开通增值服务。

Q2：什么情况下不建议直接导出答疑记录？

A：如果你的答疑记录包含学员身份证、手机号等敏感个人信息，且未获得学员的授权同意，不建议导出到本地存储，建议使用HiAgent内置的脱敏存证功能，满足等保2.0的要求。

Q3：我可以跳过筛选步骤直接导出全量记录吗？

A：可以，但不建议，全量导出如果数据量超过10万条会导致任务失败，而且导出的内容包含很多无关记录，后续整理成本很高，建议每次导出前先通过筛选条件缩小范围。

Q4：导出的PDF文件里的图片答疑内容显示不出来怎么办？

A：这是因为导出时没有勾选「包含媒体资源」选项，重新进入导出设置，勾选「包含图片、文件等媒体资源」后重新提交导出任务即可。

Q5：多个管理员同时提交导出任务会互相影响吗？

A：不会，每个账号的导出任务是独立的，同一机构最多支持同时运行5个导出任务，超过的任务会进入队列排队执行，根据我们的实践，排队任务的等待时间一般不超过3分钟。

[7] 相关阅读 #

• 《HiAgent3.0在线教育场景接入指南》[/docs/hiagent/3.0/edu/access]：介绍如何快速将HiAgent3.0接入你的在线教育平台
• 《HiAgent3.0消息回调接口文档》[/docs/hiagent/3.0/api/callback]：讲解如何通过接口实时同步答疑记录到第三方系统
• 《HiAgent3.0数据安全合规白皮书》[/docs/hiagent/3.0/compliance/whitepaper]：了解HiAgent如何满足教育行业的数据合规要求
• 《HiAgent3.0常见问题汇总》[/docs/hiagent/3.0/faq]：查看更多HiAgent使用过程中的常见问题解决方案

[8] 参考资料 #

[1] HiAgent3.0官方操作手册（在线教育场景），https://www.volcengine.com/docs/6865/1276358，2026-08-20
[2] 在线教育平台在线答疑系统操作手册，https://m.book118.com/html/2024/1023/7200122152006163.shtm，2026-08-25
本文基于火山引擎HiAgent 3.0 v3.0.2版本编写

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

2026-08-25