鼎上平台智能体运行日志查看与调试排查指南

适用情境

在AI智能体开发过程中，开发者经常会遇到智能体回答偏离预期、外部工具调用失败或流程意外中断等问题。当用户在完成鼎上注册并搭建好基础智能体后，若发现运行结果与测试用例不符，就需要通过运行日志来追溯问题根源。本指南适用于智能体调试、错误定位以及性能优化的日常场景。

可执行步骤

1. 进入运行日志中心

登录鼎上平台控制台，在左侧导航栏找到调试与运行模块，点击进入运行日志页面。这里会记录智能体在测试环境和生产环境中的所有交互数据。

2. 筛选与定位目标会话

利用顶部的筛选功能，可以通过会话ID、时间范围或触发状态快速定位到出问题的具体对话。点击目标会话，展开详细的执行链路。

3. 分析节点执行状态

在详情页面，系统会以可视化流程图展示各个节点的执行情况。重点检查以下内容：

• 大模型节点：查看输入的提示词和上下文，对比模型实际输出的内容，判断是否存在逻辑偏差。
• 工具调用节点：检查传递给第三方API的参数是否正确，以及API返回的原始响应状态码和数据格式。
• 条件分支节点：核实分支判断条件是否按预期生效，避免流程走入错误分支。

4. 修改配置并重新测试

根据日志分析结果，返回智能体编排页面，调整相应的提示词、参数阈值或工具配置。修改完成后，使用相同的测试用例重新运行，并对比新的日志以验证修复效果。

注意事项

在进行日志排查时，开发者需要注意以下几点：

1. 数据隐私与脱敏：日志中可能包含用户的敏感输入信息。在分享日志给技术支持团队或进行外部排查时，请务必对敏感数据进行脱敏处理。
2. 日志保留期限：平台对运行日志设有保留周期，超出期限的历史日志将被自动清理。建议对关键的错误日志进行本地备份。
3. 版本一致性：排查问题时，需确认当前查看的日志对应的智能体版本号。如果智能体已发布新版本，旧版本的日志配置可能与当前界面不一致。

通过系统化的日志查看与排查，开发者可以大幅缩短智能体的调试周期，确保最终交付的智能体具备更高的稳定性和准确性。