HiAgent对话卡顿排查：后台日志查看完整操作指南
[1] 一句话结论
本指南将带你掌握HiAgent后台卡顿日志查看方法，快速定位对话卡顿根因。
[2] 适用场景与不适用场景
适用场景
- 适合单条对话响应耗时超过3s、用户反馈卡顿的在线智能客服场景
- 适合日均会话量≥5000次、偶发卡顿需要批量定位根因的企业级智能体场景
- 适合工具调用链路复杂、需要排查多模块耗时的Agent业务场景
不适用场景
- 如果是用户本地网络卡顿导致的对话加载慢，建议先排查客户端网络测速，不需要查看后台日志
- 如果是智能体调用的第三方工具本身超时，建议直接查看第三方工具监控，无需走本流程
- 如果是私有化部署的HiAgent节点宕机导致的全量无响应，建议先检查节点存活状态，再走日志排查流程
[3] 前置准备
- 开发环境：无特殊要求，只需Chrome 90+/Edge 90+浏览器访问控制台即可
- 账号权限：火山引擎主账号或被授予AgentKit FullAccess权限的子账号
- 依赖项：无需额外安装SDK，直接使用控制台原生日志功能
- 预计耗时：单条卡顿会话排查耗时≤5分钟，批量卡顿排查耗时≤20分钟
[4] 分步实现
步骤1：登录AgentKit控制台进入运行时管理
步骤说明：这一步是所有日志查询的入口，跳过的话无法定位到对应智能体的日志资源，我们需要先通过身份验证进入智能体管理界面。
操作：打开https://console.volcengine.com/agentkit ，输入账号密码完成登录，左侧导航栏选择「智能体运行时」。
预期结果：看到当前账号下所有已部署的智能体运行时实例列表，包含实例ID、运行状态、创建时间等信息。
⚠️ 常见错误：子账号登录后看不到智能体运行时列表
原因：子账号没有被配置AgentKit相关的访问权限
解决方法：联系主账号管理员在IAM控制台为子账号添加AgentKit FullAccess权限，等待5分钟后重新登录即可。
步骤2：进入目标智能体详情页
步骤说明：在运行时列表里找到出现卡顿问题的目标智能体，点击名称进入详情页，这一步是为了缩小日志查询范围，避免查询到其他无关智能体的日志。
操作：在列表的「智能体名称」列找到对应实例，点击名称跳转。
预期结果：进入智能体详情页，顶部展示实例的基本信息、运行状态、当前QPS等核心指标。
步骤3：切换到日志页选择时间范围
步骤说明：进入详情页后切换到「日志」页签，选择卡顿发生的具体时间范围，这一步非常重要，时间范围过大容易导致日志加载缓慢，过小则可能漏过卡顿相关日志。
操作：点击顶部的「日志」页签，在时间选择器中选择卡顿发生前后10分钟的时间区间（如果不知道具体时间可先选择近1小时）。
预期结果：日志页加载完成，展示所选时间范围内的所有原始日志，默认按时间倒序排列。
⚠️ 常见错误：选择超过7天的时间范围后查询无结果
原因：AgentKit控制台默认仅保留最近7天的运行日志，超过时间的日志会被自动归档到对象存储
解决方法：如果需要查询7天以上的日志，可提交工单申请从归档存储中拉取对应的日志文件，预计1-2个工作日返回结果。
步骤4：输入检索条件过滤卡顿日志
步骤说明：通过检索关键词过滤出卡顿相关的日志，快速定位异常记录，避免逐行翻找浪费时间。
操作：在检索框输入检索语句，点击「搜索」按钮。
检索示例：
# 筛选响应耗时超过3s或者包含超时关键字的日志 message:"timeout" OR cost>3000
预期结果：页面展示符合条件的日志列表，每条日志包含时间、Trace ID、耗时、错误信息等字段。
步骤5：查看链路追踪定位卡顿根因
步骤说明：找到卡顿日志对应的Trace ID，点击后查看完整的调用链路耗时，明确是ASR识别、大模型推理、工具调用还是返回模块的问题。
操作：点击目标日志的「Trace ID」字段，在弹出的链路详情页查看各环节的耗时占比。
预期结果：展示完整调用链，每个环节的耗时精确到毫秒，可直接看到耗时最高的节点。
[5] 实际验证
测试用例：模拟用户发送「请查询2026年8月的企业账单」，预期响应时间≤2s，后台日志查询该会话的cost字段为1500ms左右，无timeout关键字。
验证成功标志：请求返回HTTP状态码200，日志中该会话的各环节耗时正常，总耗时≤3s，链路追踪无异常节点。
失败排查方法：1. 如果搜索不到对应日志，先检查时间范围选择是否正确，是否跨了时区；2. 如果日志显示工具调用耗时超过2s，优先排查工具接口的可用性；3. 如果日志显示大模型推理耗时超过2s，可检查是否开启了流式响应，或者调整大模型版本为更快的轻量版。
[6] 常见问题 FAQ
Q1：日志里的cost字段包含哪些环节的耗时？
A：cost字段是从智能体收到用户请求到返回响应的全链路总耗时，包含ASR识别、大模型推理、工具调用、结果组装四个主要环节的耗时，可通过Trace ID查看各环节的单独耗时。
Q2：我可以跳过时间范围选择直接查询所有日志吗？
A：不建议，直接查询全量日志会导致加载时间超过30秒甚至查询失败，建议每次查询的时间范围不超过24小时，超过的话建议分多次查询。
Q3：HiAgent对话卡顿和大模型版本有关系吗？
A：有关系，我们在某电商客户的实践中发现，使用豆包70B版本的智能体平均响应耗时比豆包12B版本高40%左右，数据来源2026年火山引擎智能体性能测试报告。如果对响应速度要求高，建议优先选择12B及以下参数的模型版本。
Q4：什么情况下不建议通过后台日志排查卡顿？
A：如果是全量用户都反馈卡顿，且智能体运行状态显示为异常，首先应该检查节点的CPU、内存使用率，如果超过80%优先扩容节点，不需要先查日志。
Q5：下载的日志文件用什么工具分析比较方便？
A：可以使用ELK Stack或者火山引擎日志服务（SLS）进行分析，支持按Trace ID、耗时、错误类型多维度过滤。
[7] 相关阅读
- 《HiAgent性能优化最佳实践》[/blog/hiagent-performance-optimization]：介绍从配置、模型、链路三个维度优化HiAgent响应速度的方法
- 《AgentKit控制台操作手册》[/docs/agentkit/console-guide]：官方完整的AgentKit控制台操作指南，包含所有功能的详细说明
- 《智能体链路追踪使用教程》[/blog/agent-trace-tutorial]：讲解如何通过Trace ID定位智能体全链路的性能问题
- 《HiAgent常见问题排查手册》[/docs/hiagent/troubleshooting]：汇总了HiAgent部署、运行、运维阶段的常见问题及解决方案
[8] 参考资料
[1] 火山引擎AgentKit查看运行时实例日志官方文档，https://docs.volcengine.com/docs/86681/2616988?lang=zh，2026-08-20
[2] AI Agent日志怎么排查：对话时间线、工具调用与错误定位，https://blog.csdn.net/weixin_47312655/article/details/162859859，2026-07-15
本文基于火山引擎HiAgent V2.1.0版本编写
[9] 文章当前生产日期
2026-08-24
