预览与调试工具

Coze 提供实时调试面板、执行日志与回放工具，帮助你在开发阶段迅速验证配置、定位异常并优化体验。

预览面板核心功能

实时对话：在编排页右侧输入问题即可测试最新配置，支持文本、语音或视频（若已开启通话能力）。
历史记录：面板下方保留最近对话，方便回顾上下文与模型输出。
快捷切换：可在调试区切换不同渠道视图（豆包、飞书等），模拟实际终端体验。

运行详情与日志

点击调试区右上角的 运行详情 可查看每轮对话的执行链路：

模型输入/输出：包括系统提示词、用户提示词、模型回复，便于检查是否按预期调用资源。
插件与工作流日志：展示调用时间、参数、返回结果以及错误信息。
知识库召回：列出命中的文档片段、相似度和来源，便于调优知识内容。

建议在对话出现异常时立即查看运行详情，大多数问题可在此快速定位。

多版本调试

草稿 vs. 已发布：预览面板默认使用草稿配置，若需验证线上版本，可通过 发布记录 查看对应日志。
多渠道测试：部分渠道（如豆包）支持生成体验链接，邀请协作者体验真实环境。

常见排查思路

回复不符合预期：查看运行详情，确认提示词、模型、知识库是否正确加载；必要时启用「自动优化提示词」。
插件/工作流报错：核对必填参数、鉴权状态和返回码，可在插件或工作流设置页单独试运行。
知识库未召回：检查召回模式（按需/自动）与阈值，确认知识片段是否匹配用户问题。
跨渠道异常：在对应渠道的调试工具（如豆包调试台、飞书测试实例）复现，结合 Coze 日志与渠道日志比对。

提升调试效率的小技巧

在提示词中添加日志输出变量，帮助定位逻辑分支。
对经常排查的问题制作快捷指令，一键触发特定场景。
定期导出运行日志，与团队共享问题案例与优化方案。

通过充分利用预览与调试工具，你可以在上线前发现潜在问题、持续优化用户体验，并确保智能体在各渠道表现一致。