Dify 调试与测试
Dify 调试与测试
本文整理自 Dify 官方文档,涵盖 调试与测试 章节的全部内容。
本章内容
PRTCL // PLAINTEXT
1|# 错误类型 2| 3|> 原文:[错误类型](https://docs.dify.ai/zh/use-dify/debug/error-type) 4| 5|--- 6| 7|## Documentation IndexFetch the complete documentation index at:[https://docs.dify.ai/llms.txt](https://docs.dify.ai/llms.txt) 8| 9|10|> ⚠️ ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/debug/error-type)。11|12|每个节点类型都会抛出特定的错误类别,帮助你了解出错的原因以及如何修复。13|14|15|## 节点特定错误16|- Code17|- LLM18|- HTTP Request19|- Tool:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0" data-component-part="tab-content">`CodeNodeError`20|> 💡 你的 Python 或 JavaScript 代码在执行过程中抛出了异常21|22|23|`OutputValidationError`24|> 💡 你的代码返回的数据类型与你配置的输出变量类型不匹配25|26|27|`DepthLimitError`28|> 💡 你的代码创建的嵌套数据结构深度超过了 5 层29|30|31|`CodeExecutionError`32|> 💡 沙箱服务无法执行你的代码 - 通常意味着服务已停止33|34|35|:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">`VariableNotFoundError`36|> 💡 你的提示词模板引用了一个在工作流上下文中不存在的变量37|38|39|`InvalidContextStructureError`40|> 💡 你向上下文字段传递了数组或对象,该字段仅接受字符串41|42|43|`NoPromptFoundError`44|> 💡 提示词字段完全为空45|46|47|`ModelNotExistError`48|> 💡 在大型语言模型节点配置中未选择模型49|50|51|`LLMModeRequiredError`52|> 💡 所选模型未配置有效的 API 凭据53|54|55|`InvalidVariableTypeError`56|> 💡 你的提示词模板不是有效的 Jinja2 语法或纯文本格式57|58|59|:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">`AuthorizationConfigError`60|> 💡 API 端点缺失或身份验证配置无效61|62|63|`InvalidHttpMethodError`64|> 💡 HTTP 方法必须是 GET、HEAD、POST、PUT、PATCH 或 DELETE65|66|67|`ResponseSizeError`68|> 💡 API 响应超过了 10MB 大小限制69|70|71|`FileFetchError`72|> 💡 无法检索请求中引用的文件变量73|74|75|`InvalidURLError`76|> 💡 URL 格式错误或无法访问77|78|79|:first-child:not(p)]:mt-0 [&>:first-child:not(p)_img]:mt-0 [&>:first-child[data-table-wrapper]]:!pt-0 hidden" data-component-part="tab-content">`ToolParameterError`80|> 💡 传递给工具的参数与其预期的架构不匹配81|82|83|`ToolFileError`84|> 💡 工具无法访问所需的文件85|86|87|`ToolInvokeError`88|> 💡 外部工具 API 在执行过程中返回了错误89|90|91|`ToolProviderNotFoundError`92|> 💡 工具提供商未正确安装或配置93|94|95|## 系统级错误`InvokeConnectionError`96|> 💡 与外部服务的网络连接失败97|98|99|`InvokeServerUnavailableError`100|> 💡 外部服务返回 503 状态或暂时停机 101| 102| 103|InvokeRateLimitError 104|> 💡 你已达到 API 或模型提供商的速率限制 105| 106| 107|QuotaExceededError 108|> 💡 你对此服务的使用配额已超限 109|
PRTCL // PLAINTEXT
1|# 运行历史 2| 3|> 原文:[运行历史](https://docs.dify.ai/zh/use-dify/debug/history-and-logs) 4| 5|--- 6| 7|## Documentation IndexFetch the complete documentation index at:[https://docs.dify.ai/llms.txt](https://docs.dify.ai/llms.txt) 8| 9|10|> ⚠️ ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/debug/history-and-logs)。11|12|Dify 会在每次工作流运行时记录详细的运行历史。你可以查看应用级别和各个节点的运行情况。13|14|15|> 💡 对于发布后来自真实用户的运行历史,请参阅[运行历史和标注](/zh/use-dify/monitor/logs)。16|17|18|## 应用运行历史每次工作流运行都会创建一个完整的日志条目。点击任何条目可以查看三个部分:19|20|21|### 结果显示用户看到的最终输出。如果工作流失败,你将在这里看到错误消息。22|23|24|> 💡 仅适用于工作流应用。25|26|27|### 详情显示原始输入、最终输出和执行过程中的系统元数据。28|29|30|### 追踪准确显示工作流的执行过程,包括哪些节点按什么顺序运行、每个节点耗时多长,以及数据在节点间如何流动。这对于找出瓶颈和理解具有分支或循环的复杂工作流很有用。31|32|33|## 节点运行历史你也可以检查任何单个节点的最后一次执行。在节点配置面板中点击”最后运行”,查看其最近的输入、输出和时间详情。34|PRTCL // PLAINTEXT
1|# 单节点 2| 3|> 原文:[单节点](https://docs.dify.ai/zh/use-dify/debug/step-run) 4| 5|--- 6| 7|## Documentation IndexFetch the complete documentation index at:[https://docs.dify.ai/llms.txt](https://docs.dify.ai/llms.txt) 8| 9|10|> ⚠️ ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/debug/step-run)。11|12|测试单个节点或逐步运行你的工作流以在发布前发现问题。13|14|15|## 单节点测试你可以单独测试任何节点而无需运行整个工作流。选择节点,在其设置面板中提供测试输入,然后点击运行以查看输出。16|17|18|测试后,点击”上次运行”查看执行详情,包括输入、输出、时间和任何错误消息。19|20|21|> 💡 答案节点和结束节点不支持单节点测试。22|23|24|## 逐步执行当你一次运行一个节点时,它们的输出会缓存在变量检查器中。你可以编辑这些缓存的变量来测试不同场景,而无需重新运行上游节点。25|26|27|当你想要测试节点如何响应不同数据而无需修改和重新运行它之前的所有节点时,这非常有用。只需在检查器中更改变量值并再次运行节点即可。28|29|30|## 查看执行历史每次节点执行都会创建一条记录。点击任何节点上的”上次运行”可查看其最近的执行详情,包括输入数据、输出内容以及执行时间。31|PRTCL // PLAINTEXT
1|# 变量检查器 2| 3|> 原文:[变量检查器](https://docs.dify.ai/zh/use-dify/debug/variable-inspect) 4| 5|--- 6| 7|## Documentation IndexFetch the complete documentation index at:[https://docs.dify.ai/llms.txt](https://docs.dify.ai/llms.txt) 8| 9|10|> ⚠️ ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/debug/variable-inspect)。11|12|变量检查器显示所有流经你工作流的数据。它会在每个节点运行后捕获输入和输出,因此你可以查看正在发生的情况并测试不同的场景。13|14|15|## 查看变量任何节点运行后,其输出变量会出现在屏幕底部的检查器面板中。点击任何变量可查看其完整内容。16|17|18|## 编辑变量你可以通过点击大多数变量值来编辑它们。当你运行下游节点时,它们将使用你编辑的值而不是原始值。这让你可以测试不同场景,而无需重新运行整个工作流。19|20|21|> 💡 在此处编辑变量不会更改最初创建它们的节点的”最后运行”记录。22|23|24|例如,如果大型语言模型节点生成了像`SELECT * FROM users`这样的 SQL,你可以在检查器中将其编辑为`SELECT username FROM users`,然后只重新运行数据库节点以查看不同的结果。25|26|27|## 重置变量点击任何变量旁边的还原图标以恢复其原始值,或点击”全部重置”以一次性清除所有缓存变量。28|