智能体调试与预览

智能体开发平台提供了一套完整的全链路在线调试与实时预览解决方案，用以解决智能体开发与运维的 “黑盒” 状态。完成智能体编排后，您可以对智能体进行在线调试及小程序端预览，无需部署即可在平台内完成从逻辑验证、场景模拟和预览的全过程，实现智能体的快速迭代与高质量交付。

功能概述

在线调试支持对从用户请求输入、到模型响应的智能体运行全流程全景观测，支持查看模型调用、工作流、工具及知识库调用等详细信息。您可以完整透视各关键环节，进而精准快速定位问题、调优智能体配置。

您还可以通过绑定虚拟设备 ID 或 App 账号与家庭信息，模拟真实场景对话，提前发现并修复基于特定设备状态、用户属性或家庭场景的逻辑缺陷，极大降低线上故障风险。

名词解释

在线调试数据结构与运行日志数据结构相同。了解更多名词解释，请参考 智能体观测日志 > 名词解释。

名词	解释
阶段	阶段是指在一轮对话中，从用户发起输入、到获得 Robot 输出的过程中，所经历的任务类型单元。它描绘了智能体处理请求的完整流水线。以用户与设备对话为例，阶段涵盖了从语音识别（Automatic Speech Recognition，ASR）→ 语言模型处理（Large Language Model，LLM）→ 文本转语音（Text-to-Speech，TTS）全过程
节点	节点是指一个阶段内，智能体执行的最小原子操作单元。例如：调用一次大模型、执行一次工具函数、读取一次知识库或记忆变量。节点视角提供了细粒度的性能剖析与逻辑跟踪能力，是实现 “白盒调试” 的基础

调试类型

平台支持在线对话调试和扫码小程序调试两种方式。您可以在智能体编排页面切换调试类型，并通过绑定虚拟设备、或授权家庭数据，模拟真实环境的设备对话或小程序面板对话和使用效果。

在线调试

在页面左上角选择 在线调试，即可进行实时对话测试与即时链路分析。

扫码调试

在页面左上角选择 扫码调试 进入调试配置页。您可以直接使用国内版 智能生活 App 扫码预览小程序对话效果，还可通过投放设备 PID 或投放 OEM App 预览效果。

在线调试

在线调试预览可展示每轮对话运行的完整链路，包括会话基础信息、设备/用户基础信息、调用节点流程、每个节点的状态和耗时等节点详情、节点的输入和输出等信息。

查看快速预览

点击某轮对话右上角的展开图标，即可查看该轮对话的所有关键节点执行流程。支持查看模型、调用技能、引用变量、知识库召回、数据库读写等。

查看调试详情

点击某轮对话右上角的详情图标，可查看该轮对话详细的调试日志信息。

调试日志信息说明

基础信息

基础信息包括该轮对话的 RequestID、发起时间、耗时、设备 ID、用户 ID 等。

字段名称	说明
RequestID	本轮对话的请求 ID
设备 ID	智能体运行的设备 ID
User ID	本轮对话的用户 ID
运行结果	本轮对话执行的结果
整体耗时	本轮对话从输入到输出消耗的时间
请求发起时间	本轮对话发起的时间
首字响应耗时（TTFT）	从请求到开始返回第一个字符的时间

节点树

节点树可视化展示了整个请求运行的完整链路、各节点拓扑与执行明细，包括节点的输入/输出节点耗时。

燃尽图

燃尽图展示了全链路及各节点的耗时分布情况，帮助您分析和优化响应时间。

调试设置

您可以在调试对话框点击设置按钮，进一步设置虚拟设备，您可以使用真实的 App 用户信息，来模拟真实环境下的效果。

绑定虚拟设备

绑定虚拟设备后，可模拟真实设备场景下与智能体对话的效果。适用于无真实硬件的情况下，测试与设备控制、状态查询相关的能力。

例如：测试设备播放音乐的场景，绑定虚拟设备后，在对话框输入播放音乐指令 “播放周杰伦的歌”，在调试对话框即可看到智能体的真实回复内容。因为没有真实设备，所以不会产生真实的播放效果，您可以根据智能体回复以及日志，判定播放效果和查看设备回复内容。

绑定家庭和用户数据

绑定家庭和用户数据后，智能体将基于绑定的用户和家庭信息进行回复，适用于与设备无关的场景。例如，测试 “今天天气怎么样？”，智能体将直接根据绑定的家庭位置返回精准天气信息，提升天气相关技能测试效率。

调试日志搜索

在线调试默认支持 7 日内调试日志详情的回溯。您可通过搜索查询历史对话，查看历史对话调试详情。
点击在线调试对话输入框的图标，打开历史调试日志搜索页面。

您可以通过选择运行状态并输入对话关键字，来查询 7 日内某轮对话和对话的调试日志详情。

扫码调试

扫码调试提供了小程序端对话效果预览。您可以将智能体投放到产品 PID 或者自有 OEM App ，通过 智能生活 App 或自有 OEM App 扫码访问小程序后，预览真实小程序对话效果。

点击 获取调试二维码，生成二维码后，页面会提示您可投放 OEM App。点击 投放至指定 App 打开投放管理页面，将智能体投放到产品 PID 和小程序。

投放完成后，在调试窗口可设置已绑定的产品虚拟设备 ID ，并扫码进行小程序对话调试。