调试工具的使用（日志查看/变量追踪）
搞开发的都知道，写代码不难，调代码才头大——尤其是智能体这种“会对话”的程序，有时候用户问个问题，它突然卡壳或者答非所问，你干着急却找不到毛病在哪儿。这时候Coze的调试工具就成了“救星”——日志查看和变量追踪，俩功能像“透视镜”和“追踪器”，能让你把智能体的“内部运转”看得明明白白。这节我就结合自己踩过的坑，手把手教你怎么用。
一、日志查看：给智能体的“行动轨迹”拍“监控视频”
日志这东西，说白了就是智能体执行任务时的“流水账”——它调用了哪个插件、传了什么参数、哪一步卡壳了，全记在里面。我刚开始用的时候总嫌它“啰嗦”，后来吃了大亏才明白：越“啰嗦”的日志，越能帮你定位问题。

1. 日志面板怎么打开？
   调试验证一般在工作台完成。你写完工作流（比如刚搭好“旅行助手”），想测试效果，先点工作台右上角的“调试”按钮（蓝色，带个小扳手图标）。这时候页面会弹出调试窗口，左边是“输入框”（模拟用户提问），右边就是“日志面板”（关键！）。
2. 日志里看什么？分三个层次抓重点
   日志内容密密麻麻，别慌，按“时间线+颜色标记”抓关键就行。我总结了三个必看的点：
   第一步：看“执行状态”（红/绿标）
   日志最前面有个小圆圈，绿色是“成功”，红色是“失败”。比如你输入“上海天气”，日志第一行如果是红色，那肯定是第一步就出错了（可能插件没选对，或者参数传错了）。
   举个反例：我之前搭“天气查询”工作流，日志里第一个节点（用户输入节点）显示红色，点进去看详情，发现是自己把“城市”参数写成了“chengshi”（正确应该是“city”），系统不认，直接报错。

第二步：看“插件调用记录”（关键步骤）
智能体的核心能力靠插件，所以日志里“调用XX插件”的记录必须重点看。每条记录会显示：
o 调用时间（精确到毫秒，比如“14:23:45.123”）；
o 传入参数（比如“城市=上海，日期=2025-06-21”）；
o 返回结果（比如“温度=30℃，天气=晴”）或错误信息（比如“API超时，请重试”）。
举个实用场景：用户问“上海明天几度”，智能体没回答，看日志发现“天气插件”返回“参数错误：日期格式应为YYYY-MM-DD”——哦，原来我传的是“2025/06/22”，系统要“2025-06-22”，改个符号就解决了。
第三步：看“异常日志”（黄色/红色警告）
日志里偶尔会有黄色的“警告”或红色的“错误”，这些是系统在“敲警钟”。比如：
o 黄色警告：“插件返回数据不完整，缺少‘湿度’字段”（虽然没崩溃，但可能影响后续流程）；
o 红色错误：“节点A与节点B未连接，流程中断”（直接导致智能体卡壳）。
经验之谈：别忽略黄色警告！我有次做“旅游推荐”，日志里插件返回少了“景点评分”字段（黄色警告），当时没在意，结果用户问“哪个景点最好”，智能体答“无数据”——因为评分字段是空的，根本没法比较。
二、变量追踪：给数据“装GPS”，看它怎么“流”遍工作流
变量是工作流的“血液”——插件调用的参数、返回的结果，都得通过变量在节点间传递。但变量这东西“看不见摸不着”，有时候你以为传了“温度=30℃”，结果下一个节点拿到的是“null”（空值），急得直挠头。这时候“变量追踪”功能就派上用场了——它能把变量的“一生”（从生成到传递到消失）全记录下来。

1. 变量追踪在哪找？
   调试窗口的日志面板下方，有个“变量追踪”标签（图标是个带箭头的圆圈）。点击后，页面会列出当前调试过程中所有生成的变量，每个变量后面有个“查看详情”按钮，点进去能看它的“流动路径”。
2. 变量追踪的3个关键观察点
   看“变量是否生成”：变量的第一步是“生成”，比如用户输入节点会生成“用户输入内容”变量，插件调用节点会生成“插件返回结果”变量。如果某个变量没生成（比如“用户输入内容”显示“null”），那可能是输入节点配置错了（比如没勾选“提取关键词”）。
   例子：我搭“订单查询”工作流，用户输入“订单号12345”，但变量追踪里“订单号”变量是空的——检查发现，输入节点的“关键词提取规则”写成了“订单号：(d+)”，但用户实际输入是“订单号12345”（没冒号），规则匹配不上，变量没生成。
   看“变量传递是否成功”：变量生成后，要通过箭头（逻辑连线）传递给下一个节点。比如天气插件生成“温度=30℃”，需要传递给酒店插件的“推荐参数”。变量追踪里会显示“温度变量从节点A传递到节点B”，如果显示“传递失败”，可能是连线没连对，或者参数名写错了（比如节点B要的是“temp”，但传的是“temperature”）。
   看“变量最终值是否正确”：变量的最终值决定了输出结果。比如输出节点用了“{{温度}}℃，适合穿短袖”，如果最终值是“null”，那输出就是“℃，适合穿短袖”，明显不对。这时候看变量追踪，能倒推是哪一步出的问题（插件没返回？传递丢了？还是输出模板写错了变量名）。
   三、实战：用调试工具快速定位“旅行助手”的bug
   光说不练假把式，我用自己之前踩过的“旅行助手”bug，演示一遍完整的调试流程：
   问题描述：用户输入“上海，3天，5000元”，智能体输出“未来3天天气：，适合携带”——天气数据是空的。
   调试步骤：
3. 打开调试窗口，输入测试指令，点击“开始调试”；
4. 看日志面板：第一个节点（用户输入节点）绿色（成功），第二个节点（天气插件调用）红色（失败）；
5. 点击红色日志，查看详情：“错误信息：城市参数为空”；
6. 切到变量追踪，找“城市”变量：用户输入节点生成的“目的地”变量是“上海”，但天气插件节点需要的是“城市”变量；
7. 检查逻辑连线：发现用户输入节点到天气插件节点的箭头，参数传递规则写成了“目的地→地点”（正确应该是“目的地→城市”），导致天气插件没收到“城市”参数，返回空数据；
8. 修改传递规则为“目的地→城市”，重新调试，日志显示天气插件调用成功，输出正常。
   总结
   调试工具这东西，刚开始用可能觉得“麻烦”，但熟练后你会发现：它不是“添乱”，而是“帮你少走弯路”。日志像“监控”，帮你看智能体每一步干了啥；变量追踪像“GPS”，帮你看数据从哪来、到哪去。遇到问题别慌，打开调试工具，按“看状态→查插件→追变量”的顺序一步步捋，90%的bug都能快速解决。记住：调得越多，你对智能体的“脾气”摸得越透，开发效率自然就上去了。

本站源创，转载请注明出处：https://www.xin3721.com/ArticlePrograme/robot/52898.html