智能体观测日志

概述

在智能体应用的开发部署与商用过程中，开发者需要对智能体日常运行的状态和问题进行追溯和分析。而在实际运行态中，智能体请求的调用链路复杂繁琐、决策黑盒、性能瓶颈隐蔽，常常导致遇到问题难以排查。

为此，涂鸦智能体开发平台提供了智能体全链路可观测性平台，记录从用户对设备发起对话、到设备语音输出的完整链路的跟踪记录，并结构化展示每一轮对话的执行时序以及相关的配置信息。能够帮助开发者透视每一次 AI 决策、高效定位问题、分析问题，进而解决和优化问题。

功能特点

• 全链路记录：面向涂鸦 AI 智能硬件场景，平台记录了从用户语音输入（Automatic Speech Recognition，ASR）→ 推理与决策（Large Language Model，LLM） → 设备语音输出（Text-to-Speech，TTS）全链路节点运行的结果和详细信息，方便开发者扩展分析边界，提升从设备到云端整体链路的可靠性和质量。
• 信息全面覆盖：日志信息覆盖了每一轮对话中各阶段的节点执行详情，包括对话发起时间及耗时、对话运行时配置等，可以全面掌握运行时每一轮对话的数据基础。
• 结构化展示：每个运行节点通过 Json 格式及树状拓扑展示真实输入输出和时序，通过燃尽图展示每个节点的运行耗时分布，帮助开发者一目了然地掌握运行数据，进而将黑盒运营升级为透明化白盒决策。
• 多来源数据追溯：支持调试数据以及对运行时真实数据的记录和追溯。支持平台自主规划智能体、工作流产生的数据记录。

名词解释

名词	解释
阶段	阶段是指在一轮对话中，从用户发起输入、到获得 Robot 输出所经历的任务类型单元。它描绘了智能体处理请求的完整流水线。以用户与设备对话为例，阶段涵盖了从语音识别（ASR）→ 语言模型处理（LLM）→ 文本转语音（TTS）全过程
阶段类型	目前平台支持的阶段类型包括：ASR、LLM、TTS 以及 INTERRUPT
ASR 阶段	用户语音输入后，ASR 模型将用户音频流转换为文本的过程
LLM 阶段	智能体决策阶段，LLM 理解用户意图、调用技能，并生成结构化的回复或指令
TTS 阶段	通过 TTS 模型将智能体输出合成为语音音频的过程
INTERRUPT 阶段	用户与设备语音交互时，系统监听音频流，并处理是否中断 TTS 的过程
节点	节点是指一个阶段内，智能体执行的最小原子操作单元。例如：调用一次大模型、执行一次工具函数、读取一次知识库或记忆变量。节点视角提供了细粒度的性能剖析与逻辑跟踪能力，是实现 “白盒调试” 的基础

查询日志

前往 智能体 > 统计与监控 > 运行日志 页面，进入运行日志列表页。

运行日志支持按时间区间、设备 ID、用户 ID、对话用户输入关键字等方式搜索日志。最长支持 1 小时内日志查询。

字段说明

字段	说明
对话关键字	某一轮对话中，用户原始输入的关键字
设备 ID	对话的设备 ID
用户 ID	对话的用户 ID
INPUT	某一轮对话里的用户输入
OUTPUT	某一轮对话里智能体的输出
智能体 ID	对话的智能体实例 ID
智能体版本	智能体的发布版本。如果是编排调试产生的日志，智能体版本将展示为开发版本

查看日志详情

在搜索结果列表，点击 操作 列下的 日志详情，即可查看当前对话的日志详情。

日志信息说明

基础信息

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

字段名称	说明
Request ID	本轮对话的请求 ID
设备 ID	智能体运行的设备 ID
用户 ID	本轮对话的用户 ID
运行结果	本轮对话执行的结果
整体耗时	本轮对话从用户输入到输出完成消耗的时间
请求发起时间	本轮对话发起的时间
首字响应耗时	从请求发起到输出第一个字符消耗的时间

节点树

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

燃尽图

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

查看配置详情

配置详情展示了对话运行时的角色设定、语音交互参数以及上下文变量的详情，帮助复现和分析真实对话。

在搜索结果列表，点击 操作 列下的 配置详情，即可查看当前对话的配置详情。

配置信息说明

配置信息包括对话运行时的角色设定、语音交互参数以及上下文变量的详情，帮助复现和分析真实对话。

字段名称	说明
多角色	本轮对话时引用的角色设置。当开启了多角色时，语音交互参数为该角色设置的参数
输入语种	与设备对话的语种
输出音色	与设备对话时，设备播报使用的音色
输出语速	与设备对话时，设备播报的语速
音频格式	与设备对话时，设备输出的音频格式
开启的变量	本轮对话引用的变量和变量值