> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

在搭建低代码智能体后，你可以在**预览与调试**界面与低代码智能体进行对话，并根据低代码智能体执行过程及响应信息对智能体配置进行优化与调整。在实际使用低代码智能体时，如果智能体响应不符合预期、速度过慢甚至不响应时，也可以通过调试台查看智能体的执行细节，排查问题。
# 调试台介绍 {#13afb1a2}
扣子编程的调试台功能提供全链路调试，你可以在调试台查看每一条用户请求从输入到响应的全流程，包括模型调用、配置的工作流或知识库等详细信息，方便你精准并快速定位问题，调整智能体配置。
调试台适用于以下场景的问题分析：

* 开发调试：搭建智能体时，发现智能体输出不符合预期，例如回答与问题不符，需要修改智能体流程。
* 线上排障：收到智能体用户反馈，例如智能体不响应、返回错误信息，需要诊断定位问题。

# 打开调试台 {#b128db41}
你可以通过智能体的编排页面进入调试台，操作步骤如下：

1. 在智能体编排页面右侧的**预览与调试**区域，发送一条消息内容开始与智能体对话。
2. 在收到智能体响应后，点击消息卡片下方的调试按钮，或点击右上角的**调试**选项进入调试台页面。
   ![Image=2816x1642](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/32b7555710264e978a16cee7a92e7dc6~tplv-goo7wpa0wc-image.image)
   进入调试台页面后，默认展示当前消息的响应过程，你可以筛选或选择查看之前某次对话的响应过程。
   ![Image=269x374](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3e4c061878544226a7aed33c7f630023~tplv-goo7wpa0wc-image.image)

# 调试信息说明 {#e09e42a4}
调试台中展示每轮对话运行的全链路，包括会话的 Logid 等基础信息、调用流程、每个节点的状态和耗时等节点详情、节点的输入和输出等信息。
## 基础信息 {#2a1b6f2f}
页面默认展示当前会话的信息，你也可以通过会话时间和会话状态筛选会话，例如查看上周日所有运行异常的会话。会话详情区域用于了解会话的概览数据，例如会话整体耗时、消耗的 token 数量是否超出预期等等。
![Image=364x226](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/88b5ec9cca8e48b697a17a453bc5b9df~tplv-goo7wpa0wc-image.image)
<!-- @cols-width: 212,573 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|**耗时** |响应返回的整体耗时，即从用户发起会话到智能体运行结束的时长，单位为毫秒。 |
| | | \
|**token 数量** |该会话消耗的 token 总数量，包括用户输入、运行链路、模型输出、智能体推荐词等配置消耗的 token 数量。 |
| | | \
|**任务状态** |响应返回的状态，成功或失败。 |
| | | \
|**Logid** |当前响应的Log ID。如果无法自行排查问题，可以将 Logid 提供给扣子平台，协助处理。 |
| | | \
|首次响应耗**时** |\
| |第一个字符出现的时长，单位毫秒。 |

## 调用树 {#8946d96e}
在排查和定位问题时，往往需要查看请求的完整调用链路，扣子编程通过可视化的方式展示了整个请求响应的完整链路和各节点的执行情况包括输入、输出、耗时等，帮助你快速定位问题和故障
![Image=430x451](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0c099a136f884b6cb67864d2b8745e8f~tplv-goo7wpa0wc-image.image)

* **查看请求响应链路**
   首先，你可以通过树形图查看本次请求的完整响应流程。以上图中的天气查询请求为例，本次请求共涉及了4个节点。
* **查看请求节点的详细信息**
   你可以点击任一节点查看该节点的详细信息包括耗时和 token 消耗等。
* **查看请求节点的输入和输出**
   当点击任一节点后，输入和输入区域会展示所选节点的输入数据和输出数据。下图是插件节点的输入和输出示例。
   ![Image=534x261](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/93c85806e12b4dee80d62a6d26890f4b~tplv-goo7wpa0wc-image.image)

## 火焰图 {#4a069978}
调试台的火焰图可以帮助你清晰地了解各节点的耗时，有针对性的进行性能调优。
![Image=509x193](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2b76be6922f7430b8876e1c071824bd5~tplv-goo7wpa0wc-image.image)
# 常见调试场景 {#3209fafa}
<!-- @cols-width: 162,504 -->
| | | \
|**场景** |**调试方法** |
|---|---|
| | | \
|工作流 |当智能体使用了工作流时，你可以通过调试台查看每次请求响应的工作流节点的输入和输出，以及调用出错的节点，方便你快速定位工作流中有问题的节点。 |\
| |![Image=340x514](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f016d92a32264ac7aeb35611247a4527~tplv-goo7wpa0wc-image.image) |
| | | \
|插件 |与工作流类型，你也可以通过调试台查看每次请求响应中调用的插件的运行情况，以及运行出错的插件节点。 |\
| |![Image=311x322](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/139255b3b97945b9a5a5f96827935e26~tplv-goo7wpa0wc-image.image) |
| | | \
|知识库 |知识库作为智能体配置中重要的信息存储和知识来源，知识库的召回速度和准确性会直接影响回复的准确性。 |\
| |在调试台中你可以查看知识库节点的运行情况。 |\
| |![Image=333x436](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/01bbdf0d46d0401f9967639861ba2e2b~tplv-goo7wpa0wc-image.image) |\
| |此外，你可以在请求响应运行完毕后，在**调试与预览**页面中，点击**运行完毕**选项，然后展开知识库节点，查看召回的内容片段是否正确。 |\
| |![Image=375x416](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/aa9f7e100a54494eb755163c2d3993c7~tplv-goo7wpa0wc-image.image) |

# 常见问题 {#e1e03951}
## 调试与预览窗口中的运行结果与调试台的有何区别？ {#4195497c}

* 调试与预览窗口中的运行结果会实时展示请求的响应过程，当运行完毕后会展示最后一个节点的执行信息。
* 调试台中会展示指定请求的完整响应节点和每个节点的执行信息。

## 为什么选择语音通话模式后，调试页面没有电话图标且无法使用语音通话功能？ {#20b07b19}
如果调试页面没有显示电话图标且无法使用语音通话功能，请检查智能体编排页面的以下配置：

* 确认已配置音色。
* 确认用户输入方式是否设置为**语音通话**。

![Image=400x141](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9d57bafde5314cd99263c56e9cd7d810~tplv-goo7wpa0wc-image.image)