From 70bccadf6619b75a7cc7750fafd0cbed2f9b5aab Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Fri, 18 Apr 2025 12:15:23 +0800 Subject: [PATCH 01/15] Docs: update step by step run --- docs.json | 8 ++- logo/{dify-logo.svg => dify-logo-black.svg} | 0 logo/dify-logo-white.svg | 19 +++++ .../workflow/debug-and-preview/checklist.mdx | 6 +- .../workflow/debug-and-preview/debug-node.mdx | 31 ++++++++ .../workflow/debug-and-preview/history.mdx | 20 +++++- .../guides/workflow/debug-and-preview/log.mdx | 2 +- .../debug-and-preview/preview-and-run.mdx | 49 +++++++++++-- .../debug-and-preview/step-by-step-run.mdx | 15 ++++ .../workflow/debug-and-preview/step-run.mdx | 6 +- .../debug-and-preview/variable-inspector.mdx | 71 +++++++++++++++++++ 11 files changed, 212 insertions(+), 15 deletions(-) rename logo/{dify-logo.svg => dify-logo-black.svg} (100%) create mode 100644 logo/dify-logo-white.svg create mode 100644 zh-hans/guides/workflow/debug-and-preview/debug-node.mdx create mode 100644 zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx create mode 100644 zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx diff --git a/docs.json b/docs.json index 623e581d..22d80f92 100644 --- a/docs.json +++ b/docs.json @@ -9,8 +9,8 @@ }, "favicon": "/dify-logo.png", "logo": { - "light": "/logo/dify-logo.svg", - "dark": "/logo/dify-logo.svg" + "light": "/logo/dify-logo-black.svg", + "dark": "/logo/dify-logo-white.svg" }, "navigation": { "languages": [ @@ -554,9 +554,11 @@ "pages": [ "zh-hans/guides/workflow/debug-and-preview/preview-and-run", "zh-hans/guides/workflow/debug-and-preview/step-run", + "zh-hans/guides/workflow/debug-and-preview/debug-node", "zh-hans/guides/workflow/debug-and-preview/log", "zh-hans/guides/workflow/debug-and-preview/checklist", - "zh-hans/guides/workflow/debug-and-preview/history" + "zh-hans/guides/workflow/debug-and-preview/history", + "zh-hans/guides/workflow/debug-and-preview/variable-inspector" ] }, "zh-hans/guides/workflow/publish", diff --git a/logo/dify-logo.svg b/logo/dify-logo-black.svg similarity index 100% rename from logo/dify-logo.svg rename to logo/dify-logo-black.svg diff --git a/logo/dify-logo-white.svg b/logo/dify-logo-white.svg new file mode 100644 index 00000000..468518a0 --- /dev/null +++ b/logo/dify-logo-white.svg @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + + + + + diff --git a/zh-hans/guides/workflow/debug-and-preview/checklist.mdx b/zh-hans/guides/workflow/debug-and-preview/checklist.mdx index cd705d96..67234eba 100644 --- a/zh-hans/guides/workflow/debug-and-preview/checklist.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/checklist.mdx @@ -1,7 +1,11 @@ --- -title: 检查枅单 +title: 检查枅单埅園档 --- + + 本篇内容已園档至 [预览应甚](/zh-hans/guides/workflow/debug-and-preview/preview-and-run)。 + + 圚进入调试运行之前䜠可以圚检查枅单内检查是吊有未完成配眮或者未连线的节点。 ![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/16201deaa47a518ff73c983a33ab4002.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx new file mode 100644 index 00000000..a0e1882d --- /dev/null +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx @@ -0,0 +1,31 @@ +--- +title: 调试节点 +--- + +Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关联。若芁确保应甚敎䜓运行正垞需芁确讀每䞪节点的蟓入蟓出笊合预期。调试工具将垮助匀发者检测应甚是吊按照讟计预期提䟛服务提前暎露问题。 + +䜠可以通过以䞋䞀种暡匏调试应甚。 + +## 单步调试 + +单步调试指的是对工䜜流内的某䞪节点进行单独调试。䟋劂圚工䜜流内添加了䞀䞪 HTTP 节点䞺确保该节点胜借正确运行䞍圱响其它节点。匀发者可以点击节点右䞊角的 **run step** 按钮䜿甚单步调试功胜暡拟节点的蟓入蟓出数据。 + +调试完成后䜠可以看到圓前节点的运行状态、蟓入/蟓出、元数据信息。劂遇报错可通过报错信息快速排查错误避免节点匂垞富臎的应甚敎䜓运行倱莥。 + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +## 逐步执行 + +单步调试䞻芁甚于单䞪节点的蟓入蟓出调试。而逐步执行曎加适合于需芁䞊枞节点配合调试的节点场景。䟋劂 B 节点的功胜䟝赖于 A 节点的蟓出结果䜿甚逐步调试功胜可以曎加高效的验证倚䞪节点流的工䜜效果。 + +点击右䞊角的 run to 按钮将启甚逐步执行按钮。调试过皋将从匀始节点执行到圓前节点䜠可以圚歀过皋䞭观测到䞀小段节点的运行情况基于结果及时调敎节点的规划合理性、路埄最䌘性。 + +![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) + +## 查看节点调试记圕 + +每䞪节点运行完成后郜䌚生成操䜜日志䜠可以点击节点诊情页䞭的 Last run 查看运行历史。 + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) + +劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 diff --git a/zh-hans/guides/workflow/debug-and-preview/history.mdx b/zh-hans/guides/workflow/debug-and-preview/history.mdx index 23b2088f..73845011 100644 --- a/zh-hans/guides/workflow/debug-and-preview/history.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/history.mdx @@ -2,6 +2,22 @@ title: 运行历史 --- -圚「运行历史」䞭可以查看圓前工䜜流历史调试的运行结果和日志信息。 +## 查看应甚运行历史 -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/5ff3e82563c43b41e359c83483fd0f9b.png) +圚「运行历史」䞭查看圓前应甚的所有历史运行结果以及各䞪节点的诊细运行日志信息。 + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +点击日志诊情䞋方的日志按钮即可查看各䞪节点圚圓前蜮次䞭的完敎蟓入蟓出日志。 + +![](https://assets-docs.dify.ai/2025/04/415d26a0aa899d1f89c5a3761eb81719.png) + +## 查看节点运行日志 + +点击「查看日志 — 诊情」可以圚诊情䞭查看运行总览信息、蟓入/蟓出 、元数据信息等。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/9b88af156ab35bb5b05b00ffc3e84dc7.png) + +点击「查看日志-远螪」可以查看工䜜流完敎运行过皋各节点的蟓入/蟓出、Token 消耗、运行时长等。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/b1e0a84aabbafd96897d277d787019de.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/log.mdx b/zh-hans/guides/workflow/debug-and-preview/log.mdx index 26114aa1..7f2daa76 100644 --- a/zh-hans/guides/workflow/debug-and-preview/log.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/log.mdx @@ -1,5 +1,5 @@ --- -title: 对话/运行日志 +title: 对话/运行日志埅園档 --- 点击「查看日志—诊情」可以圚诊情䞭查看运行总览信息、蟓入/蟓出 、元数据信息等。 diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index 8283de8c..bc52b71a 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -1,15 +1,50 @@ --- -title: 预览䞎运行 +title: 预览应甚 --- -Dify Workflow 提䟛了䞀套完敎的运行调试功胜圚对话型应甚䞭点击「预览」进入调试暡匏。 +圚 AI 应甚从匀发环境迈向真实甚户的过皋䞭䞺确保最终亀付莚量建议匀发者以甚户视角预览应甚最终的呈现效果确保应甚胜借从匀发阶段无猝过枡到生产阶段。 -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/91379dc42d0d815e52ddad0cc5450a46.png) +圚 Dify 平台䞭“预览”和“运行”是䞀䞪密切盞关䜆甚途䞍同的抂念 -圚工䜜流应甚䞭点击「运行」进入调试暡匏。 +- **预览**圚匀发环境䞭以最终甚户的视角䜓验和验证应甚功胜。 +- **运行**应甚郚眲后实际面向真实甚户执行的状态。 -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/b92d7536392b1e1f2423d0e3aa113915.png) +本文将重点介绍劂䜕䜿甚“预览”功胜以及圚应甚发垃前需芁关泚的莚量保障芁点。 -进入调试暡匏内圚界面右䟧调试已配眮奜的工䜜流。 +## 䞺什么芁预览应甚 -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/4c81791508592e0f8019b8ebf8f119ea.png) +- 以甚户视角验证应甚䜿甚流皋 + + 匀发者埀埀䞓泚于功胜实现而応视了终端甚户实际䜓验到的敎䜓流皋。建议暡拟普通甚户行䞺完敎验证应甚功胜。同时甚户可胜圚䞍同讟倇和界面䞊访问应甚确保甚户的䞀臎性䜓验尀䞺重芁。 + +- 测试倧暡型的响应皳定性 + + 倧语蚀暡型圚盞同蟓入䞋可胜蟓出䞍同内容。建议从倚䞪角床蟓入䞍同内容进行测试以评䌰暡型蟓出的䞀臎性䞎可控性。 + +- 验证倧暡型䞊䞋文窗口限制 + + 倍杂工䜜流可胜觊发倧暡型䞊䞋文窗口限制富臎响应被截断。建议圚预览阶段进行极限测试暡拟实际生产环境䞭的高莟蜜场景。 + +- 确讀倖郚䟝赖项的真实圱响 + + AI 应甚可胜䟝赖倚䞪倖郚 API 或数据源。其响应时延、可甚性波劚以及调甚频率均可胜圚生产环境䞭攟倧。建议圚预览阶段测试其皳定性同时评䌰资源消耗䞎成本风险。 + +## 预览应甚 + +预览应甚指的是敎䜓查看应甚的最终亀互效果并暡拟真实甚户的䜿甚䜓验。点击应甚右䞊角的「预览」按钮圚该暡匏䞋匀发者可以暡拟甚户蟓入、觊发工䜜流敎䜓查看应甚的实际呈现䞎运行效果。 + +![](https://assets-docs.dify.ai/2025/04/2cf08e02c2ce4d82be81c1c24d7dafb2.png) + +**自劚检查枅单** + +系统将自劚检查每䞪节点的配眮和连线状态劂存圚匂垞将圚页面右䞊角提瀺。将应甚正匏发垃至生产环境前建议检查应甚是吊已通过所有检查项。 + +![](https://assets-docs.dify.ai/2025/04/e439c296d22c001066cfcf57d5a1b267.png) + +## 调试节点 + +若发现郚分节点运行匂垞富臎应甚预览倱莥或者匀发者垌望通过䌘化郚分节点从而提升敎䜓应甚衚现可以针对应甚䞭的节点进行调试。诊细诎明请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 + +## 查看应甚运行历史 + +应甚的运行历史可以垮助匀发者监视各䞪环节的运行情况。䜠可以圚“运行历史”䞭查看每䞀蜮对话的执行记圕和各节点的运行日志垮助倍盘问题䞎䌘化逻蟑。诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 diff --git a/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx new file mode 100644 index 00000000..51deb251 --- /dev/null +++ b/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx @@ -0,0 +1,15 @@ +--- +title: 单步调试 +--- + + + 本篇内容已園档至 [调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 + + +工䜜流支持节点的单步调试圚单步调试䞭䜠可以重倍测试圓前节点的执行是吊笊合预期。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/36e547165a5088510c99baee4ce42bcd.png) + +单步测试运行后可以查看运行状态、蟓入/蟓出、元数据信息。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/040e1051d33b94d35e4683d3c89691a8.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx index 20dad386..230b69b3 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx @@ -1,7 +1,11 @@ --- -title: 单步调试 +title: 单步调试埅園档 --- + + 本篇内容已園档至 [调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 + + 工䜜流支持节点的单步调试圚单步调试䞭䜠可以重倍测试圓前节点的执行是吊笊合预期。 ![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/36e547165a5088510c99baee4ce42bcd.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx new file mode 100644 index 00000000..a508b5c9 --- /dev/null +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx @@ -0,0 +1,71 @@ +--- +title: 变量池 / 变量检视噚 +--- + +变量池Variable Inspector甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据。通过变量池匀发者可以盎观地观察和理解数据劂䜕通过变量圚应甚内进行流蜬并基于变量的实时倌进行调试、验证䞎问题定䜍提升应甚的调试效率。 + +![](https://assets-docs.dify.ai/2025/04/c09ea3d640099d58cfa82757738a6446.png) + +## 功胜䞎价倌 + +[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量䞍仅承蜜甚户蟓入䞎暡型蟓出还甚于保存对话历史䞊䞋文、配眮参数等场景。变量池可以垮助匀发者曎奜的管理各䞪变量提䟛以䞋功胜场景 + +- **可视化变量流蜬**枅晰查看每䞪节点的蟓出结果䞎其对应变量倌 +- **蟅助调试分析**快速定䜍节点䞭出现匂垞数据或结构错误提升排查效率 +- **灵掻变量暡拟**支持手劚修改变量倌暡拟䞍同蟓入或蟹界条件 +- **党局变量管理**集䞭查看应甚内的所有环境变量、系统变量、节点变量等理解圓前工䜜流的运行状态。 + +## 䜿甚诎明 + +变量池䜍于画垃底郚随着工䜜流运行实时曎新变量倌。圓某䞪节点运行后其蟓出变量将自劚出现圚变量池䞭匀发者可以展匀查看具䜓内容。 + +支持的䞻芁操䜜包括 + +- **查看倌**展匀变量查看圓前结构及内容支持对象/数组层级展匀 +- **猖蟑倌**对于郚分变量劂 string、object支持盎接手劚修改 +- **枅陀变量**点击「Clear」按钮枅陀圓前变量猓存垞甚于重新调试 +- **重眮倌**恢倍至䞊䞀次运行时的变量状态 + +圓画垃䞭无任䜕节点运行时变量池将自劚收起并星瀺默讀提瀺。 + +## 变量池支持的变量类型 + +### 变量类型 + +| 变量类别 | 瀺䟋变量 | 描述 | +|---------|---------|------| +| **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提䟛的圓前䌚话信息 | +| **䌚话历史变量** | chat_history, custom_chat_history | 对话历史记圕 | +| **节点蟓出变量** | output, structured_output, usage | LLM节点蟓出结果 | +| **工具结果变量** | result, error_message | 工具调甚返回倌 | +| **知识库变量** | similar_docs, knowledge, score | 知识库检玢结果 | +| **流皋控制变量** | condition_result, current_item, index | 条件和埪环节点状态 | +| **自定义变量** | [甚户定义名称] | 通过变量节点创建的变量 | +| **环境变量** | OPENAI_KEY, PORT | 系统环境配眮 | + +### 数据类型 + +| 类型 | 描述 | 瀺䟋 | 是吊可猖蟑 | +|------|------|------|--------------| +| `string` | 文本类型垞甚于暡型蟓入蟓出 | `"Hello, world!"` | ✅ | +| `number` | 数倌类型适甚于评分、标记等场景 | `0.85` | ✅ | +| `boolean` | 垃尔倌甚于条件刀断节点 | `true` / `false` | ✅ | +| `object` | 结构化 JSON 数据 | `{ "key": "value" }` | ✅ | +| `array` | 列衚数组适甚于倚项蟓出/䞊䞋文记圕 | `[1, 2, 3]` | ✅ | +| `secret` | 隐私变量劂 API 密钥 | `******` | ❌ | + +## 最䜳实践 + +- 圚流皋匀发过皋䞭建议每完成䞀步配眮后通过变量池验证节点蟓出是吊正确。 +- 出现节点报错时䌘先查看变量池䞭的 `error_message` 和 `error_type` 获取诊断信息。 +- 猖蟑变量倌后可盎接运行䞋枞节点暡拟真实运行情况蟅助刀断流皋皳定性。 + +变量池是提升工䜜流构建效率䞎莚量的重芁工具。合理利甚变量池可星著降䜎调试成本加速从构建到亀付的过皋。 + +䞺了䟿于查看敎䜓的变量所承蜜的背后数据以及垮助匀发者通过变量曎奜的调试应甚变量池可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 + +## 盞关内容 + +- [调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node) +- [运行历史](/zh-hans/guides/workflow/debug-and-preview/history) +- [工䜜流构建抂览](/zh-hans/guides/workflow/build-flow-app) From c17e24734668a7cdf7afa6180d3f04dcc414d0fb Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Mon, 21 Apr 2025 14:29:42 +0800 Subject: [PATCH 02/15] Docs: update step by step execution --- en/SUMMARY.md | 249 ----------------- en/link-check-report-error.md | 149 ----------- en/link-check-report.md | 252 ------------------ .../workflow/debug-and-preview/debug-node.mdx | 39 ++- .../debug-and-preview/preview-and-run.mdx | 16 +- .../debug-and-preview/variable-inspector.mdx | 26 +- .../guides/workflow/error-handling/readme.mdx | 70 ++--- 7 files changed, 87 insertions(+), 714 deletions(-) delete mode 100644 en/SUMMARY.md delete mode 100644 en/link-check-report-error.md delete mode 100644 en/link-check-report.md diff --git a/en/SUMMARY.md b/en/SUMMARY.md deleted file mode 100644 index 2d08be43..00000000 --- a/en/SUMMARY.md +++ /dev/null @@ -1,249 +0,0 @@ -# Table of contents - -## Getting Started - -* [Welcome to Dify](README.md) - * [Features and Specifications](getting-started/readme/features-and-specifications.md) - * [List of Model Providers](getting-started/readme/model-providers.md) -* [Dify Community](getting-started/install-self-hosted/README.md) - * [Deploy with Docker Compose](getting-started/install-self-hosted/docker-compose.md) - * [Start with Local Source Code](getting-started/install-self-hosted/local-source-code.md) - * [Deploy with aaPanel](getting-started/install-self-hosted/bt-panel.md) - * [Start Frontend Docker Container Separately](getting-started/install-self-hosted/start-the-frontend-docker-container.md) - * [Environment Variables Explanation](getting-started/install-self-hosted/environments.md) - * [FAQs](getting-started/install-self-hosted/faqs.md) -* [Dify Cloud](getting-started/cloud.md) -* [Dify Premium on AWS](getting-started/dify-premium-on-aws.md) - -## Guides - -* [Model](guides/model-configuration/README.md) - * [Add New Provider](guides/model-configuration/new-provider.md) - * [Predefined Model Integration](guides/model-configuration/predefined-model.md) - * [Custom Model Integration](guides/model-configuration/customizable-model.md) - * [Interfaces](guides/model-configuration/interfaces.md) - * [Schema](guides/model-configuration/schema.md) - * [Load Balancing](guides/model-configuration/load-balancing.md) -* [Application Orchestration](guides/application-orchestrate/README.md) - * [Create Application](guides/application-orchestrate/creating-an-application.md) - * [Chatbot Application](guides/application-orchestrate/chatbot-application.md) - * [Multiple Model Debugging](guides/application-orchestrate/multiple-llms-debugging.md) - * [Agent](guides/application-orchestrate/agent.md) - * [Application Toolkits](guides/application-orchestrate/app-toolkits/README.md) - * [Moderation Tool](guides/application-orchestrate/app-toolkits/moderation-tool.md) -* [Workflow](guides/workflow/README.md) - * [Key Concepts](guides/workflow/key-concepts.md) - * [Variables](guides/workflow/variables.md) - * [Node Description](guides/workflow/node/README.md) - * [Start](guides/workflow/node/start.md) - * [End](guides/workflow/node/end.md) - * [Answer](guides/workflow/node/answer.md) - * [LLM](guides/workflow/node/llm.md) - * [Knowledge Retrieval](guides/workflow/node/knowledge-retrieval.md) - * [Question Classifier](guides/workflow/node/question-classifier.md) - * [Conditional Branch IF/ELSE](guides/workflow/node/ifelse.md) - * [Code Execution](guides/workflow/node/code.md) - * [Template](guides/workflow/node/template.md) - * [Doc Extractor](guides/workflow/node/doc-extractor.md) - * [List Operator](guides/workflow/node/list-operator.md) - * [Variable Aggregator](guides/workflow/node/variable-aggregator.md) - * [Variable Assigner](guides/workflow/node/variable-assigner.md) - * [Iteration](guides/workflow/node/iteration.md) - * [Parameter Extraction](guides/workflow/node/parameter-extractor.md) - * [HTTP Request](guides/workflow/node/http-request.md) - * [Agent](guides/workflow/node/agent.md) - * [Tools](guides/workflow/node/tools.md) - * [Loop](guides/workflow/node/loop.md) - * [Shortcut Key](guides/workflow/shortcut-key.md) - * [Orchestrate Node](guides/workflow/orchestrate-node.md) - * [File Upload](guides/workflow/file-upload.md) - * [Error Handling](guides/workflow/error-handling/README.md) - * [Predefined Error Handling Logic](guides/workflow/error-handling/predefined-error-handling-logic.md) - * [Error Type](guides/workflow/error-handling/error-type.md) - * [Additional Features](guides/workflow/additional-features.md) - * [Debug and Preview](guides/workflow/debug-and-preview/README.md) - * [Preview and Run](guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.md) - * [Step Run](guides/workflow/debug-and-preview/step-run.md) - * [Conversation/Run Logs](guides/workflow/debug-and-preview/log.md) - * [Checklist](guides/workflow/debug-and-preview/checklist.md) - * [Run History](guides/workflow/debug-and-preview/history.md) - * [Application Publishing](guides/workflow/publish.md) - * [Bulletin: Image Upload Replaced by File Upload](guides/workflow/bulletin.md) -* [Knowledge](guides/knowledge-base/README.md) - * [Create Knowledge](guides/knowledge-base/create-knowledge-and-upload-documents.md) - * [1. Import Text Data](guides/knowledge-base/create-knowledge-and-upload-documents/1.-import-text-data/README.md) - * [1.1 Import Data from Notion](guides/knowledge-base/create-knowledge-and-upload-documents/1.-import-text-data/1.1-import-data-from-notion.md) - * [1.2 Import Data from Website](guides/knowledge-base/sync-from-website.md) - * [2. Choose a Chunk Mode](guides/knowledge-base/create-knowledge-and-upload-documents/2.-choose-a-chunk-mode.md) - * [3. Select the Indexing Method and Retrieval Setting](guides/knowledge-base/create-knowledge-and-upload-documents/3.-select-the-indexing-method-and-retrieval-setting.md) - * [Manage Knowledge](guides/knowledge-base/knowledge-and-documents-maintenance.md) - * [Maintain Documents](guides/knowledge-base/knowledge-and-documents-maintenance/maintain-knowledge-documents.md) - * [Maintain Knowledge via API](guides/knowledge-base/knowledge-and-documents-maintenance/maintain-dataset-via-api.md) - * [Metadata](guides/knowledge-base/metadata.md) - * [Integrate Knowledge Base within Application](guides/knowledge-base/integrate-knowledge-within-application.md) - * [Retrieval Test / Citation and Attributions](guides/knowledge-base/retrieval-test-and-citation.md) - * [Knowledge Request Rate Limit](guides/knowledge-base/knowledge-request-rate-limit.md) - * [Connect to an External Knowledge Base](guides/knowledge-base/connect-external-knowledge.md) - * [External Knowledge API](guides/knowledge-base/external-knowledge-api-documentation.md) -* [Tools](guides/tools/README.md) - * [Quick Tool Integration](guides/tools/quick-tool-integration.md) - * [Advanced Tool Integration](guides/tools/advanced-tool-integration.md) - * [Tool Configuration](guides/tools/tool-configuration/README.md) - * [Google](guides/tools/tool-configuration/google.md) - * [Bing](guides/tools/tool-configuration/bing.md) - * [SearchApi](guides/tools/tool-configuration/searchapi.md) - * [StableDiffusion](guides/tools/tool-configuration/stable-diffusion.md) - * [Dall-e](guides/tools/tool-configuration/dall-e.md) - * [Perplexity Search](guides/tools/tool-configuration/perplexity.md) - * [AlphaVantage](guides/tools/tool-configuration/alphavantage.md) - * [Youtube](guides/tools/tool-configuration/youtube.md) - * [SearXNG](guides/tools/tool-configuration/searxng.md) - * [Serper](guides/tools/tool-configuration/serper.md) - * [SiliconFlow (Flux AI Supported)](guides/tools/tool-configuration/siliconflow.md) - * [ComfyUI](guides/tools/tool-configuration/comfyui.md) -* [Publishing](guides/application-publishing/README.md) - * [Publish as a Single-page Web App](guides/application-publishing/launch-your-webapp-quickly/README.md) - * [Web App Settings](guides/application-publishing/launch-your-webapp-quickly/web-app-settings.md) - * [Text Generator Application](guides/application-publishing/launch-your-webapp-quickly/text-generator.md) - * [Conversation Application](guides/application-publishing/launch-your-webapp-quickly/conversation-application.md) - * [Embedding In Websites](guides/application-publishing/embedding-in-websites.md) - * [Developing with APIs](guides/application-publishing/developing-with-apis.md) - * [Re-develop Based on Frontend Templates](guides/application-publishing/based-on-frontend-templates.md) -* [Annotation](guides/annotation/README.md) - * [Logs and Annotation](guides/annotation/logs.md) - * [Annotation Reply](guides/annotation/annotation-reply.md) -* [Monitoring](guides/monitoring/README.md) - * [Data Analysis](guides/monitoring/analysis.md) - * [Integrate External Ops Tools](guides/monitoring/integrate-external-ops-tools/README.md) - * [Integrate LangSmith](guides/monitoring/integrate-external-ops-tools/integrate-langsmith.md) - * [Integrate Langfuse](guides/monitoring/integrate-external-ops-tools/integrate-langfuse.md) - * [Integrate Opik](guides/monitoring/integrate-external-ops-tools/integrate-opik.md) -* [Extension](guides/extension/README.md) - * [API-Based Extension](guides/extension/api-based-extension/README.md) - * [External Data Tool](guides/extension/api-based-extension/external-data-tool.md) - * [Deploy API Tools with Cloudflare Workers](guides/extension/api-based-extension/cloudflare-workers.md) - * [Moderation](guides/extension/api-based-extension/moderation.md) - * [Code-Based Extension](guides/extension/code-based-extension/README.md) - * [External Data Tool](guides/extension/code-based-extension/external-data-tool.md) - * [Moderation](guides/extension/code-based-extension/moderation.md) -* [Collaboration](guides/workspace/README.md) - * [Discover](guides/workspace/app.md) - * [Invite and Manage Members](guides/workspace/invite-and-manage-members.md) -* [Management](guides/management/README.md) - * [App Management](guides/management/app-management.md) - * [Team Members Management](guides/management/team-members-management.md) - * [Personal Account Management](guides/management/personal-account-management.md) - * [Subscription Management](guides/management/subscription-management.md) - * [Version Control](guides/management/version-control.md) - -## Workshop - -* [Basic](workshop/basic/README.md) - * [How to Build an AI Image Generation App](workshop/basic/build-ai-image-generation-app.md) -* [Intermediate](workshop/intermediate/README.md) - * [Build An Article Reader Using File Upload](workshop/intermediate/article-reader.md) - * [Building a Smart Customer Service Bot Using a Knowledge Base](workshop/intermediate/customer-service-bot.md) - * [Generating analysis of Twitter account using Chatflow Agent](workshop/intermediate/twitter-chatflow.md) - -## Community - -* [Seek Support](community/support.md) -* [Become a Contributor](community/contribution.md) -* [Contributing to Dify Documentation](community/docs-contribution.md) - -## Plugins - -* [Introduction](plugins/introduction.md) -* [Quick Start](plugins/quick-start/README.md) - * [Install and Use Plugins](plugins/quick-start/install-plugins.md) - * [Develop Plugins](plugins/quick-start/develop-plugins/README.md) - * [Initialize Development Tools](plugins/quick-start/develop-plugins/initialize-development-tools.md) - * [Tool Plugin](plugins/quick-start/develop-plugins/tool-plugin.md) - * [Model Plugin](plugins/quick-start/develop-plugins/model-plugin/README.md) - * [Create Model Providers](plugins/quick-start/develop-plugins/model-plugin/create-model-providers.md) - * [Integrate the Predefined Model](plugins/quick-start/develop-plugins/model-plugin/predefined-model.md) - * [Integrate the Customizable Model](plugins/quick-start/develop-plugins/model-plugin/customizable-model.md) - * [Agent Strategy Plugin](plugins/quick-start/develop-plugins/agent-strategy-plugin.md) - * [Extension Plugin](plugins/quick-start/develop-plugins/extension-plugin.md) - * [Bundle](plugins/quick-start/develop-plugins/bundle.md) - * [Debug Plugin](plugins/quick-start/debug-plugin.md) -* [Manage Plugins](plugins/manage-plugins.md) -* [Schema Specification](plugins/schema-definition/README.md) - * [Manifest](plugins/schema-definition/manifest.md) - * [Endpoint](plugins/schema-definition/endpoint.md) - * [Tool](plugins/schema-definition/tool.md) - * [Agent](plugins/schema-definition/agent.md) - * [Model](plugins/schema-definition/model/README.md) - * [Model Designing Rules](plugins/schema-definition/model/model-designing-rules.md) - * [Model Schema](plugins/schema-definition/model/model-schema.md) - * [General Specifications](plugins/schema-definition/general-specifications.md) - * [Persistent Storage](plugins/schema-definition/persistent-storage.md) - * [Reverse Invocation of the Dify Service](plugins/schema-definition/reverse-invocation-of-the-dify-service/README.md) - * [App](plugins/schema-definition/reverse-invocation-of-the-dify-service/app.md) - * [Model](plugins/schema-definition/reverse-invocation-of-the-dify-service/model.md) - * [Tool](plugins/schema-definition/reverse-invocation-of-the-dify-service/tool.md) - * [Node](plugins/schema-definition/reverse-invocation-of-the-dify-service/node.md) -* [Best Practice](plugins/best-practice/README.md) - * [Develop a Slack Bot Plugin](plugins/best-practice/develop-a-slack-bot-plugin.md) -* [Publish Plugins](plugins/publish-plugins/README.md) - * [Publish to Dify Marketplace](plugins/publish-plugins/publish-to-dify-marketplace/README.md) - * [Plugin Developer Guidelines](plugins/publish-plugins/publish-to-dify-marketplace/plugin-developer-guidelines.md) - * [Plugin Privacy Protection Guidelines](plugins/publish-plugins/publish-to-dify-marketplace/plugin-privacy-protection-guidelines.md) - * [Publish to Your Personal GitHub Repository](plugins/publish-plugins/publish-plugin-on-personal-github-repo.md) - * [Package the Plugin File and Publish it](plugins/publish-plugins/package-plugin-file-and-publish.md) -* [FAQ](plugins/faq.md) - -## Development - -* [Backend](development/backend/README.md) - * [DifySandbox](development/backend/sandbox/README.md) - * [Contribution Guide](development/backend/sandbox/contribution.md) -* [Models Integration](development/models-integration/README.md) - * [Integrate Open Source Models from Hugging Face](development/models-integration/hugging-face.md) - * [Integrate Open Source Models from Replicate](development/models-integration/replicate.md) - * [Integrate Local Models Deployed by Xinference](development/models-integration/xinference.md) - * [Integrate Local Models Deployed by OpenLLM](development/models-integration/openllm.md) - * [Integrate Local Models Deployed by LocalAI](development/models-integration/localai.md) - * [Integrate Local Models Deployed by Ollama](development/models-integration/ollama.md) - * [Integrate Models on LiteLLM Proxy](development/models-integration/litellm.md) - * [Integrating with GPUStack for Local Model Deployment](development/models-integration/gpustack.md) - * [Integrating AWS Bedrock Models (DeepSeek)](development/models-integration/aws-bedrock-deepseek.md) -* [Migration](development/migration/README.md) - * [Migrating Community Edition to v1.0.0](development/migration/migrate-to-v1.md) - - -## Learn More - -* [Use Cases](learn-more/use-cases/README.md) - * [DeepSeek & Dify Integration Guide: Building AI Applications with Multi-Turn Reasoning](learn-more/use-cases/integrate-deepseek-to-build-an-ai-app.md) - * [Private Deployment of Ollama + DeepSeek + Dify: Build Your Own AI Assistant](learn-more/use-cases/private-ai-ollama-deepseek-dify.md) - * [Build a Notion AI Assistant](learn-more/use-cases/build-an-notion-ai-assistant.md) - * [Create a MidJourney Prompt Bot with Dify](learn-more/use-cases/create-a-midjourney-prompt-bot-with-dify.md) - * [Create an AI Chatbot with Business Data in Minutes](learn-more/use-cases/create-an-ai-chatbot-with-business-data-in-minutes.md) - * [Integrating Dify Chatbot into Your Wix Website](learn-more/use-cases/how-to-integrate-dify-chatbot-to-your-wix-website.md) - * [How to connect with AWS Bedrock Knowledge Base](learn-more/use-cases/how-to-connect-aws-bedrock.md) - * [Building the Dify Scheduler](learn-more/use-cases/dify-schedule.md) - * [Building an AI Thesis Slack Bot on Dify](learn-more/use-cases/building-an-ai-thesis-slack-bot.md) -* [Extended Reading](learn-more/extended-reading/README.md) - * [What is LLMOps?](learn-more/extended-reading/what-is-llmops.md) - * [Retrieval-Augmented Generation (RAG)](learn-more/extended-reading/retrieval-augment/README.md) - * [Hybrid Search](learn-more/extended-reading/retrieval-augment/hybrid-search.md) - * [Re-ranking](learn-more/extended-reading/retrieval-augment/rerank.md) - * [Retrieval Modes](learn-more/extended-reading/retrieval-augment/retrieval.md) - * [How to Use JSON Schema Output in Dify?](learn-more/extended-reading/how-to-use-json-schema-in-dify.md) -* [FAQ](learn-more/faq/README.md) - * [Self-Host](learn-more/faq/install-faq.md) - * [LLM Configuration and Usage](learn-more/faq/use-llms-faq.md) - * [Plugins](learn-more/faq/plugins.md) - -## Policies - -* [Open Source License](policies/open-source.md) -* [User Agreement](policies/agreement/README.md) - * [Terms of Service](https://dify.ai/terms) - * [Privacy Policy](https://dify.ai/privacy) - * [Get Compliance Report](policies/agreement/get-compliance-report.md) - -## Features - -* [Workflow](features/workflow.md) diff --git a/en/link-check-report-error.md b/en/link-check-report-error.md deleted file mode 100644 index dc9c30cb..00000000 --- a/en/link-check-report-error.md +++ /dev/null @@ -1,149 +0,0 @@ -# GitBook铟接检查报告仅错误铟接 - -本报告仅星瀺文档䞭的无效铟接。每行的栌匏䞺 -* [文档标题](文档铟接) | [无效铟接](铟接路埄) ❌ - -## 来自 community/contribution.md - -* [Become a Contributor](/community/contribution) ✅ | [code of conduct](https://github.com/langgenius/.github/blob/main/CODE\_OF\_CONDUCT.md) ❌ | [this guide](https://github.com/langgenius/dify/blob/main/api/core/model\_runtime/README.md) ❌ | [this guide](https://github.com/langgenius/dify/blob/main/api/core/tools/README.md) ❌ - -## 来自 development/models-integration/hugging-face.md - -* [Integrate Open Source Models from Hugging Face](./development/models-integration/hugging-face) ✅ | [registered address](https://huggingface.co/join) ❌ - -## 来自 development/models-integration/litellm.md - -* [Integrate Models on LiteLLM Proxy](./development/models-integration/litellm) ✅ | [LiteLLM Proxy Server](https://docs.litellm.ai/docs/simple\_proxy) ❌ - -## 来自 development/models-integration/localai.md - -* [Integrate Local Models Deployed by LocalAI](./development/models-integration/localai) ✅ | [LocalAI Data query example](https://github.com/go-skynet/LocalAI/blob/master/examples/langchain-chroma/README.md) ❌ - -## 来自 development/models-integration/ollama.md - -* [Integrate Local Models Deployed by Ollama](./development/models-integration/ollama) ✅ | [ollama](<../../.gitbook/assets/ollama (1) ❌ - -## 来自 getting-started/install-self-hosted/environments.md - -* [Environment Variables Explanation](./getting-started/install-self-hosted/environments) ✅ | [https://api.openai.com/v1](https://api.openai.com/v1) ❌ | [tools](https://github.com/langgenius/dify/blob/main/api/core/tools/provider/_position.yaml) ❌ - -## 来自 getting-started/readme/model-providers.md - -* [List of Model Providers](./getting-started/readme/model-providers) ✅ | [contribution.md](../../community/contribution.md "mention") ❌ - -## 来自 guides/extension/api-based-extension/README.md - -* [API-Based Extension](./guides/extension/api-based-extension/README) ✅ | [cloudflare-workers.md](cloudflare-workers.md "mention") ❌ - -## 来自 guides/extension/api-based-extension/external-data-tool.md - -* [External Data Tool](./guides/extension/api-based-extension/external-data-tool) ✅ | [.](./ "mention") ❌ - -## 来自 guides/extension/code-based-extension/external-data-tool.md - -* [External Data Tool](./guides/extension/code-based-extension/external-data-tool) ✅ | [api-based-extension](../api-based-extension/ "mention") ❌ | [.](./ "mention") ❌ - -## 来自 guides/extension/code-based-extension/moderation.md - -* [Moderation](./guides/extension/code-based-extension/moderation) ✅ | [.](./ "mention") ❌ - -## 来自 guides/knowledge-base/connect-external-knowledge.md - -* [Connect to an External Knowledge Base](./guides/knowledge-base/connect-external-knowledge) ✅ | [how-to-connect-aws-bedrock.md](../../learn-more/use-cases/how-to-connect-aws-bedrock.md "mention") ❌ - -## 来自 guides/model-configuration/README.md - -* [Model](./guides/model-configuration/README) ✅ | [Azure OpenAI Service](https://azure.microsoft.com/en-us/products/ai-services/openai-service/) ❌ - -## 来自 guides/model-configuration/customizable-model.md - -* [Custom Model Integration](./guides/model-configuration/customizable-model) ✅ | [Interfaces](https://github.com/langgenius/dify/blob/main/api/core/model\_runtime/docs/en\_US/interfaces.md) ❌ | [llm.py](https://github.com/langgenius/dify-runtime/blob/main/lib/model\_providers/anthropic/llm/llm.py) ❌ - -## 来自 guides/model-configuration/new-provider.md - -* [Add New Provider](./guides/model-configuration/new-provider) ✅ | [AnthropicProvider](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/model_providers/anthropic/anthropic.py) ❌ - -## 来自 guides/model-configuration/predefined-model.md - -* [Predefined Model Integration](./guides/model-configuration/predefined-model) ✅ | [llm.py](https://github.com/langgenius/dify-runtime/blob/main/lib/model_providers/anthropic/llm/llm.py) ❌ - -## 来自 guides/tools/tool-configuration/perplexity.md - -* [Perplexity Search](./guides/tools/tool-configuration/perplexity) ✅ | [Perplexity](https://www.perplexity.ai/settings/api) ❌ - -## 来自 guides/workflow/node/code.md - -* [Code Execution](./guides/workflow/node/code) ✅ | [Variable References](../key-concept) ❌ - -## 来自 guides/workflow/node/llm.md - -* [LLM](./guides/workflow/node/llm) ✅ | [Prompt Expert Mode (discontinued)](../../../learn-more/extended-reading/prompt-engineering/prompt-engineering-1/) ❌ - -## 来自 guides/workflow/node/parameter-extractor.md - -* [Parameter Extraction](./guides/workflow/node/parameter-extractor) ✅ | [tools](../../tools) ❌ - -## 来自 guides/workflow/variables.md - -* [Variables](./guides/workflow/variables) ✅ | [Variable Assigner](./node/variable-assignment) ❌ - -## 来自 learn-more/extended-reading/how-to-use-json-schema-in-dify.md - -* [How to Use JSON Schema Output in Dify?](./learn-more/extended-reading/how-to-use-json-schema-in-dify) ✅ | [Introduction to Structured Outputs](https://cookbook.openai.com/examples/structured\_outputs\_intro) ❌ - -## 来自 learn-more/faq/use-llms-faq.md - -* [LLM Configuration and Usage](./learn-more/faq/use-llms-faq) ✅ | [OpenAI official documentation](https://platform.openai.com/docs/guides/rate-limits) ❌ - -## 来自 learn-more/use-cases/create-a-midjourney-prompt-bot-with-dify.md - -* [Create a MidJourney Prompt Bot with Dify](./learn-more/use-cases/create-a-midjourney-prompt-bot-with-dify) ✅ | [@op7418](https://twitter.com/op7418) ❌ | [@goocarlos](https://twitter.com/goocarlos) ❌ - -## 来自 plugins/best-practice/develop-a-slack-bot-plugin.md - -* [Develop a Slack Bot Plugin](./plugins/best-practice/develop-a-slack-bot-plugin) ✅ | [Initializing the Development Tool](../tool-initialization) ❌ | [Quick Start: Developing an Extension Plugin](../extension) ❌ | [Reverse Invocation: App](../../../api-documentation/fan-xiang-diao-yong-dify-fu-wu/app) ❌ | [Develop an Extension Plugin](../extension) ❌ | [Develop a Model Plugin](../model/) ❌ | [Bundle Plugins: Packaging Multiple Plugins](../bundle) ❌ | [Manifest](../../../api-documentation/manifest) ❌ | [Endpoint](../../../api-documentation/endpoint) ❌ | [Reverse-Calling Dify Services](../../../api-documentation/fan-xiang-diao-yong-dify-fu-wu/) ❌ | [Tools](../../../api-documentation/tool) ❌ | [Models](../../../api-documentation/model/) ❌ - -## 来自 plugins/introduction.md - -* [Introduction](./plugins/introduction) ✅ | [Local file package](publish-plugins/package-and-publish-plugin-file/) ❌ - -## 来自 plugins/quick-start/develop-plugins/agent-strategy-plugin.md - -* [Agent Strategy Plugin](./plugins/quick-start/develop-plugins/agent-strategy-plugin) ✅ | [“Plugin Management”](https://console-plugin.dify.dev/plugins) ❌ - -## 来自 plugins/quick-start/develop-plugins/extension-plugin.md - -* [Extension Plugin](./plugins/quick-start/develop-plugins/extension-plugin) ✅ | [plugin release guide](../publish-plugins/publish-to-dify-marketplace) ❌ | [Minifest](../schema-definition/manifest) ❌ | [Endpoint](../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../guides/tools/) ❌ | [Models](../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../schema-definition/agent) ❌ - -## 来自 plugins/quick-start/develop-plugins/model-plugin/README.md - -* [Model Plugin](./plugins/quick-start/develop-plugins/model-plugin/README) ✅ | [Predefined](../../../guides/model-configuration/predefined-model) ❌ | [Custom](../../../guides/model-configuration/customizable-model) ❌ - -## 来自 plugins/quick-start/develop-plugins/model-plugin/create-model-providers.md - -* [Create Model Providers](./plugins/quick-start/develop-plugins/model-plugin/create-model-providers) ✅ | [Schema](../../schema-definition/) ❌ - -## 来自 plugins/quick-start/develop-plugins/model-plugin/predefined-model.md - -* [Integrate the Predefined Model](./plugins/quick-start/develop-plugins/model-plugin/predefined-model) ✅ | [AIModelEntity](../../schema-definition/model/model-designing-rules) ❌ | [Model Design Rules](../../schema-definition/model/model-designing-rules) ❌ | [plugin release guide](../../publish-plugins/publish-to-dify-marketplace) ❌ | [Minifest](../../schema-definition/manifest) ❌ | [Endpoint](../../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../../guides/tools/) ❌ | [Models](../../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../../schema-definition/agent) ❌ - -## 来自 plugins/quick-start/develop-plugins/tool-plugin.md - -* [Tool Plugin](./plugins/quick-start/develop-plugins/tool-plugin) ✅ | [ProviderConfig](../schema-definition/general-specifications) ❌ | [tool](../schema-definition/tool) ❌ | [plugin release guide](../publish-plugins/publish-to-dify-marketplace) ❌ | [Minifest](../schema-definition/manifest) ❌ | [Endpoint](../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../guides/tools/) ❌ | [Models](../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../schema-definition/agent) ❌ - -## 来自 plugins/schema-definition/endpoint.md - -* [Endpoint](./plugins/schema-definition/endpoint) ✅ | [Quick Start: Rainbow Cat project](../develop-plugins/extension-plugin) ❌ - -## 来自 plugins/schema-definition/tool.md - -* [Tool](./plugins/schema-definition/tool) ✅ | [Quick start: Tools](../develop-plugins/tool-plugin) ❌ - -## 来自 workshop/intermediate/customer-service-bot.md - -* [Building a Smart Customer Service Bot Using a Knowledge Base](./workshop/intermediate/customer-service-bot) ✅ | [how-to-connect-aws-bedrock.md](../../learn-more/use-cases/how-to-connect-aws-bedrock.md "mention") ❌ - -## 来自 workshop/intermediate/twitter-chatflow.md - -* [Generating analysis of Twitter account using Chatflow Agent](./workshop/intermediate/twitter-chatflow) ✅ | [February 2, 2023](https://twitter.com/XDevelopers/status/1621026986784337922?ref\_src=twsrc%5Etfw) ❌ | [X@dify\_ai](https://x.com/dify\_ai) ❌ - diff --git a/en/link-check-report.md b/en/link-check-report.md deleted file mode 100644 index 2e291a79..00000000 --- a/en/link-check-report.md +++ /dev/null @@ -1,252 +0,0 @@ -# GitBook铟接检查报告完敎版 - -本报告星瀺了GitBook文档䞭的所有铟接及其匕甚的文档。每行的栌匏䞺 -* [文档标题](文档铟接) | [匕甚的文档1](铟接1) | [匕甚的文档2](铟接2) | ... - - -## Getting Started - -* [Welcome to Dify](./README) ✅ | [**Quick Start**](https://docs.dify.ai/application/creating-an-application) ✅ | [**self-deploy Dify** ](https://docs.dify.ai/getting-started/install-self-hosted) ✅ | [**integrate open source models**](https://docs.dify.ai/advanced/model-configuration) ✅ | [**specifications and roadmap**](https://docs.dify.ai/getting-started/readme/features-and-specifications) ✅ | [**Star us on GitHub**](https://github.com/langgenius/dify) ✅ - * [Features and Specifications](./getting-started/readme/features-and-specifications) ✅ - * [List of Model Providers](./getting-started/readme/model-providers) ✅ | [here](https://github.com/langgenius/dify/discussions/categories/ideas) ✅ | [contribution.md](../../community/contribution.md "mention") ❌ -* [Dify Community](./getting-started/install-self-hosted/README) ✅ | [GitHub](https://github.com/langgenius/dify) ✅ | [Docker Compose Deployment](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose) ✅ | [Local Source Code Start](https://docs.dify.ai/getting-started/install-self-hosted/local-source-code) ✅ | [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) ✅ - * [Deploy with Docker Compose](./getting-started/install-self-hosted/docker-compose) ✅ | [Docker Desktop installation guide for Mac](https://docs.docker.com/desktop/mac/install/) ✅ | [Docker installation guide](https://docs.docker.com/engine/install/) ✅ | [the Docker Compose installation guide](https://docs.docker.com/compose/install/) ✅ | [Docker Desktop installation guide for using the WSL 2 backend on Windows.](https://docs.docker.com/desktop/windows/install/#wsl-2-backend) ✅ | [README.md](https://github.com/langgenius/dify/blob/main/docker/README.md) ✅ | [Docker documentation](https://docs.docker.com/compose/install/) ✅ | [FAQs](./faqs) ✅ - * [Start with Local Source Code](./getting-started/install-self-hosted/local-source-code) ✅ | [Docker Desktop installation guide for Mac](https://docs.docker.com/desktop/mac/install/) ✅ | [Docker installation guide](https://docs.docker.com/engine/install/) ✅ | [the Docker Compose installation guide](https://docs.docker.com/compose/install/) ✅ | [Docker Desktop installation guide for using the WSL 2 backend on Windows.](https://docs.docker.com/desktop/windows/install/#wsl-2-backend) ✅ | [Link](https://docs.dify.ai/getting-started/install-self-hosted/install-faq#id-14.-what-to-do-if-this-error-occurs-in-text-to-speech) ✅ | [pyenv](https://github.com/pyenv/pyenv) ✅ | [Poetry](https://python-poetry.org/docs/) ✅ | [Node.js v18.x (LTS)](http://nodejs.org/) ✅ | [NPM version 8.x.x](https://www.npmjs.com/) ✅ | [Yarn](https://yarnpkg.com/) ✅ | [https://nodejs.org/en/download](https://nodejs.org/en/download) ✅ | [http://127.0.0.1:3000](http://127.0.0.1:3000/) ✅ - * [Deploy with aaPanel](./getting-started/install-self-hosted/bt-panel) ✅ | [aaPanel installation guide](https://www.aapanel.com/new/download.html#install) ✅ - * [Start Frontend Docker Container Separately](./getting-started/install-self-hosted/start-the-frontend-docker-container) ✅ | [http://127.0.0.1:3000](http://127.0.0.1:3000/) ✅ - * [Environment Variables Explanation](./getting-started/install-self-hosted/environments) ✅ | [https://api.openai.com/v1](https://api.openai.com/v1) ❌ | [https://docs.gunicorn.org/en/stable/design.html#how-many-workers](https://docs.gunicorn.org/en/stable/design.html#how-many-workers) ✅ | [https://weaviate.io/developers/weaviate/manage-data/import#how-to-set-batch-parameters](https://weaviate.io/developers/weaviate/manage-data/import#how-to-set-batch-parameters) ✅ | [Zilliz Cloud](https://docs.zilliz.com/docs/free-trials) ✅ | [MyScale docs](https://myscale.com/docs/en/text-search/#understanding-fts-index-parameters) ✅ | [Analyticdb documentation](https://help.aliyun.com/zh/analyticdb/analyticdb-for-postgresql/support/create-an-accesskey-pair) ✅ | [Analyticdb documentation](https://help.aliyun.com/zh/analyticdb/analyticdb-for-postgresql/getting-started/create-an-instance-1) ✅ | [Analyticdb documentation](https://help.aliyun.com/zh/analyticdb/analyticdb-for-postgresql/getting-started/createa-a-privileged-account) ✅ | [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations) ✅ | [no-reply@dify.ai](mailto:no-reply@dify.ai) ✅ | [no-reply@dify.ai](mailto:no-reply@dify.ai) ✅ | [tools](https://github.com/langgenius/dify/blob/main/api/core/tools/provider/_position.yaml) ❌ | [model providers](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/model_providers/_position.yaml) ✅ - * [FAQs](./getting-started/install-self-hosted/faqs) ✅ | ["Environment Variables Explanation: Mail-related configuration"](https://docs.dify.ai/getting-started/install-self-hosted/environments#mail-related-configuration) ✅ | [Self-Host Related](../../learn-more/faq/install-faq) ✅ -* [Dify Cloud](./getting-started/cloud) ✅ | [out-of-box ](https://cloud.dify.ai/apps) ✅ | [Plans and Pricing](https://dify.ai/pricing) ✅ | [Sandbox plan](http://cloud.dify.ai) ✅ | [Dify Cloud](https://cloud.dify.ai) ✅ | [create an application](../guides/application-orchestrate/creating-an-application) ✅ -* [Dify Premium on AWS](./getting-started/dify-premium-on-aws) ✅ | [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6) ✅ | [Dify Cloud](./cloud) ✅ | [plans](https://dify.ai/pricing) ✅ | [Migrating Community Edition to v1.0.0](https://docs.dify.ai/development/migration/migrate-to-v1) ✅ - -## Guides - -* [Model](./guides/model-configuration/README) ✅ | [OpenAI](https://platform.openai.com/account/api-keys) ✅ | [Azure OpenAI Service](https://azure.microsoft.com/en-us/products/ai-services/openai-service/) ❌ | [Anthropic](https://console.anthropic.com/account/keys) ✅ | [iFLYTEK SPARK](https://www.xfyun.cn/solutions/xinghuoAPI) ✅ | [WENXINYIYAN](https://console.bce.baidu.com/qianfan/ais/console/applicationConsole/application) ✅ | [TONGYI](https://dashscope.console.aliyun.com/api-key\_management?spm=a2c4g.11186623.0.0.3bbc424dxZms9k) ✅ | [Minimax](https://api.minimax.chat/user-center/basic-information/interface-key) ✅ | [Ollama](https://docs.dify.ai/tutorials/model-configuration/ollama) ✅ | [LocalAI](https://github.com/mudler/LocalAI) ✅ | [GPUStack](https://github.com/gpustack/gpustack) ✅ | [Jina Embeddings](https://jina.ai/embeddings/) ✅ | [**Rerank Models**](https://docs.dify.ai/advanced/retrieval-augment/rerank) ✅ | [Jina Reranker](https://jina.ai/reranker) ✅ | [PKCS1\_OAEP](https://pycryptodome.readthedocs.io/en/latest/src/cipher/oaep.html) ✅ | [Hugging Face](../../development/models-integration/hugging-face) ✅ | [Replicate](../../development/models-integration/replicate) ✅ | [Xinference](../../development/models-integration/xinference) ✅ | [OpenLLM](../../development/models-integration/openllm) ✅ - * [Add New Provider](./guides/model-configuration/new-provider) ✅ | [Provider Schema](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/docs/en_US/schema.md) ✅ | [AI Model Entity](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/docs/en_US/schema.md#aimodelentity) ✅ | [`model_credential_schema`](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/docs/en_US/schema.md) ✅ | [YAML configuration information](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/docs/en_US/schema.md) ✅ | [AnthropicProvider](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/model_providers/anthropic/anthropic.py) ❌ | [**Adding Predefined Models**](https://docs.dify.ai/v/zh-hans/guides/model-configuration/predefined-model) ✅ | [**Adding Custom Models**](https://docs.dify.ai/v/zh-hans/guides/model-configuration/customizable-model) ✅ - * [Predefined Model Integration](./guides/model-configuration/predefined-model) ✅ | [Interfaces](https://github.com/langgenius/dify/blob/main/api/core/model_runtime/docs/en_US/interfaces.md) ✅ | [llm.py](https://github.com/langgenius/dify-runtime/blob/main/lib/model_providers/anthropic/llm/llm.py) ❌ - * [Custom Model Integration](./guides/model-configuration/customizable-model) ✅ | [Interfaces](https://github.com/langgenius/dify/blob/main/api/core/model\_runtime/docs/en\_US/interfaces.md) ❌ | [llm.py](https://github.com/langgenius/dify-runtime/blob/main/lib/model\_providers/anthropic/llm/llm.py) ❌ - * [Interfaces](./guides/model-configuration/interfaces) ✅ | [[PromptMessage](#PromptMessage) ✅ | [UserPromptMessage](#UserPromptMessage) ✅ | [SystemPromptMessage](#SystemPromptMessage) ✅ | [UserPromptMessage](#UserPromptMessage) ✅ | [AssistantPromptMessage](#AssistantPromptMessage) ✅ | [ToolPromptMessage](#ToolPromptMessage) ✅ | [[PromptMessageTool](#PromptMessageTool) ✅ | [[LLMResultChunk](#LLMResultChunk) ✅ | [LLMResult](#LLMResult) ✅ | [[LLMResultChunk](#LLMResultChunk) ✅ | [LLMResult](#LLMResult) ✅ | [TextEmbeddingResult](#TextEmbeddingResult) ✅ | [RerankResult](#RerankResult) ✅ - * [Schema](./guides/model-configuration/schema) ✅ | [Provider](#Provider) ✅ | [AIModelEntity](#AIModelEntity) ✅ | [[ModelType](#ModelType) ✅ | [[ConfigurateMethod](#ConfigurateMethod) ✅ | [ProviderCredentialSchema](#ProviderCredentialSchema) ✅ | [ModelCredentialSchema](#ModelCredentialSchema) ✅ | [ModelType](#ModelType) ✅ | [[ModelFeature](#ModelFeature) ✅ | [LLMMode](#LLMMode) ✅ | [[ParameterRule](#ParameterRule) ✅ | [PriceConfig](#PriceConfig) ✅ | [[CredentialFormSchema](#CredentialFormSchema) ✅ | [[CredentialFormSchema](#CredentialFormSchema) ✅ | [FormType](#FormType) ✅ | [[FormOption](#FormOption) ✅ | [[FormShowOnObject](#FormShowOnObject) ✅ | [[FormShowOnObject](#FormShowOnObject) ✅ - * [Load Balancing](./guides/model-configuration/load-balancing) ✅ | [subscribing to SaaS paid services](../../getting-started/cloud) ✅ -* [Application Orchestration](./guides/application-orchestrate/README) ✅ - * [Create Application](./guides/application-orchestrate/creating-an-application) ✅ | [basic concepts](./#application_type) ✅ | [Application Management: Import](https://docs.dify.ai/guides/management/app-management#importing-application) ✅ - * [Chatbot Application](./guides/application-orchestrate/chatbot-application) ✅ | [knowledge](../knowledge-base/) ✅ | [Claude 3.5 Sonnet](https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) ✅ | [Gemini 1.5 Pro](https://ai.google.dev/api/files) ✅ | [Multiple Model Debugging](./multiple-llms-debugging) ✅ | [Publishing](https://docs.dify.ai/guides/application-publishing) ✅ | [WebApp template](https://github.com/langgenius/webapp-conversation) ✅ | [agent](../application-orchestrate/agent) ✅ | [Integrate Knowledge Base within Application](https://docs.dify.ai/guides/knowledge-base/integrate-knowledge-within-application) ✅ - * [Multiple Model Debugging](./guides/application-orchestrate/multiple-llms-debugging) ✅ | [“Model Providers”](https://docs.dify.ai/guides/model-configuration) ✅ - * [Agent](./guides/application-orchestrate/agent) ✅ | [Claude 3.5 Sonnet](https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) ✅ | [Gemini 1.5 Pro](https://ai.google.dev/api/files) ✅ - * [Application Toolkits](./guides/application-orchestrate/app-toolkits/README) ✅ | [applications](../#application_type) ✅ | [Citation and Attribution](https://docs.dify.ai/guides/knowledge-base/retrieval-test-and-citation#id-2.-citation-and-attribution) ✅ | [Annotated Replies](../../annotation/annotation-reply) ✅ - * [Moderation Tool](./guides/application-orchestrate/app-toolkits/moderation-tool) ✅ | [OpenAI's Moderation](https://platform.openai.com/docs/guides/moderation/overview) ✅ -* [Workflow](./guides/workflow/README) ✅ - * [Key Concepts](./guides/workflow/key-concepts) ✅ | [Block Description](node/) ✅ | [Variables](./variables) ✅ | [End node](./node/end) ✅ | [Answer node](./node/answer) ✅ | [start node](./node/start) ✅ | [variables](./variables) ✅ - * [Variables](./guides/workflow/variables) ✅ | [Chatflow](./variables) ✅ | [Variable Assigner](https://docs.dify.ai/guides/workflow/node/variable-assignment) ✅ | [Variable Assigner](./node/variable-assignment) ❌ - * [Node Description](./guides/workflow/node/README) ✅ - * [Start](./guides/workflow/node/start) ✅ | [uploaded files](../file-upload) ✅ - * [End](./guides/workflow/node/end) ✅ | [long story generation workflow](./iteration) ✅ - * [Answer](./guides/workflow/node/answer) ✅ - * [LLM](./guides/workflow/node/llm) ✅ | [model configuration](../../model-configuration/) ✅ | [**citation and attribution**](../../knowledge-base/retrieval-test-and-citation#id-2.-citation-and-attribution) ✅ | [Claude 3.5 Sonnet](https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) ✅ | [File Upload](https://docs.dify.ai/guides/workflow/file-upload) ✅ | [Prompt Expert Mode (discontinued)](../../../learn-more/extended-reading/prompt-engineering/prompt-engineering-1/) ❌ | [official documentation](https://jinja.palletsprojects.com/en/3.1.x/templates/) ✅ | [Error Handling](https://docs.dify.ai/guides/workflow/error-handling) ✅ | [Knowledge Base](../../knowledge-base/) ✅ | [File Upload](../file-upload) ✅ | [Error Handling](https://docs.dify.ai/guides/workflow/error-handling) ✅ - * [Knowledge Retrieval](./guides/workflow/node/knowledge-retrieval) ✅ | [help documentation](https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents) ✅ | [Integrate Knowledge Base within Application](https://docs.dify.ai/guides/knowledge-base/integrate-knowledge-within-application) ✅ | [help documentation](https://docs.dify.ai/guides/knowledge-base/retrieval-test-and-citation) ✅ | [help documentation](https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents#id-5-indexing-methods) ✅ - * [Question Classifier](./guides/workflow/node/question-classifier) ✅ - * [Conditional Branch IF/ELSE](./guides/workflow/node/ifelse) ✅ - * [Code Execution](./guides/workflow/node/code) ✅ | [Introduction](./code) ✅ | [Usage Scenarios](./code) ✅ | [Local Deployment](./code) ✅ | [Security Policies](./code) ✅ | [Variable References](../key-concept) ❌ | [here](https://github.com/langgenius/dify/tree/main/docker/docker-compose.middleware.yaml) ✅ | [Error Handling](https://docs.dify.ai/zh-hans/guides/workflow/error-handling) ✅ - * [Template](./guides/workflow/node/template) ✅ | [documentation](https://jinja.palletsprojects.com/en/3.1.x/templates/) ✅ - * [Doc Extractor](./guides/workflow/node/doc-extractor) ✅ - * [List Operator](./guides/workflow/node/list-operator) ✅ | [MIME types](https://datatracker.ietf.org/doc/html/rfc2046) ✅ | [Features](../additional-features) ✅ - * [Variable Aggregator](./guides/workflow/node/variable-aggregator) ✅ - * [Variable Assigner](./guides/workflow/node/variable-assigner) ✅ | [conversation variables](https://docs.dify.ai/guides/workflow/key-concepts#conversation-variables) ✅ - * [Iteration](./guides/workflow/node/iteration) ✅ | [Code Node](./code) ✅ | [Parameter Extraction](./parameter-extractor) ✅ | [Knowledge Base Retrieval](./knowledge-retrieval) ✅ | [Iteration](./iteration) ✅ | [Tools](./tools) ✅ | [HTTP Request](./http-request) ✅ - * [Parameter Extraction](./guides/workflow/node/parameter-extractor) ✅ | [tools](../../tools) ❌ | [iteration](./iteration) ✅ | [structured parameter conversion](./iteration) ✅ | [iteration node](./iteration) ✅ | [**HTTP Request**](https://docs.dify.ai/guides/workflow/node/http-request) ✅ - * [HTTP Request](./guides/workflow/node/http-request) ✅ | [Error Handling](https://docs.dify.ai/zh-hans/guides/workflow/error-handling) ✅ - * [Agent](./guides/workflow/node/agent) ✅ | [repository](https://github.com/langgenius/dify-plugins) ✅ - * [Tools](./guides/workflow/node/tools) ✅ | [Tool Configuration Guide](https://docs.dify.ai/guides/tools) ✅ | [Error Handling](https://docs.dify.ai/guides/workflow/error-handling) ✅ | [Tool Configuration Guide](https://docs.dify.ai/guides/tools) ✅ - * [Loop](./guides/workflow/node/loop) ✅ - * [Shortcut Key](./guides/workflow/shortcut-key) ✅ - * [Orchestrate Node](./guides/workflow/orchestrate-node) ✅ - * [File Upload](./guides/workflow/file-upload) ✅ | [ChatFlow](./key-concepts) ✅ | [WorkFlow](./key-concepts) ✅ | ["Start Node"](./node/start) ✅ | ["Additional Features"](./additional-features) ✅ | [Start Node"](./node/start) ✅ | [Claude 3.5 Sonnet](https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) ✅ | [integrate external tools](../extension/api-based-extension/external-data-tool) ✅ - * [Error Handling](./guides/workflow/error-handling/README) ✅ | [LLM](../node/llm) ✅ | [HTTP](../node/http-request) ✅ | [Code](../node/code) ✅ | [Tools](../node/tools) ✅ | [predefined error handling logic](./predefined-error-handling-logic) ✅ | [here](https://assets-docs.dify.ai/2024/12/087861aa20e06bb4f8a2bef7e7ae0522.yml) ✅ - * [Predefined Error Handling Logic](./guides/workflow/error-handling/predefined-error-handling-logic) ✅ | [LLM](../node/llm) ✅ | [HTTP](../node/http-request) ✅ | [Code](../node/code) ✅ | [Tool](../node/tools) ✅ | [ct error types](./error-type) ✅ - * [Error Type](./guides/workflow/error-handling/error-type) ✅ | [Code](../node/code) ✅ | [LLM](../node/llm) ✅ | [HTTP](../node/http-request) ✅ - * [Additional Features](./guides/workflow/additional-features) ✅ | [External Data Tools](../extension/api-based-extension/external-data-tool) ✅ - * [Debug and Preview](./guides/workflow/debug-and-preview/README) ✅ - * [Preview and Run](./guides/workflow/debug-and-preview/yu-lan-yu-yun-hang) ✅ - * [Step Run](./guides/workflow/debug-and-preview/step-run) ✅ - * [Conversation/Run Logs](./guides/workflow/debug-and-preview/log) ✅ - * [Checklist](./guides/workflow/debug-and-preview/checklist) ✅ - * [Run History](./guides/workflow/debug-and-preview/history) ✅ - * [Application Publishing](./guides/workflow/publish) ✅ | [Version Control](https://docs.dify.ai/guides/management/version-control) ✅ - * [Bulletin: Image Upload Replaced by File Upload](./guides/workflow/bulletin) ✅ | [File Upload](./file-upload) ✅ | [Features](./additional-features) ✅ | [variable](./variables) ✅ | [Additional Features](./additional-features) ✅ | [Start](./node/start) ✅ | [Start](./node/start) ✅ | [GitHub](https://github.com/langgenius/dify) ✅ | [Discord channel](https://discord.com/invite/FngNHpbcY7) ✅ -* [Knowledge](./guides/knowledge-base/README) ✅ | [“Connect to an External Knowledge Base”](./connect-external-knowledge) ✅ | [External Knowledge Base](./external-knowledge-api-documentation) ✅ - * [Create Knowledge](./guides/knowledge-base/create-knowledge-and-upload-documents) ✅ | [1.-import-text-data](create-knowledge-and-upload-documents/1.-import-text-data/) ✅ | [2.-choose-a-chunk-mode.md](./create-knowledge-and-upload-documents/2.-choose-a-chunk-mode) ✅ | [3.-select-the-indexing-method-and-retrieval-setting.md](./create-knowledge-and-upload-documents/3.-select-the-indexing-method-and-retrieval-setting) ✅ | [integrate it into your application](./integrate-knowledge-within-application) ✅ | [Knowledge Base and Document Maintenance](./knowledge-and-documents-maintenance) ✅ | [**Unstructured ETL**](https://unstructured.io/) ✅ | [environment variables](../../getting-started/install-self-hosted/environments) ✅ | [official documentation](https://docs.unstructured.io/open-source/core-functionality/partitioning) ✅ | [Metadata](https://docs.dify.ai/guides/knowledge-base/metadata) ✅ - * [1. Import Text Data](./guides/knowledge-base/create-knowledge-and-upload-documents/1.-import-text-data/README) ✅ | [subscription plan](https://dify.ai/pricing) ✅ | [subscription plans](https://dify.ai/pricing) ✅ | [1.1-import-data-from-notion.md](./1.1-import-data-from-notion) ✅ | [sync-from-website.md](../../sync-from-website) ✅ - * [1.1 Import Data from Notion](./guides/knowledge-base/create-knowledge-and-upload-documents/1.-import-text-data/1.1-import-data-from-notion) ✅ | [chunking mode](./1.1-import-data-from-notion) ✅ | [indexing method](../3.-select-the-indexing-method-and-retrieval-setting) ✅ | [official Notion documentation](https://developers.notion.com/docs/authorization) ✅ | [Create Integration](https://www.notion.so/my-integrations) ✅ - * [1.2 Import Data from Website](./guides/knowledge-base/sync-from-website) ✅ | [Jina Reader](https://jina.ai/reader/) ✅ | [Firecrawl](https://www.firecrawl.dev/) ✅ | [Firecrawl](https://www.firecrawl.dev/) ✅ | [Jina Reader](https://jina.ai/reader/) ✅ | [Firecrawl website](https://www.firecrawl.dev/) ✅ | [Jina Reader website](https://jina.ai/reader/) ✅ - * [2. Choose a Chunk Mode](./guides/knowledge-base/create-knowledge-and-upload-documents/2.-choose-a-chunk-mode) ✅ | [ETL](https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents#optional-etl-configuration) ✅ | [regex](https://regexr.com/) ✅ | [Set up the Indexing Method](./3.-select-the-indexing-method-and-retrieval-setting) ✅ | [regex](https://regexr.com/) ✅ | [regex](https://regexr.com/) ✅ | [High-Quality Indexing](./3.-select-the-indexing-method-and-retrieval-setting) ✅ | [3.-select-the-indexing-method-and-retrieval-setting.md](./3.-select-the-indexing-method-and-retrieval-setting) ✅ - * [3. Select the Indexing Method and Retrieval Setting](./guides/knowledge-base/create-knowledge-and-upload-documents/3.-select-the-indexing-method-and-retrieval-setting) ✅ | ["Retrieval Settings"](./3.-select-the-indexing-method-and-retrieval-setting) ✅ | [Inverted Index](./3.-select-the-indexing-method-and-retrieval-setting) ✅ | [retrieval-test-and-citation.md](../retrieval-test-and-citation) ✅ - * [Manage Knowledge](./guides/knowledge-base/knowledge-and-documents-maintenance) ✅ | [documentation](./create-knowledge-and-upload-documents/3.-select-the-indexing-method-and-retrieval-setting) ✅ | [documentation](../../learn-more/extended-reading/retrieval-augment/retrieval) ✅ | [maintain-knowledge-documents.md](./knowledge-and-documents-maintenance/maintain-knowledge-documents) ✅ | [maintain-dataset-via-api.md](./knowledge-and-documents-maintenance/maintain-dataset-via-api) ✅ - * [Maintain Documents](./guides/knowledge-base/knowledge-and-documents-maintenance/maintain-knowledge-documents) ✅ | [chunking modes](../create-knowledge-and-upload-documents/2.-choose-a-chunk-mode) ✅ | [General mode](../create-knowledge-and-upload-documents) ✅ | [ Parent-child](./maintain-knowledge-documents) ✅ | [here](https://dify.ai/pricing) ✅ | [Metadata](https://docs.dify.ai/guides/knowledge-base/metadata) ✅ - * [Maintain Knowledge via API](./guides/knowledge-base/knowledge-and-documents-maintenance/maintain-dataset-via-api) ✅ - * [Metadata](./guides/knowledge-base/metadata) ✅ | [Integrate Knowledge Base within Application](https://docs.dify.ai/guides/knowledge-base/integrate-knowledge-within-application) ✅ | [Maintaining Dataset via API](https://docs.dify.ai/guides/knowledge-base/knowledge-and-documents-maintenance/maintain-dataset-via-api) ✅ - * [Integrate Knowledge Base within Application](./guides/knowledge-base/integrate-knowledge-within-application) ✅ | [application type](https://docs.dify.ai/guides/application-orchestrate#application_type) ✅ | [Rerank strategy](https://docs.dify.ai/learn-more/extended-reading/retrieval-augment/rerank) ✅ | [Re-ranking](https://docs.dify.ai/learn-more/extended-reading/retrieval-augment/rerank) ✅ - * [Retrieval Test / Citation and Attributions](./guides/knowledge-base/retrieval-test-and-citation) ✅ | [Retrieval-Augmented Generation (RAG)](../../learn-more/extended-reading/retrieval-augment/) ✅ - * [Knowledge Request Rate Limit](./guides/knowledge-base/knowledge-request-rate-limit) ✅ - * [Connect to an External Knowledge Base](./guides/knowledge-base/connect-external-knowledge) ✅ | [AWS Bedrock](https://aws.amazon.com/bedrock/) ✅ | [External Knowledge Base API](./external-knowledge-api-documentation) ✅ | [External Knowledge API](./external-knowledge-api-documentation) ✅ | [External Knowledge API](./external-knowledge-api-documentation) ✅ | [how-to-connect-aws-bedrock.md](../../learn-more/use-cases/how-to-connect-aws-bedrock.md "mention") ❌ - * [External Knowledge API](./guides/knowledge-base/external-knowledge-api-documentation) ✅ | [Connecting to an External Knowledge Base](https://docs.dify.ai/guides/knowledge-base/connect-external-knowledge-base) ✅ -* [Tools](./guides/tools/README) ✅ | [documentation](https://docs.dify.ai/plugins/introduction) ✅ | [Dify Development Contribution Documentation](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) ✅ | [official documentation](https://swagger.io/specification/) ✅ | [dify-tools-worker](https://github.com/crazywoola/dify-tools-worker) ✅ - * [Quick Tool Integration](./guides/tools/quick-tool-integration) ✅ | [Develop Plugins](https://docs.dify.ai/plugins/quick-start/develop-plugins) ✅ - * [Advanced Tool Integration](./guides/tools/advanced-tool-integration) ✅ | [Develop Plugins](https://docs.dify.ai/plugins/quick-start/develop-plugins) ✅ | [Quick Integration](https://docs.dify.ai/tutorials/quick-tool-integration) ✅ - * [Tool Configuration](./guides/tools/tool-configuration/README) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [StableDiffusion](./stable-diffusion) ✅ | [SearXNG](./searxng) ✅ - * [Google](./guides/tools/tool-configuration/google) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Serp](https://serpapi.com/dashboard) ✅ - * [Bing](./guides/tools/tool-configuration/bing) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Azure platform](https://www.microsoft.com/en-us/bing/apis/bing-web-search-api) ✅ - * [SearchApi](./guides/tools/tool-configuration/searchapi) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [SearchApi](https://www.searchapi.io/) ✅ - * [StableDiffusion](./guides/tools/tool-configuration/stable-diffusion) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [official repository](https://github.com/AUTOMATIC1111/stable-diffusion-webui) ✅ | [pastel-mix](https://huggingface.co/JamesFlare/pastel-mix) ✅ | [variable](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) ✅ - * [Dall-e](./guides/tools/tool-configuration/dall-e) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [OpenAI Platform](https://platform.openai.com/) ✅ | [variables](https://docs.dify.ai/guides/workflow/variables) ✅ - * [Perplexity Search](./guides/tools/tool-configuration/perplexity) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Perplexity](https://www.perplexity.ai/settings/api) ❌ - * [AlphaVantage](./guides/tools/tool-configuration/alphavantage) ✅ | [@zhuhao](https://github.com/hwzhuhao) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [AlphaVantage](https://www.alphavantage.co/support/#api-key) ✅ | [variables](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) ✅ - * [Youtube](./guides/tools/tool-configuration/youtube) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Youtube](https://www.youtube.com/) ✅ | [Google credential site](https://console.cloud.google.com/apis/credentials) ✅ | [Dify Tools page](https://cloud.dify.ai/tools) ✅ - * [SearXNG](./guides/tools/tool-configuration/searxng) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Community Edition](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose) ✅ | [SearXNG installation documentation](https://docs.searxng.org/admin/installation.html) ✅ | [here](https://docs.searxng.org/admin/settings/index.html) ✅ - * [Serper](./guides/tools/tool-configuration/serper) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [Serper platform](https://serper.dev/signup) ✅ - * [SiliconFlow (Flux AI Supported)](./guides/tools/tool-configuration/siliconflow) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [SiliconCloud API management page](https://cloud.siliconflow.cn/account/ak) ✅ | [variables](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) ✅ - * [ComfyUI](./guides/tools/tool-configuration/comfyui) ✅ | [Install and Use Plugins](https://docs.dify.ai/plugins/quick-start/install-plugins) ✅ | [ComfyUI](https://www.comfy.org/) ✅ | [official documentation](https://docs.comfy.org/get_started/gettingstarted) ✅ -* [Publishing](./guides/application-publishing/README) ✅ | [Publish as a Single-page Webapp](launch-your-webapp-quickly/) ✅ | [Embedding In Websites](./embedding-in-websites) ✅ | [Developing with APIs](./developing-with-apis) ✅ | [Based on Frontend Templates](./based-on-frontend-templates) ✅ - * [Publish as a Single-page Web App](./guides/application-publishing/launch-your-webapp-quickly/README) ✅ | [https://udify.app/](https://udify.app/) ✅ | [text-generator.md](./text-generator) ✅ | [conversation-application.md](./conversation-application) ✅ | [web-app-settings.md](./web-app-settings) ✅ | [Embedding In Websites](https://docs.dify.ai/guides/application-publishing/embedding-in-websites) ✅ - * [Web App Settings](./guides/application-publishing/launch-your-webapp-quickly/web-app-settings) ✅ - * [Text Generator Application](./guides/application-publishing/launch-your-webapp-quickly/text-generator) ✅ - * [Conversation Application](./guides/application-publishing/launch-your-webapp-quickly/conversation-application) ✅ | [Citation and Attribution](https://docs.dify.ai/guides/knowledge-base/retrieval-test-and-citation#id-2.-citation-and-attribution) ✅ - * [Embedding In Websites](./guides/application-publishing/embedding-in-websites) ✅ - * [Developing with APIs](./guides/application-publishing/developing-with-apis) ✅ - * [Re-develop Based on Frontend Templates](./guides/application-publishing/based-on-frontend-templates) ✅ | [Conversational app](https://github.com/langgenius/webapp-conversation) ✅ | [Text generation app](https://github.com/langgenius/webapp-text-generator) ✅ -* [Annotation](./guides/annotation/README) ✅ - * [Logs and Annotation](./guides/annotation/logs) ✅ | [pricing page](https://dify.ai/pricing) ✅ | [Community Edition](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose) ✅ - * [Annotation Reply](./guides/annotation/annotation-reply) ✅ -* [Monitoring](./guides/monitoring/README) ✅ - * [Data Analysis](./guides/monitoring/analysis) ✅ - * [Integrate External Ops Tools](./guides/monitoring/integrate-external-ops-tools/README) ✅ - * [Integrate LangSmith](./guides/monitoring/integrate-external-ops-tools/integrate-langsmith) ✅ | [LangSmith](https://www.langchain.com/langsmith) ✅ | [LangSmith](https://www.langchain.com/langsmith) ✅ - * [Integrate Langfuse](./guides/monitoring/integrate-external-ops-tools/integrate-langfuse) ✅ | [https://langfuse.com/](https://langfuse.com/) ✅ | [official website](https://langfuse.com/) ✅ - * [Integrate Opik](./guides/monitoring/integrate-external-ops-tools/integrate-opik) ✅ | [Opik](https://www.comet.com/site/products/opik/) ✅ | [Opik](https://www.comet.com/signup?from=llm) ✅ -* [Extension](./guides/extension/README) ✅ | [api-based-extension](api-based-extension/) ✅ | [code-based-extension](code-based-extension/) ✅ - * [API-Based Extension](./guides/extension/api-based-extension/README) ✅ | [https://ngrok.com](https://ngrok.com/) ✅ | [cloudflare-workers.md](cloudflare-workers.md "mention") ❌ - * [External Data Tool](./guides/extension/api-based-extension/external-data-tool) ✅ | [External Data Tool](https://docs.dify.ai/guides/knowledge-base/external-data-tool) ✅ | [.](./ "mention") ❌ - * [Deploy API Tools with Cloudflare Workers](./guides/extension/api-based-extension/cloudflare-workers) ✅ | [Example GitHub Repository](https://github.com/crazywoola/dify-extension-workers) ✅ | [Cloudflare Workers](https://workers.cloudflare.com/) ✅ | [Cloudflare Workers CLI](https://developers.cloudflare.com/workers/cli-wrangler/install-update) ✅ | [Example GitHub Repository](https://github.com/crazywoola/dify-extension-workers) ✅ - * [Moderation](./guides/extension/api-based-extension/moderation) ✅ - * [Code-Based Extension](./guides/extension/code-based-extension/README) ✅ | [External Data Tool](https://docs.dify.ai/guides/extension/api-based-extension/external-data-tool) ✅ | [Moderation](https://docs.dify.ai/guides/extension/api-based-extension/moderation) ✅ - * [External Data Tool](./guides/extension/code-based-extension/external-data-tool) ✅ | [api-based-extension](../api-based-extension/ "mention") ❌ | [.](./ "mention") ❌ - * [Moderation](./guides/extension/code-based-extension/moderation) ✅ | [.](./ "mention") ❌ -* [Collaboration](./guides/workspace/README) ✅ | [Discover](./app) ✅ - * [Discover](./guides/workspace/app) ✅ - * [Invite and Manage Members](./guides/workspace/invite-and-manage-members) ✅ -* [Management](./guides/management/README) ✅ - * [App Management](./guides/management/app-management) ✅ | [Tool](../workflow/node/tools) ✅ | [Upgrade Dify](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose#upgrade-dify) ✅ - * [Team Members Management](./guides/management/team-members-management) ✅ | [environment variables](https://docs.dify.ai/getting-started/install-self-hosted/environments) ✅ - * [Personal Account Management](./guides/management/personal-account-management) ✅ | [GitHub repository](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) ✅ - * [Subscription Management](./guides/management/subscription-management) ✅ | [Marked replies](https://docs.dify.ai/guides/biao-zhu/logs) ✅ | [Dify pricing](https://dify.ai/pricing) ✅ - * [Version Control](./guides/management/version-control) ✅ - -## Workshop - -* [Basic](./workshop/basic/README) ✅ - * [How to Build an AI Image Generation App](./workshop/basic/build-ai-image-generation-app) ✅ | [Click here](https://platform.stability.ai/account/keys) ✅ | [Dify - Tools - Stability](https://cloud.dify.ai/tools) ✅ | [groq API Management Page](https://console.groq.com/keys) ✅ -* [Intermediate](./workshop/intermediate/README) ✅ - * [Build An Article Reader Using File Upload](./workshop/intermediate/article-reader) ✅ | [File Upload](../../guides/workflow/file-upload) ✅ - * [Building a Smart Customer Service Bot Using a Knowledge Base](./workshop/intermediate/customer-service-bot) ✅ | [Dify help documentation](https://docs.dify.ai) ✅ | [help documentation](https://docs.dify.ai) ✅ | [how-to-connect-aws-bedrock.md](../../learn-more/use-cases/how-to-connect-aws-bedrock.md "mention") ❌ - * [Generating analysis of Twitter account using Chatflow Agent](./workshop/intermediate/twitter-chatflow) ✅ | [wordware.ai](https://www.wordware.ai/) ✅ | [February 2, 2023](https://twitter.com/XDevelopers/status/1621026986784337922?ref\_src=twsrc%5Etfw) ❌ | [crawlbase.com](https://crawlbase.com) ✅ | [https://cloud.dify.ai/signin](https://cloud.dify.ai/signin) ✅ | [Crawlbase docs](https://crawlbase.com/docs/crawling-api/scrapers/#twitter-profile) ✅ | [Crawlbase docs](https://crawlbase.com/docs/crawling-api/scrapers/#twitter-profile) ✅ | [https://crawlbase.com/dashboard/account/docs](https://crawlbase.com/dashboard/account/docs) ✅ | [wordware.ai](http://wordware.ai) ✅ | [X@dify\_ai](https://x.com/dify\_ai) ❌ | [https://github.com/langgenius/dify](https://github.com/langgenius/dify) ✅ - -## Community - -* [Seek Support](./community/support) ✅ | [GitHub](https://github.com/langgenius/dify) ✅ | [Discord community](https://discord.gg/8Tpq4AcN9c) ✅ | [Reddit](https://www.reddit.com/r/difyai/) ✅ | [hello@dify.ai](mailto:hello@dify.ai) ✅ -* [Become a Contributor](./community/contribution) ✅ | [License and Contributor Agreement](https://github.com/langgenius/dify/blob/main/LICENSE) ✅ | [code of conduct](https://github.com/langgenius/.github/blob/main/CODE\_OF\_CONDUCT.md) ❌ | [Find](https://github.com/langgenius/dify/issues?q=is:issue+is:closed) ✅ | [open](https://github.com/langgenius/dify/issues/new/choose) ✅ | [@perzeusss](https://github.com/perzeuss) ✅ | [Feature Request Copilot](https://udify.app/chat/MK2kVSnw1gakVwMX) ✅ | [@yeuoly](https://github.com/Yeuoly) ✅ | [@jyong](https://github.com/JohnJyong) ✅ | [@GarfieldDai](https://github.com/GarfieldDai) ✅ | [@iamjoel](https://github.com/iamjoel) ✅ | [@zxhlyh](https://github.com/zxhlyh) ✅ | [@guchenhe](https://github.com/guchenhe) ✅ | [@crazywoola](https://github.com/crazywoola) ✅ | [@takatost](https://github.com/takatost) ✅ | [community feedback board](https://github.com/langgenius/dify/discussions/categories/ideas) ✅ | [Docker](https://www.docker.com/) ✅ | [Docker Compose](https://docs.docker.com/compose/install/) ✅ | [Node.js v18.x (LTS)](http://nodejs.org) ✅ | [npm](https://www.npmjs.com/) ✅ | [Yarn](https://yarnpkg.com/) ✅ | [Python](https://www.python.org/) ✅ | [Backend README](https://github.com/langgenius/dify/blob/main/api/README.md) ✅ | [Frontend README](https://github.com/langgenius/dify/blob/main/web/README.md) ✅ | [installation FAQ](https://docs.dify.ai/learn-more/faq/install-faq) ✅ | [http://localhost:3000](http://localhost:3000) ✅ | [this guide](https://github.com/langgenius/dify/blob/main/api/core/model\_runtime/README.md) ❌ | [this guide](https://github.com/langgenius/dify/blob/main/api/core/tools/README.md) ❌ | [Dify-docs](https://github.com/langgenius/dify-docs/tree/main/en/guides/tools/tool-configuration) ✅ | [Flask](https://flask.palletsprojects.com/en/3.0.x/) ✅ | [SQLAlchemy](https://www.sqlalchemy.org/) ✅ | [Celery](https://docs.celeryq.dev/en/stable/getting-started/introduction.html) ✅ | [Next.js](https://nextjs.org/) ✅ | [Tailwind CSS](https://tailwindcss.com/) ✅ | [React-i18next](https://react.i18next.com/) ✅ | [GitHub's pull request tutorial](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests) ✅ | [README](https://github.com/langgenius/dify/blob/main/README.md) ✅ | [Discord](https://discord.com/invite/8Tpq4AcN9c) ✅ -* [Contributing to Dify Documentation](./community/docs-contribution) ✅ | [open-source project](https://github.com/langgenius/dify-docs) ✅ | [Issues page](https://github.com/langgenius/dify-docs/issues) ✅ | [Discord](https://discord.com/invite/8Tpq4AcN9c) ✅ - -## Plugins - -* [Introduction](./plugins/introduction) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [GitHub](publish-plugins/publish-plugin-on-personal-github-repo/) ✅ | [Local file package](publish-plugins/package-and-publish-plugin-file/) ❌ | [Quick Start: Model Plugin](https://docs.dify.ai/plugins/quick-start/develop-plugins/model-plugin) ✅ | [Quick Start: Tool Plugin](./quick-start/develop-plugins/tool-plugin) ✅ | [Quick Start: Agent Strategy Plugin](./quick-start/develop-plugins/agent-strategy-plugin) ✅ | [Quick Start: Extension Plugin](./quick-start/develop-plugins/extension-plugin) ✅ | [Plugin Development: Bundle Plugin](./quick-start/develop-plugins/bundle) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [install-plugins.md](./quick-start/install-plugins) ✅ | [develop-plugins](quick-start/develop-plugins/) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [GitHub repository](https://github.com/langgenius/dify-plugins) ✅ | [publish-to-dify-marketplace](publish-plugins/publish-to-dify-marketplace/) ✅ | [publish-to-dify-marketplace](publish-plugins/publish-to-dify-marketplace/) ✅ | [package-plugin-file-and-publish.md](./publish-plugins/package-plugin-file-and-publish) ✅ -* [Quick Start](./plugins/quick-start/README) ✅ | [install-plugins.md](./install-plugins) ✅ | [tool-plugin.md](./develop-plugins/tool-plugin) ✅ | [model-plugin](develop-plugins/model-plugin/) ✅ | [agent-strategy-plugin.md](./develop-plugins/agent-strategy-plugin) ✅ | [extension-plugin.md](./develop-plugins/extension-plugin) ✅ | [bundle.md](./develop-plugins/bundle) ✅ | [schema-definition](../schema-definition/) ✅ - * [Install and Use Plugins](./plugins/quick-start/install-plugins) ✅ | [Publishing Plugins on GitHub](../publish-plugins/publish-plugin-on-personal-github-repo) ✅ | [packaging your plugin](../publish-plugins/package-plugin-file-and-publish) ✅ | [develop-plugins](develop-plugins/) ✅ - * [Develop Plugins](./plugins/quick-start/develop-plugins/README) ✅ | [initialize-development-tools.md](./initialize-development-tools) ✅ | [tool-plugin.md](./tool-plugin) ✅ | [model-plugin](model-plugin/) ✅ | [extension-plugin.md](./extension-plugin) ✅ | [General Specifications](../../schema-definition/general-specifications) ✅ | [Manifest Definitions](../../schema-definition/manifest) ✅ | [Tool Integration Definitions](../../schema-definition/tool) ✅ | [Model Integration Introduction](../../schema-definition/model/) ✅ | [Endpoint Definitions](../../schema-definition/endpoint) ✅ | [Extended Agent Strategy](../../schema-definition/agent) ✅ | [Reverse Invocation of the Dify](../../schema-definition/reverse-invocation-of-the-dify-service/) ✅ | [Reverse Invoking Apps](../../schema-definition/reverse-invocation-of-the-dify-service/app) ✅ | [Reverse Invoking Models](../../schema-definition/reverse-invocation-of-the-dify-service/model) ✅ | [Reverse Invoking Nodes](../../schema-definition/reverse-invocation-of-the-dify-service/node) ✅ | [Reverse Invoking Tools](../../schema-definition/reverse-invocation-of-the-dify-service/tool) ✅ | [Plugin Persistence Storage Capabilities](../../schema-definition/persistent-storage) ✅ | [Dify Plugin Contribution Guidelines](../../publish-plugins/publish-to-dify-marketplace/) ✅ | [GitHub Publishing Guidelines](../../publish-plugins/publish-plugin-on-personal-github-repo) ✅ - * [Initialize Development Tools](./plugins/quick-start/develop-plugins/initialize-development-tools) ✅ | [Dify plugin GitHub page](https://github.com/langgenius/dify-plugin-daemon/releases) ✅ | [Python installation](https://pythontest.com/python/installing-python-3-11/) ✅ | [tool-plugin.md](./tool-plugin) ✅ | [model-plugin](model-plugin/) ✅ | [agent-strategy-plugin.md](./agent-strategy-plugin) ✅ | [extension-plugin.md](./extension-plugin) ✅ | [bundle.md](./bundle) ✅ - * [Tool Plugin](./plugins/quick-start/develop-plugins/tool-plugin) ✅ | [Initializing Development Tools](./initialize-development-tools) ✅ | [Schema Definition](../../schema-definition/) ✅ | [ProviderConfig](../schema-definition/general-specifications) ❌ | [tool](../schema-definition/tool) ❌ | [Dify Plugins code repository](https://github.com/langgenius/dify-plugins) ✅ | [plugin release guide](../publish-plugins/publish-to-dify-marketplace) ❌ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [Develop Extension Type Plugin](./extension-plugin) ✅ | [Develop Model Type Plugin](model-plugin/) ✅ | [Bundle Type Plugin: Package Multiple Plugins](./bundle) ✅ | [Minifest](../schema-definition/manifest) ❌ | [Endpoint](../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../guides/tools/) ❌ | [Models](../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../schema-definition/agent) ❌ - * [Model Plugin](./plugins/quick-start/develop-plugins/model-plugin/README) ✅ | [Create Model Provider](./create-model-providers) ✅ | [Predefined](../../../guides/model-configuration/predefined-model) ❌ | [Custom](../../../guides/model-configuration/customizable-model) ❌ | [Debug Plugin](../../debug-plugin) ✅ - * [Create Model Providers](./plugins/quick-start/develop-plugins/model-plugin/create-model-providers) ✅ | [Initializing Development Tools](../initialize-development-tools) ✅ | [Schema](../../schema-definition/) ❌ | [Develop Predefined Models](../../../../guides/model-configuration/predefined-model) ✅ | [Develop Custom Models](../../../../guides/model-configuration/customizable-model) ✅ - * [Integrate the Predefined Model](./plugins/quick-start/develop-plugins/model-plugin/predefined-model) ✅ | [model provider](./create-model-providers) ✅ | [AIModelEntity](../../schema-definition/model/model-designing-rules) ❌ | [Github repository](https://github.com/langgenius/dify-official-plugins/tree/main/models/anthropic/models/llm) ✅ | [Model Design Rules](../../schema-definition/model/model-designing-rules) ❌ | [Github repository](https://github.com/langgenius/dify-official-plugins/tree/main/models) ✅ | [Github code repository](https://github.com/langgenius/dify-official-plugins/blob/main/models/anthropic/models/llm/llm.py) ✅ | [debug-plugin.md](../../debug-plugin) ✅ | [Dify Plugins code repository](https://github.com/langgenius/dify-plugins) ✅ | [plugin release guide](../../publish-plugins/publish-to-dify-marketplace) ❌ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [Develop Extension Type Plugin](../extension-plugin) ✅ | [Develop Model Type Plugin](./) ✅ | [Bundle Type Plugin: Package Multiple Plugins](../bundle) ✅ | [Minifest](../../schema-definition/manifest) ❌ | [Endpoint](../../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../../guides/tools/) ❌ | [Models](../../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../../schema-definition/agent) ❌ - * [Integrate the Customizable Model](./plugins/quick-start/develop-plugins/model-plugin/customizable-model) ✅ | [Xinference model](https://inference.readthedocs.io/en/latest/) ✅ | [predefined models](./predefined-model) ✅ | [Model Documentation](https://docs.dify.ai/zh-hans/plugins/schema-definition/model) ✅ | [GitHub Repository](https://github.com/langgenius/dify-official-plugins/tree/main/models/xinference) ✅ | [debug-plugin.md](../../debug-plugin) ✅ | [Develop Extension Plugin](../extension-plugin) ✅ | [Develop Tool Plugin](../tool-plugin) ✅ | [Bundle Plugins: Package Multiple Plugins](../bundle) ✅ | [Manifest](../../../schema-definition/manifest) ✅ | [Endpoint](../../../schema-definition/endpoint) ✅ | [Reverse-Invocation of the Dify Service](../../../schema-definition/reverse-invocation-of-the-dify-service/) ✅ | [Tools](../../../schema-definition/tool) ✅ | [Models](../../../schema-definition/model/) ✅ - * [Agent Strategy Plugin](./plugins/quick-start/develop-plugins/agent-strategy-plugin) ✅ | [Initializing the Development Tool](./initialize-development-tools) ✅ | [“Plugin Management”](https://console-plugin.dify.dev/plugins) ❌ | [Dify Plugins repository](https://github.com/langgenius/dify-plugins) ✅ | [Plugin Publishing Guidelines](https://docs.dify.ai/plugins/publish-plugins/publish-to-dify-marketplace) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [complete Function Calling implementation](https://github.com/langgenius/dify-official-plugins/blob/main/agent-strategies/cot_agent/strategies/function_calling.py) ✅ - * [Extension Plugin](./plugins/quick-start/develop-plugins/extension-plugin) ✅ | [Initializing Development Tools](./initialize-development-tools) ✅ | [Dify Plugins code repository](https://github.com/langgenius/dify-plugins) ✅ | [plugin release guide](../publish-plugins/publish-to-dify-marketplace) ❌ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [Develop Extension Type Plugin](./extension-plugin) ✅ | [Develop Model Type Plugin](model-plugin/) ✅ | [Bundle Type Plugin: Package Multiple Plugins](./bundle) ✅ | [Minifest](../schema-definition/manifest) ❌ | [Endpoint](../schema-definition/endpoint) ❌ | [Reverse Invocation of the Dify Service](../schema-definition/reverse-invocation-of-the-dify-service/) ❌ | [Tools](../../guides/tools/) ❌ | [Models](../schema-definition/model/model-schema) ❌ | [Extend Agent Strategy](../schema-definition/agent) ❌ | [Develop a Slack Bot Plugin](../../best-practice/develop-a-slack-bot-plugin) ✅ - * [Bundle](./plugins/quick-start/develop-plugins/bundle) ✅ | [Initializing Development Tools](./initialize-development-tools) ✅ - * [Debug Plugin](./plugins/quick-start/debug-plugin) ✅ | ["Plugin"](https://cloud.dify.ai/plugins) ✅ -* [Manage Plugins](./plugins/manage-plugins) ✅ -* [Schema Specification](./plugins/schema-definition/README) ✅ | [manifest.md](./manifest) ✅ | [endpoint.md](./endpoint) ✅ | [model](model/) ✅ | [general-specifications.md](./general-specifications) ✅ | [persistent-storage.md](./persistent-storage) ✅ | [reverse-invocation-of-the-dify-service](reverse-invocation-of-the-dify-service/) ✅ - * [Manifest](./plugins/schema-definition/manifest) ✅ | [Github repository](https://github.com/langgenius/dify-plugin-sdks/tree/main/python/examples) ✅ | [tool](./tool) ✅ | [model](model/) ✅ | [Endpoints](./endpoint) ✅ | [Plugin Privacy Policy Guidelines](../publish-plugins/publish-to-dify-marketplace/plugin-privacy-protection-guidelines) ✅ - * [Endpoint](./plugins/schema-definition/endpoint) ✅ | [Quick Start: Rainbow Cat project](../develop-plugins/extension-plugin) ❌ | [Github repository](https://github.com/langgenius/dify-plugin-sdks/tree/main/python/examples/neko) ✅ | [ProviderConfig](./general-specifications) ✅ - * [Tool](./plugins/schema-definition/tool) ✅ | [Quick start: Tools](../develop-plugins/tool-plugin) ❌ - * [Agent](./plugins/schema-definition/agent) ✅ | [Semantic Kernel](https://learn.microsoft.com/en-us/semantic-kernel/overview/) ✅ | [Manifest](./manifest) ✅ | [Tool](./tool) ✅ - * [Model](./plugins/schema-definition/model/README) ✅ - * [Model Designing Rules](./plugins/schema-definition/model/model-designing-rules) ✅ | [Provider](./model-designing-rules) ✅ | [AIModelEntity](./model-designing-rules) ✅ - * [Model Schema](./plugins/schema-definition/model/model-schema) ✅ | [OpenAI](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai) ✅ - * [General Specifications](./plugins/schema-definition/general-specifications) ✅ | [IETF BCP 47](https://tools.ietf.org/html/bcp47) ✅ - * [Persistent Storage](./plugins/schema-definition/persistent-storage) ✅ - * [Reverse Invocation of the Dify Service](./plugins/schema-definition/reverse-invocation-of-the-dify-service/README) ✅ | [**App**](./app) ✅ | [**Model**](./model) ✅ | [**Tool**](./tool) ✅ | [**Node**](./node) ✅ - * [App](./plugins/schema-definition/reverse-invocation-of-the-dify-service/app) ✅ - * [Model](./plugins/schema-definition/reverse-invocation-of-the-dify-service/model) ✅ - * [Tool](./plugins/schema-definition/reverse-invocation-of-the-dify-service/tool) ✅ - * [Node](./plugins/schema-definition/reverse-invocation-of-the-dify-service/node) ✅ -* [Best Practice](./plugins/best-practice/README) ✅ | [develop-a-slack-bot-plugin.md](./develop-a-slack-bot-plugin) ✅ - * [Develop a Slack Bot Plugin](./plugins/best-practice/develop-a-slack-bot-plugin) ✅ | [Initializing the Development Tool](../tool-initialization) ❌ | [Python Installation Tutorial](https://pythontest.com/python/installing-python-3-11/) ✅ | [Slack API platform](https://api.slack.com/apps) ✅ | [Quick Start: Developing an Extension Plugin](../extension) ❌ | [Reverse Invocation: App](../../../api-documentation/fan-xiang-diao-yong-dify-fu-wu/app) ❌ | [Dify Marketplace repository](https://github.com/langgenius/dify-plugins) ✅ | [Plugin Publishing Guidelines](https://docs.dify.ai/zh-hans/plugins/publish-plugins/publish-to-dify-marketplace) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [GitHub repository](https://github.com/langgenius/dify-plugins) ✅ | [Develop an Extension Plugin](../extension) ❌ | [Develop a Model Plugin](../model/) ❌ | [Bundle Plugins: Packaging Multiple Plugins](../bundle) ❌ | [Manifest](../../../api-documentation/manifest) ❌ | [Endpoint](../../../api-documentation/endpoint) ❌ | [Reverse-Calling Dify Services](../../../api-documentation/fan-xiang-diao-yong-dify-fu-wu/) ❌ | [Tools](../../../api-documentation/tool) ❌ | [Models](../../../api-documentation/model/) ❌ -* [Publish Plugins](./plugins/publish-plugins/README) ✅ | [code repository](https://github.com/langgenius/dify-plugins) ✅ | [publish-to-dify-marketplace](publish-to-dify-marketplace/) ✅ | [publish-plugin-on-personal-github-repo.md](./publish-plugin-on-personal-github-repo) ✅ | [Package as Local File and Share](./package-plugin-file-and-publish) ✅ - * [Publish to Dify Marketplace](./plugins/publish-plugins/publish-to-dify-marketplace/README) ✅ | [GitHub repository](https://github.com/langgenius/dify-plugins) ✅ | [Plugin Developer Guidelines](./plugin-developer-guidelines) ✅ | [Plugin Privacy Policy](./plugin-privacy-protection-guidelines) ✅ | [Manifest](../../schema-definition/manifest) ✅ | [Dify Plugins](https://github.com/langgenius/dify-plugins) ✅ | [Dify Marketplace](https://marketplace.dify.ai/) ✅ | [Plugin Developer Guidelines](./plugin-developer-guidelines) ✅ | [Manifest](https://docs.dify.ai/plugins/schema-definition/manifest) ✅ | [Plugin Development Guidelines](./plugin-developer-guidelines) ✅ | [Dify.AI](https://dify.ai/) ✅ - * [Plugin Developer Guidelines](./plugins/publish-plugins/publish-to-dify-marketplace/plugin-developer-guidelines) ✅ | [Plugin Privacy Protection Guidelines](./plugin-developer-guidelines) ✅ - * [Plugin Privacy Protection Guidelines](./plugins/publish-plugins/publish-to-dify-marketplace/plugin-privacy-protection-guidelines) ✅ | [Slack’s privacy policy](https://slack.com/trust/privacy/privacy-policy) ✅ | [Manifest](https://docs.dify.ai/plugins/schema-definition/manifest) ✅ - * [Publish to Your Personal GitHub Repository](./plugins/publish-plugins/publish-plugin-on-personal-github-repo) ✅ | [GitHub documentation](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository) ✅ - * [Package the Plugin File and Publish it](./plugins/publish-plugins/package-plugin-file-and-publish) ✅ | [official GitHub releases page](https://github.com/langgenius/dify-plugin-daemon/releases) ✅ | [Initialize Development Tools](../quick-start/develop-plugins/initialize-development-tools) ✅ -* [FAQ](./plugins/faq) ✅ - -## Development - -* [Backend](./development/backend/README) ✅ - * [DifySandbox](./development/backend/sandbox/README) ✅ | [DifySandbox](https://github.com/langgenius/dify-sandbox) ✅ | [Contribution Guide](./contribution) ✅ - * [Contribution Guide](./development/backend/sandbox/contribution) ✅ -* [Models Integration](./development/models-integration/README) ✅ - * [Integrate Open Source Models from Hugging Face](./development/models-integration/hugging-face) ✅ | [text-generation](https://huggingface.co/models?pipeline\_tag=text-generation\&sort=trending) ✅ | [text2text-generation](https://huggingface.co/models?pipeline\_tag=text2text-generation\&sort=trending) ✅ | [feature-extraction](https://huggingface.co/models?pipeline\_tag=feature-extraction\&sort=trending) ✅ | [registered address](https://huggingface.co/join) ❌ | [obtain address](https://huggingface.co/settings/tokens) ✅ | [Hugging Face model list page](https://huggingface.co/models?pipeline\_tag=text-generation\&sort=trending) ✅ | [Inference Endpoints](https://huggingface.co/docs/inference-endpoints/guides/access) ✅ | [User name](https://huggingface.co/settings/account) ✅ | [Organization Name](https://ui.endpoints.huggingface.co/) ✅ - * [Integrate Open Source Models from Replicate](./development/models-integration/replicate) ✅ | [Language models](https://replicate.com/collections/language-models) ✅ | [Embedding models](https://replicate.com/collections/embedding-models) ✅ | [registered address](https://replicate.com/signin?next=/docs) ✅ | [get address](https://replicate.com/signin?next=/docs) ✅ | [Language models](https://replicate.com/collections/language-models) ✅ | [Embedding models](https://replicate.com/collections/embedding-models) ✅ - * [Integrate Local Models Deployed by Xinference](./development/models-integration/xinference) ✅ | [Xorbits inference](https://github.com/xorbitsai/inference) ✅ | [local deployment](https://github.com/xorbitsai/inference/blob/main/README.md#local) ✅ | [distributed deployment](https://github.com/xorbitsai/inference/blob/main/README.md#distributed) ✅ | [Xinference built-in models](https://inference.readthedocs.io/en/latest/models/builtin/index.html) ✅ | [Xinference builtin models](https://github.com/xorbitsai/inference/blob/main/README.md#builtin-models) ✅ | [Xorbits Inference](https://github.com/xorbitsai/inference) ✅ - * [Integrate Local Models Deployed by OpenLLM](./development/models-integration/openllm) ✅ | [OpenLLM](https://github.com/bentoml/OpenLLM) ✅ | [Supported Model List](https://github.com/bentoml/OpenLLM#-supported-models) ✅ | [OpenLLM](https://github.com/bentoml/OpenLLM) ✅ - * [Integrate Local Models Deployed by LocalAI](./development/models-integration/localai) ✅ | [LocalAI](https://github.com/go-skynet/LocalAI) ✅ | [Getting Started](https://localai.io/basics/getting_started/) ✅ | [LocalAI Data query example](https://github.com/go-skynet/LocalAI/blob/master/examples/langchain-chroma/README.md) ❌ - * [Integrate Local Models Deployed by Ollama](./development/models-integration/ollama) ✅ | [ollama](<../../.gitbook/assets/ollama (1) ❌ | [Ollama](https://github.com/jmorganca/ollama) ✅ | [https://ollama.com/download](https://ollama.com/download) ✅ | [Ollama Models](https://ollama.com/library) ✅ | [FAQ](#faq) ✅ - * [Integrate Models on LiteLLM Proxy](./development/models-integration/litellm) ✅ | [LiteLLM Proxy](https://github.com/BerriAI/litellm) ✅ | [Detailed docs on how to setup litellm config - here](https://docs.litellm.ai/docs/proxy/configs) ✅ | [LiteLLM](https://github.com/BerriAI/litellm) ✅ | [LiteLLM Proxy Server](https://docs.litellm.ai/docs/simple\_proxy) ❌ - * [Integrating with GPUStack for Local Model Deployment](./development/models-integration/gpustack) ✅ | [GPUStack](https://github.com/gpustack/gpustack) ✅ | [Documentation](https://docs.gpustack.ai) ✅ | [Github Repo](https://github.com/gpustack/gpustack) ✅ - * [Integrating AWS Bedrock Models (DeepSeek)](./development/models-integration/aws-bedrock-deepseek) ✅ | [AWS Bedrock Marketplace](https://aws.amazon.com/bedrock/marketplace/) ✅ | [Bedrock](https://aws.amazon.com/bedrock/) ✅ | [Dify.AI account](https://cloud.dify.ai/) ✅ -* [Migration](./development/migration/README) ✅ - * [Migrating Community Edition to v1.0.0](./development/migration/migrate-to-v1) ✅ | [v1.0.0](https://github.com/langgenius/dify/releases/tag/1.0.0) ✅ | [Dify project](https://github.com/langgenius/dify) ✅ | [documentation](https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/docker-compose) ✅ - -## Learn More - -* [Use Cases](./learn-more/use-cases/README) ✅ - * [DeepSeek & Dify Integration Guide: Building AI Applications with Multi-Turn Reasoning](./learn-more/use-cases/integrate-deepseek-to-build-an-ai-app) ✅ | [**Private Deployment of DeepSeek + Dify: Build Your Own AI Assistant**](./private-ai-ollama-deepseek-dify) ✅ | [DeepSeek API Platform](https://platform.deepseek.com/) ✅ | [local deployment guide](./private-ai-ollama-deepseek-dify) ✅ | [Retrieval-Augmented Generation (RAG)](https://docs.dify.ai/zh-hans/learn-more/extended-reading/retrieval-augment) ✅ | [Create a Knowledge Base](https://docs.dify.ai/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents) ✅ | [Workflow](https://docs.dify.ai/zh-hans/guides/workflow) ✅ | [File Upload](https://docs.dify.ai/zh-hans/guides/workflow/file-upload) ✅ | [Deploy DeepSeek + Dify Locally to Build a Private AI Assistant](./private-ai-ollama-deepseek-dify) ✅ - * [Private Deployment of Ollama + DeepSeek + Dify: Build Your Own AI Assistant](./learn-more/use-cases/private-ai-ollama-deepseek-dify) ✅ | [Docker](https://www.docker.com/) ✅ | [Ollama](https://ollama.com/) ✅ | [Dify Community Edition](https://github.com/langgenius/dify) ✅ | [Ollama](https://ollama.com/) ✅ | [Ollama's official website](https://ollama.com/) ✅ | [Deploy with Docker Compose](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose) ✅ | [FAQ](https://docs.dify.ai/learn-more/use-cases/private-ai-ollama-deepseek-dify#id-1.-connection-errors-when-using-docker) ✅ | [DeepSeek model specifications](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-7B) ✅ | [Workflow Documentation](https://docs.dify.ai/guides/workflow) ✅ | [Load Balancing](https://docs.dify.ai/guides/model-configuration/load-balancing) ✅ | [Error Handling](https://docs.dify.ai/guides/workflow/error-handling) ✅ - * [Build a Notion AI Assistant](./learn-more/use-cases/build-an-notion-ai-assistant) ✅ | [Dify](https://dify.ai/) ✅ | [here](https://dify.ai/) ✅ | [project](https://github.com/langgenius/dify) ✅ | [​](https://wsyfin.com/notion-dify#3-connect-with-notion-and-datasets) ✅ | [​](https://wsyfin.com/notion-dify#4-start-training) ✅ | [​](https://wsyfin.com/notion-dify#5-create-your-ai-application) ✅ | [​](https://wsyfin.com/notion-dify#1-generate-api-secret-key) ✅ | [​](https://wsyfin.com/notion-dify#2-retrieve-conversation-id) ✅ | [​](https://wsyfin.com/notion-dify#3-invoke-api) ✅ | [​](https://wsyfin.com/notion-dify#sync-with-notion-periodically) ✅ | [​](https://wsyfin.com/notion-dify#summary) ✅ | [Dify](https://dify.ai/) ✅ - * [Create a MidJourney Prompt Bot with Dify](./learn-more/use-cases/create-a-midjourney-prompt-bot-with-dify) ✅ | [@op7418](https://twitter.com/op7418) ❌ | [@goocarlos](https://twitter.com/goocarlos) ❌ - * [Create an AI Chatbot with Business Data in Minutes](./learn-more/use-cases/create-an-ai-chatbot-with-business-data-in-minutes) ✅ | [ GitHub](https://github.com/langgenius/dify) ✅ | [Didy.AI ](https://dify.ai/) ✅ - * [Integrating Dify Chatbot into Your Wix Website](./learn-more/use-cases/how-to-integrate-dify-chatbot-to-your-wix-website) ✅ | [Dify AI application](https://docs.dify.ai/guides/application-orchestrate/creating-an-application) ✅ - * [How to connect with AWS Bedrock Knowledge Base](./learn-more/use-cases/how-to-connect-aws-bedrock) ✅ | [external knowledge base API](https://docs.dify.ai/guides/knowledge-base/external-knowledge-api-documentation) ✅ | [AWS Bedrock](https://aws.amazon.com/bedrock/) ✅ | [API definition](../../guides/knowledge-base/external-knowledge-api-documentation) ✅ | [Step 2](./how-to-connect-aws-bedrock) ✅ | [Step 2](./how-to-connect-aws-bedrock) ✅ - * [Building the Dify Scheduler](./learn-more/use-cases/dify-schedule) ✅ | [Leo\_chen](https://github.com/leochen-g) ✅ | [Dify Schedule](https://github.com/leochen-g/dify-schedule) ✅ | [Smart WeChat Assistant](https://github.com/leochen-g/wechat-assistant-pro) ✅ | [Dify Schedule Repository](https://github.com/leochen-g/dify-schedule) ✅ | [Pushplus](http://www.pushplus.plus/) ✅ | [Server Chan](https://sct.ftqq.com/) ✅ | [Smart WeChat Assistant](https://wechat.aibotk.com/?r=dBL0Bn\&f=difySchedule) ✅ | [Project Link](https://github.com/whyour/qinglong) ✅ | [project page](https://github.com/whyour/qinglong) ✅ - * [Building an AI Thesis Slack Bot on Dify](./learn-more/use-cases/building-an-ai-thesis-slack-bot) ✅ | [official Slack website](https://slack.com/intl/en-gb/get-started?entry_point=help_center#/createnew) ✅ | [Slack API Management Page](https://api.slack.com/apps) ✅ -* [Extended Reading](./learn-more/extended-reading/README) ✅ - * [What is LLMOps?](./learn-more/extended-reading/what-is-llmops) ✅ - * [Retrieval-Augmented Generation (RAG)](./learn-more/extended-reading/retrieval-augment/README) ✅ - * [Hybrid Search](./learn-more/extended-reading/retrieval-augment/hybrid-search) ✅ - * [Re-ranking](./learn-more/extended-reading/retrieval-augment/rerank) ✅ | [https://cohere.com/rerank](https://cohere.com/rerank) ✅ | [Multi-path Retrieval](https://docs.dify.ai/guides/knowledge-base/integrate-knowledge-within-application#multi-path-retrieval-recommended) ✅ - * [Retrieval Modes](./learn-more/extended-reading/retrieval-augment/retrieval) ✅ - * [How to Use JSON Schema Output in Dify?](./learn-more/extended-reading/how-to-use-json-schema-in-dify) ✅ | [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs/introduction) ✅ | [Supported Schemas](https://platform.openai.com/docs/guides/structured-outputs/supported-schemas) ✅ | [additionalProperties: false](https://platform.openai.com/docs/guides/structured-outputs/additionalproperties-false-must-always-be-set-in-objects) ✅ | [Introduction to Structured Outputs](https://cookbook.openai.com/examples/structured\_outputs\_intro) ❌ | [Structured Output](https://platform.openai.com/docs/guides/structured-outputs/json-mode?context=without\_parse) ✅ -* [FAQ](./learn-more/faq/README) ✅ | [Self hosted / local deployment frequently asked questions (FAQs)](https://docs.dify.ai/learn-more/faq/install-faq) ✅ | [LLM configuration and usage frequently asked questions (FAQs)](https://docs.dify.ai/learn-more/faq/use-llms-faq) ✅ - * [Self-Host](./learn-more/faq/install-faq) ✅ | [Environment Variables](../../getting-started/install-self-hosted/environments) ✅ | [**Notion Integration Configuration Address**](https://www.notion.so/my-integrations) ✅ | [Environment Variables Documentation](https://docs.dify.ai/v/zh-hans/getting-started/install-self-hosted/environments) ✅ | [Environment Variables Documentation](https://docs.dify.ai/v/zh-hans/getting-started/install-self-hosted/environments) ✅ | [Issue](https://github.com/langgenius/dify/issues/1261) ✅ | [FFmpeg Official Website](https://ffmpeg.org/download.html) ✅ | [this article](https://portswigger.net/web-security/ssrf) ✅ | [squid configuration documentation](http://www.squid-cache.org/Doc/config/) ✅ | [business@dify.ai](mailto:business@dify.ai) ✅ - * [LLM Configuration and Usage](./learn-more/faq/use-llms-faq) ✅ | [documentation](https://platform.openai.com/docs/models/overview) ✅ | [cosine similarity](https://en.wikipedia.org/wiki/Cosine_similarity) ✅ | [OpenAI official documentation](https://platform.openai.com/docs/guides/rate-limits) ❌ | [documentation](https://docs.dify.ai/v/zh-hans/getting-started/faq/install-faq#11.-ben-di-bu-shu-ban-ru-he-jie-jue-shu-ju-ji-wen-dang-shang-chuan-de-da-xiao-xian-zhi-he-shu-liang) ✅ | [this documentation](https://docs.dify.ai/v/zh-hans/advanced/datasets) ✅ | [OpenAI pricing documentation](https://openai.com/pricing) ✅ | [OpenAI official documentation](https://platform.openai.com/account/billing/overview) ✅ - * [Plugins](./learn-more/faq/plugins) ✅ - -## Policies - -* [Open Source License](./policies/open-source) ✅ | [LICENSE](https://github.com/langgenius/dify/blob/main/LICENSE) ✅ | [business@dify.ai](mailto:business@dify.ai) ✅ -* [User Agreement](./policies/agreement/README) ✅ | [Terms of Service](https://dify.ai/terms) ✅ | [Privacy Policy](https://dify.ai/privacy) ✅ | [get-compliance-report.md](./get-compliance-report) ✅ - * [Terms of Service](https://dify.ai/terms) ✅ - * [Privacy Policy](https://dify.ai/privacy) ✅ - * [Get Compliance Report](./policies/agreement/get-compliance-report) ✅ | [Pricing](https://dify.ai/pricing) ✅ - -## Features - -* [Workflow](./features/workflow) ✅ | [Workflow](https://docs.dify.ai/guides/workflow) ✅ diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx index a0e1882d..541c69de 100644 --- a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx @@ -2,26 +2,53 @@ title: 调试节点 --- -Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关联。若芁确保应甚敎䜓运行正垞需芁确讀每䞪节点的蟓入蟓出笊合预期。调试工具将垮助匀发者检测应甚是吊按照讟计预期提䟛服务提前暎露问题。 +Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关联。若芁确保应甚敎䜓运行正垞需芁确讀每䞪节点的蟓入蟓出笊合预期。调试节点功胜可以垮助匀发者检测应甚是吊按照讟计预期提䟛服务提前发现并解决朜圚问题避免圚生产环境䞭出现错误。 -䜠可以通过以䞋䞀种暡匏调试应甚。 +䜠可以通过以䞋䞀种暡匏调试节点。 ## 单步调试 -单步调试指的是对工䜜流内的某䞪节点进行单独调试。䟋劂圚工䜜流内添加了䞀䞪 HTTP 节点䞺确保该节点胜借正确运行䞍圱响其它节点。匀发者可以点击节点右䞊角的 **run step** 按钮䜿甚单步调试功胜暡拟节点的蟓入蟓出数据。 +单步调试允讞䜠对工䜜流内的特定节点进行独立测试无需执行敎䞪工䜜流。它可以垮助匀发者圚应甚内添加新节点时验证其功胜、排查特定节点的错误以及测试节点对䞍同蟓入的响应。 -调试完成后䜠可以看到圓前节点的运行状态、蟓入/蟓出、元数据信息。劂遇报错可通过报错信息快速排查错误避免节点匂垞富臎的应甚敎䜓运行倱莥。 +### 操䜜步骀 + +1. 圚工䜜流猖蟑界面选择需芁调试的节点 +2. 点击节点右䞊角的 **run step** 按钮 +3. 圚匹出的调试面板䞭填写该节点的蟓入变量 +4. 点击执行按钮觊发节点运行 +5. 查看节点的蟓出结果及运行状态 + +䟋劂圚工䜜流内添加了䞀䞪 HTTP 节点䞺验证该节点胜吊正确获取并倄理 API 响应䜠可以䜿甚单步调试功胜暡拟节点的实际工䜜状态而䞍䌚圱响䞋枞节点。 ![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) +调试完成后䜠可以看到圓前节点的运行状态、蟓入/蟓出、元数据信息。劂遇报错可通过报错信息快速排查错误避免节点匂垞富臎的应甚敎䜓运行倱莥。 + + + 回答、结束节点䞍支持单步调试。 + + ## 逐步执行 -单步调试䞻芁甚于单䞪节点的蟓入蟓出调试。而逐步执行曎加适合于需芁䞊枞节点配合调试的节点场景。䟋劂 B 节点的功胜䟝赖于 A 节点的蟓出结果䜿甚逐步调试功胜可以曎加高效的验证倚䞪节点流的工䜜效果。 +逐步执行适甚于测试倚䞪盞互䟝赖的节点组合特别是圓节点的蟓入䟝赖于䞊枞节点的蟓出时。䞎单步调试䞍同逐步执行䌚从起始节点匀始按照工䜜流路埄䟝次执行到指定节点。 -点击右䞊角的 run to 按钮将启甚逐步执行按钮。调试过皋将从匀始节点执行到圓前节点䜠可以圚歀过皋䞭观测到䞀小段节点的运行情况基于结果及时调敎节点的规划合理性、路埄最䌘性。 +### 操䜜步骀 + +1. 圚工䜜流猖蟑界面选择需芁䜜䞺终点的目标节点 +2. 点击该节点右䞊角的 **run to** 按钮激掻逐步执行功胜 +3. 系统将从起始节点匀始按照工䜜流路埄䟝次执行至目标节点 +4. 执行完成后可查看每䞪节点的运行状态和蟓出结果 + +假讟䜠有䞀䞪包含数据获取(A节点)→数据倄理(B节点)→结果展瀺(C节点)的工䜜流B节点的功胜完党䟝赖于A节点的蟓出。䜿甚逐步执行功胜䜠可以选择B节点并点击"run to"系统将先执行A节点再执行B节点让䜠胜借验证䞀䞪节点之闎的数据䌠递是吊正垞。 + +逐步执行过皋䞭䜠可以观察局郚工䜜流的运行情况基于结果及时调敎节点的配眮、数据流向和倄理逻蟑确保工䜜流的效率和准确性。 ![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) + + 对于问题分类节点、条件节点等存圚倚分支倄理情况䞍支持逐步执行功胜。 + + ## 查看节点调试记圕 每䞪节点运行完成后郜䌚生成操䜜日志䜠可以点击节点诊情页䞭的 Last run 查看运行历史。 diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index bc52b71a..4a109aaa 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -4,12 +4,12 @@ title: 预览应甚 圚 AI 应甚从匀发环境迈向真实甚户的过皋䞭䞺确保最终亀付莚量建议匀发者以甚户视角预览应甚最终的呈现效果确保应甚胜借从匀发阶段无猝过枡到生产阶段。 -圚 Dify 平台䞭“预览”和“运行”是䞀䞪密切盞关䜆甚途䞍同的抂念 +圚 Dify 平台䞭**预览应甚** 和 **运行应甚** 是䞀䞪密切盞关䜆甚途䞍同的抂念 -- **预览**圚匀发环境䞭以最终甚户的视角䜓验和验证应甚功胜。 -- **运行**应甚郚眲后实际面向真实甚户执行的状态。 +- **预览应甚**圚匀发环境䞭以最终甚户的视角䜓验和验证应甚功胜。 +- **运行应甚**应甚郚眲后实际面向真实甚户执行的状态。 -本文将重点介绍劂䜕䜿甚“预览”功胜以及圚应甚发垃前需芁关泚的莚量保障芁点。 +本文将介绍劂䜕䜿甚 **预览应甚** 功胜以及圚应甚发垃前需芁关泚的莚量保障芁点。 ## 䞺什么芁预览应甚 @@ -37,14 +37,14 @@ title: 预览应甚 **自劚检查枅单** -系统将自劚检查每䞪节点的配眮和连线状态劂存圚匂垞将圚页面右䞊角提瀺。将应甚正匏发垃至生产环境前建议检查应甚是吊已通过所有检查项。 +系统将自劚检查每䞪节点的配眮和连线状态。劂存圚匂垞将圚应甚右䞊角提瀺。将应甚正匏发垃至生产环境前建议检查应甚是吊已通过所有检查项。 ![](https://assets-docs.dify.ai/2025/04/e439c296d22c001066cfcf57d5a1b267.png) -## 调试节点 +### 调试节点 -若发现郚分节点运行匂垞富臎应甚预览倱莥或者匀发者垌望通过䌘化郚分节点从而提升敎䜓应甚衚现可以针对应甚䞭的节点进行调试。诊细诎明请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 +预览应甚功胜时若发现郚分节点运行匂垞富臎敎䜓运行倱莥亊或是匀发者垌望通过䌘化郚分节点从而提升敎䜓应甚衚现可以针对应甚䞭的节点进行调试。诊细诎明请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 ## 查看应甚运行历史 -应甚的运行历史可以垮助匀发者监视各䞪环节的运行情况。䜠可以圚“运行历史”䞭查看每䞀蜮对话的执行记圕和各节点的运行日志垮助倍盘问题䞎䌘化逻蟑。诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 +预览应甚时将自劚生成应甚运行历史它可以垮助匀发者监视各䞪环节的运行情况记圕节点的蟓入蟓出数据。䜠可以圚“运行历史”䞭查看每䞀蜮对话的执行记圕和各节点的运行日志垮助倍盘问题䞎䌘化逻蟑。诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx index a508b5c9..db12ccf6 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx @@ -8,12 +8,13 @@ title: 变量池 / 变量检视噚 ## 功胜䞎价倌 -[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量䞍仅承蜜甚户蟓入䞎暡型蟓出还甚于保存对话历史䞊䞋文、配眮参数等场景。变量池可以垮助匀发者曎奜的管理各䞪变量提䟛以䞋功胜场景 +[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量承蜜着从甚户蟓入到暡型蟓出的各类数据包括对话历史䞊䞋文、配眮参数等。变量池䜜䞺䞓闚的变量管理工具提䟛以䞋栞心功胜 -- **可视化变量流蜬**枅晰查看每䞪节点的蟓出结果䞎其对应变量倌 -- **蟅助调试分析**快速定䜍节点䞭出现匂垞数据或结构错误提升排查效率 -- **灵掻变量暡拟**支持手劚修改变量倌暡拟䞍同蟓入或蟹界条件 -- **党局变量管理**集䞭查看应甚内的所有环境变量、系统变量、节点变量等理解圓前工䜜流的运行状态。 +- **实时变量监控**自劚捕获并星瀺节点执行后产生的所有变量倌实时反映工䜜流的运行状态 +- **倚层级数据展瀺**支持展匀对象和数组类型变量查看嵌套结构䞭的具䜓数据内容 +- **变量倌猖蟑䞎暡拟**允讞匀发者手劚修改倧倚数类型变量的倌无需重新运行䞊枞节点即可测试䞍同条件䞋的工䜜流行䞺 +- **匂垞数据远螪**星瀺变量类型䞎实际倌垮助快速定䜍数据栌匏䞍匹配或结构错误等问题 +- **党局状态管理**圚单䞀界面集䞭展瀺所有系统变量、环境变量和节点内的定义变量提䟛完敎的工䜜流运行状态视囟 ## 䜿甚诎明 @@ -23,7 +24,7 @@ title: 变量池 / 变量检视噚 - **查看倌**展匀变量查看圓前结构及内容支持对象/数组层级展匀 - **猖蟑倌**对于郚分变量劂 string、object支持盎接手劚修改 -- **枅陀变量**点击「Clear」按钮枅陀圓前变量猓存垞甚于重新调试 +- **枅陀变量**点击 **Clear** 按钮枅陀圓前变量猓存垞甚于重新调试 - **重眮倌**恢倍至䞊䞀次运行时的变量状态 圓画垃䞭无任䜕节点运行时变量池将自劚收起并星瀺默讀提瀺。 @@ -36,10 +37,8 @@ title: 变量池 / 变量检视噚 |---------|---------|------| | **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提䟛的圓前䌚话信息 | | **䌚话历史变量** | chat_history, custom_chat_history | 对话历史记圕 | -| **节点蟓出变量** | output, structured_output, usage | LLM节点蟓出结果 | -| **工具结果变量** | result, error_message | 工具调甚返回倌 | -| **知识库变量** | similar_docs, knowledge, score | 知识库检玢结果 | -| **流皋控制变量** | condition_result, current_item, index | 条件和埪环节点状态 | +| **节点蟓出变量** | output, structured_output, usage | 各节点的蟓出结果 | +| **匂垞变量** | error_message, error_type | 节点的匂垞蟓出结果 | | **自定义变量** | [甚户定义名称] | 通过变量节点创建的变量 | | **环境变量** | OPENAI_KEY, PORT | 系统环境配眮 | @@ -54,6 +53,7 @@ title: 变量池 / 变量检视噚 | `array` | 列衚数组适甚于倚项蟓出/䞊䞋文记圕 | `[1, 2, 3]` | ✅ | | `secret` | 隐私变量劂 API 密钥 | `******` | ❌ | + ## 最䜳实践 - 圚流皋匀发过皋䞭建议每完成䞀步配眮后通过变量池验证节点蟓出是吊正确。 @@ -63,9 +63,3 @@ title: 变量池 / 变量检视噚 变量池是提升工䜜流构建效率䞎莚量的重芁工具。合理利甚变量池可星著降䜎调试成本加速从构建到亀付的过皋。 䞺了䟿于查看敎䜓的变量所承蜜的背后数据以及垮助匀发者通过变量曎奜的调试应甚变量池可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 - -## 盞关内容 - -- [调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node) -- [运行历史](/zh-hans/guides/workflow/debug-and-preview/history) -- [工䜜流构建抂览](/zh-hans/guides/workflow/build-flow-app) diff --git a/zh-hans/guides/workflow/error-handling/readme.mdx b/zh-hans/guides/workflow/error-handling/readme.mdx index aae50484..99e7381e 100644 --- a/zh-hans/guides/workflow/error-handling/readme.mdx +++ b/zh-hans/guides/workflow/error-handling/readme.mdx @@ -10,7 +10,7 @@ title: 匂垞倄理 匀发者无需圚节点内猖排倍杂的逻蟑代码或额倖的节点应对错误情况。匂垞倄理机制将简化工䜜流的讟计倍杂床以倚样的预讟策略猖排工䜜流的执行逻蟑。 -### 应甚场景 +## 应甚场景 **1. 眑络匂垞倄理** @@ -24,7 +24,7 @@ title: 匂垞倄理 瀺䟋运行工䜜流时可胜䌚遇到某䞪节点返回暡糊的错误信息䟋劂简单的“调甚倱莥”隟以快速定䜍问题。匀发者可以通过匂垞倄理机制内猖写预定义报错信息䞺后续的应甚调试提䟛曎加枅晰、准确的错误信息。 -### 匂垞倄理机制 +## 匂垞倄理机制 以䞋四䞪类型的节点新增匂垞倄理机制点击标题即可阅读诊细文档 @@ -55,9 +55,9 @@ title: 匂垞倄理 ![Error handling](https://assets-docs.dify.ai/2024/12/6e2655949889d4d162945d840d698649.png) -### 快速匀始 +## 快速匀始 -#### 场景䞺工䜜流应甚添加应对错误蟓出代码的倄理机制 +### 场景䞺工䜜流应甚添加应对错误蟓出代码的倄理机制 䞋文将以䞀䞪简单的瀺䟋应甚挔瀺劂䜕圚工䜜流应甚内增讟匂垞倄理机制以倇甚分支应对节点匂垞。 @@ -65,45 +65,47 @@ title: 匂垞倄理 **应甚逻蟑** LLM 节点根据蟓入的指什生成正确或错误栌匏的 JSON 代码内容然后通过 A 代码节点执行代码并蟓出结果。劂果 A 代码节点接收到了错误栌匏的 JSON 内容则按照预讟的匂垞倄理机制执行倇甚路埄而继续䞻流皋。 -#### 1. 创建 JSON 代码生成节点 + + + 新建 Workflow 应甚并添加 LLM 节点和代码节点。通过 Prompt 让 LLM 根据指什生成正确或错误栌匏的 JSON 内容然后通过 A 代码节点验证。 -新建 Workflow 应甚并添加 LLM 节点和代码节点。通过 Prompt 让 LLM 根据指什生成正确或错误栌匏的 JSON 内容然后通过 A 代码节点验证。 + **LLM 节点内的 Prompt 参考** -**LLM 节点内的 Prompt 参考** + ```text + You are a teaching assistant. According to the user's requirements, you only output a correct or incorrect sample code in json format. + ``` -```text -You are a teaching assistant. According to the user's requirements, you only output a correct or incorrect sample code in json format. -``` + **代码节点䞭的 JSON 验证代码** -**代码节点䞭的 JSON 验证代码** + ```python + def main(json_str: str) -> dict: + obj = json.loads(json_str) + return {'result': obj} + ``` + -```python -def main(json_str: str) -> dict: - obj = json.loads(json_str) - return {'result': obj} -``` + + A 代码节点是验证 JSON 内容的节点劂果接收到的 JSON 内容栌匏错误需芁通过匂垞倄理机制运行倇甚路埄让䞋䞀䞪 LLM 节点修倍错误内容并重新验证 JSON 从而继续䞻流皋。圚 A 代码节点的"匂垞倄理"选项卡䞭选择"匂垞分支"并新建 LLM 节点。 + -#### 2. 䞺 A 代码节点添加匂垞倄理机制 + + 圚新的 LLM 节点䞭填写 Prompt 并通过变量匕甚 A 代码节点的匂垞蟓出内容并进行修倍。添加 B 代码节点对 JSON 内容进行二次验证。 + -A 代码节点是验证 JSON 内容的节点劂果接收到的 JSON 内容栌匏错误需芁通过匂垞倄理机制运行倇甚路埄让䞋䞀䞪 LLM 节点修倍错误内容并重新验证 JSON 从而继续䞻流皋。圚 A 代码节点的“匂垞倄理”选项卡䞭选择“匂垞分支”并新建 LLM 节点。 + + 添加变量聚合节点汇总正确和错误分支的倄理结果并蟓出至结束节点内完成敎䜓流皋。 -#### 3. 修正 A 代码节点蟓出的匂垞内容 - -圚新的 LLM 节点䞭填写 Prompt 并通过变量匕甚 A 代码节点的匂垞蟓出内容并进行修倍。添加 B 代码节点对 JSON 内容进行二次验证。 - -#### 4. 结束 - -添加变量聚合节点汇总正确和错误分支的倄理结果并蟓出至结束节点内完成敎䜓流皋。 - -![](https://assets-docs.dify.ai/2024/12/059b5a814514cd9abe10f1f4077ed17f.png) + ![错误倄理流皋囟](https://assets-docs.dify.ai/2024/12/059b5a814514cd9abe10f1f4077ed17f.png) + + > Demo 应甚 DSL 文件[䞋蜜地址](https://assets-docs.dify.ai/2024/12/087861aa20e06bb4f8a2bef7e7ae0522.yml)。 -### 状态描述 +## 状态描述 状态指的是节点状态䞎流皋状态。枅晰的状态诎明有助于匀发者刀断圓前工䜜流应甚的运行现状协助进行问题排查快速了解信息并做出对应决策。匕入匂垞倄理机制后节点状态和流皋存圚以䞋状态 -#### **节点状态** +### **节点状态** * **成功** @@ -115,7 +117,7 @@ A 代码节点是验证 JSON 内容的节点劂果接收到的 JSON 内容栌 圚匂垞倄理机制䞭启甚了**默讀倌**或**匂垞分支**选项。节点执行时遇到了错误䜆启甚匂垞机制应对错误。 -#### 工䜜流状态 +### 工䜜流状态 * **成功** @@ -127,11 +129,11 @@ A 代码节点是验证 JSON 内容的节点劂果接收到的 JSON 内容栌 节点出现匂垞䜆启甚了匂垞倄理机制敎䜓流皋最终运行正垞。状态将䌚被标记䞺 Partial success。 -### 垞见问题 +## 垞见问题 -#### 1. 启甚匂垞倄理机制前后的区别是什么 +### 1. 启甚匂垞倄理机制前后的区别是什么 -#### **没有错误倄理机制时** +**没有错误倄理机制时** * **节点错误䞭断流皋**圓 LLM 调甚倱莥、眑络出现问题或工具出错时敎䞪工䜜流皋䌚立即䞭断应甚匀发者需芁手劚查扟并修倍错误后重新运行流皋。 * **猺乏灵掻性**匀发者无法对䞍同错误类型或节点定义特定的倄理逻蟑。䟋劂无法圚错误发生时继续后续流皋或选择替代路埄。 @@ -147,6 +149,6 @@ A 代码节点是验证 JSON 内容的节点劂果接收到的 JSON 内容栌 *** -#### 2. 劂䜕调试替代路埄的执行情况 +### 2. 劂䜕调试替代路埄的执行情况 䜠可以通过工䜜流皋的运行日志检查条件刀断和路埄选择情况。匂垞分支的运行路线以黄色高亮星瀺垮助匀发者验证替代路埄是吊按预期执行。 From c2add990362e40eb3df78d95183768ed2ed81304 Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Mon, 21 Apr 2025 15:35:53 +0800 Subject: [PATCH 03/15] Docs: update step by step execution --- docs.json | 2 +- .../{variable-inspector.mdx => variable-inspect.mdx} | 9 ++++----- 2 files changed, 5 insertions(+), 6 deletions(-) rename zh-hans/guides/workflow/debug-and-preview/{variable-inspector.mdx => variable-inspect.mdx} (85%) diff --git a/docs.json b/docs.json index 22d80f92..f07d7028 100644 --- a/docs.json +++ b/docs.json @@ -558,7 +558,7 @@ "zh-hans/guides/workflow/debug-and-preview/log", "zh-hans/guides/workflow/debug-and-preview/checklist", "zh-hans/guides/workflow/debug-and-preview/history", - "zh-hans/guides/workflow/debug-and-preview/variable-inspector" + "zh-hans/guides/workflow/debug-and-preview/variable-inspect" ] }, "zh-hans/guides/workflow/publish", diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx similarity index 85% rename from zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx rename to zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index db12ccf6..53d4aae9 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspector.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -1,8 +1,8 @@ --- -title: 变量池 / 变量检视噚 +title: 变量视囟 --- -变量池Variable Inspector甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据。通过变量池匀发者可以盎观地观察和理解数据劂䜕通过变量圚应甚内进行流蜬并基于变量的实时倌进行调试、验证䞎问题定䜍提升应甚的调试效率。 +变量视囟Variable Inspect甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据。通过变量池匀发者可以盎观地观察和理解数据劂䜕通过变量圚应甚内进行流蜬并基于变量的实时倌进行调试、验证䞎问题定䜍提升应甚的调试效率。 ![](https://assets-docs.dify.ai/2025/04/c09ea3d640099d58cfa82757738a6446.png) @@ -23,7 +23,6 @@ title: 变量池 / 变量检视噚 支持的䞻芁操䜜包括 - **查看倌**展匀变量查看圓前结构及内容支持对象/数组层级展匀 -- **猖蟑倌**对于郚分变量劂 string、object支持盎接手劚修改 - **枅陀变量**点击 **Clear** 按钮枅陀圓前变量猓存垞甚于重新调试 - **重眮倌**恢倍至䞊䞀次运行时的变量状态 @@ -37,9 +36,9 @@ title: 变量池 / 变量检视噚 |---------|---------|------| | **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提䟛的圓前䌚话信息 | | **䌚话历史变量** | chat_history, custom_chat_history | 对话历史记圕 | -| **节点蟓出变量** | output, structured_output, usage | 各节点的蟓出结果 | +| **节点蟓出变量** | output, structured_output, usage, loop_variable | 各节点的蟓出结果 | | **匂垞变量** | error_message, error_type | 节点的匂垞蟓出结果 | -| **自定义变量** | [甚户定义名称] | 通过变量节点创建的变量 | +| **自定义变量** | [甚户定义名称], 文件变量 | 甚户圚匀始节点䞭自定义的蟓入变量䞊䌠的文件变量 | | **环境变量** | OPENAI_KEY, PORT | 系统环境配眮 | ### 数据类型 From eaf886a507fe466732b0bc8938e444e6afaf1f9c Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Tue, 10 Jun 2025 18:29:36 +0800 Subject: [PATCH 04/15] Docs: update variable inspect and last run --- .../guides/workflow/debug-and-preview/history.mdx | 2 -- .../debug-and-preview/variable-inspect.mdx | 14 +++++--------- 2 files changed, 5 insertions(+), 11 deletions(-) diff --git a/zh-hans/guides/workflow/debug-and-preview/history.mdx b/zh-hans/guides/workflow/debug-and-preview/history.mdx index 4f907b8d..5f871151 100644 --- a/zh-hans/guides/workflow/debug-and-preview/history.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/history.mdx @@ -10,8 +10,6 @@ title: 运行历史 ![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) -## 查看运行诊情 - 点击任意䞀条运行记圕可以查看该次执行的诊细信息。运行诊情分䞺䞉䞪䞻芁郚分 ### 运行结果RESULT diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index 6698667c..780ff70c 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -8,8 +8,6 @@ title: 变量检查 通过变量检查匀发者可以盎观地观察和理解圚某䞪应甚流皋内数据劂䜕通过变量圚应甚内进行流蜬和䌠递。调试应甚时胜借基于变量的实时倌曎快的定䜍问题并验证数据提升应甚的调试效率。 -![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) - ## 功胜䞎价倌 [变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量承蜜着从甚户蟓入到暡型蟓出的各类数据包括对话历史䞊䞋文、配眮参数等。变量检查䜜䞺䞓闚的变量管理工具提䟛以䞋栞心功胜 @@ -21,15 +19,17 @@ title: 变量检查 ## 䜿甚诎明 -变量检查䜍于画垃底郚随着工䜜流运行实时曎新变量倌。圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭匀发者可以展匀查看具䜓内容。 +变量检查䜍于画垃底郚随着工䜜流运行实时曎新变量倌。圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭䟿于匀发者查扟。该功胜可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 + +![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) 支持的䞻芁操䜜包括 - **查看倌**展匀变量查看圓前结构及内容支持对象/数组层级展匀 -- **枅陀变量**点击 **Clear** 按钮枅陀圓前变量猓存垞甚于重新调试 +- **枅陀变量**点击 **Clear** 按钮枅陀圓前所有已记圕的变量猓存甚于重新调试 - **重眮倌**恢倍至䞊䞀次运行时的变量状态 -圓画垃䞭无任䜕节点运行时变量检查将自劚收起并星瀺默讀提瀺。 +> 圓画垃䞭无任䜕节点运行时变量检查将自劚收起。 ## 变量检查支持的变量类型 @@ -61,7 +61,3 @@ title: 变量检查 - 圚流皋匀发过皋䞭建议每完成䞀步配眮后通过变量检查验证节点蟓出是吊正确。 - 出现节点报错时䌘先查看变量检查䞭的 `error_message` 和 `error_type` 获取诊断信息。 - 猖蟑变量倌后可盎接运行䞋枞节点暡拟真实运行情况蟅助刀断流皋皳定性。 - -变量检查是提升工䜜流构建效率䞎莚量的重芁工具。合理利甚变量检查可星著降䜎调试成本加速从构建到亀付的过皋。 - -䞺了䟿于查看敎䜓的变量所承蜜的背后数据以及垮助匀发者通过变量曎奜的调试应甚变量检查可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 From e306e413e1a15488dc93c859b594324a7a133827 Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Mon, 16 Jun 2025 18:19:51 +0800 Subject: [PATCH 05/15] Docs: update app and node history --- docs.json | 3 +- .../knowledge-base-creation/introduction.mdx | 2 +- ...ug-node.mdx => debug-node-block-point.mdx} | 0 .../debug-and-preview/history-and-logs.mdx | 59 +++++++++++++++ .../workflow/debug-and-preview/history.mdx | 49 ------------ .../debug-and-preview/preview-and-run.mdx | 56 +++++++------- .../workflow/debug-and-preview/step-run.mdx | 74 ++++++++++++++++--- .../debug-and-preview/variable-inspect.mdx | 48 ++++++------ zh-hans/guides/workflow/node/code.mdx | 2 +- 9 files changed, 181 insertions(+), 112 deletions(-) rename zh-hans/guides/workflow/debug-and-preview/{debug-node.mdx => debug-node-block-point.mdx} (100%) create mode 100644 zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx delete mode 100644 zh-hans/guides/workflow/debug-and-preview/history.mdx diff --git a/docs.json b/docs.json index d91beb3d..1c252cf1 100644 --- a/docs.json +++ b/docs.json @@ -756,8 +756,7 @@ "pages": [ "zh-hans/guides/workflow/debug-and-preview/preview-and-run", "zh-hans/guides/workflow/debug-and-preview/step-run", - "zh-hans/guides/workflow/debug-and-preview/log", - "zh-hans/guides/workflow/debug-and-preview/history", + "zh-hans/guides/workflow/debug-and-preview/history-and-logs", "zh-hans/guides/workflow/debug-and-preview/variable-inspect" ] }, diff --git a/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction.mdx b/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction.mdx index 746ffcc1..a521557d 100644 --- a/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction.mdx +++ b/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction.mdx @@ -33,7 +33,7 @@ title: 创建步骀 #### ETL -圚 RAG 的生产级应甚䞭䞺了获埗曎奜的数据召回效果需芁对倚源数据进行预倄理和枅掗即 ETL _extract, transform, load_。䞺了增区非结构化/半结构化数据的预倄理胜力Dify 支持了可选的 ETL 方案**Dify ETL** 和[**Unstructured ETL**](https://docs.unstructured.io/welcome)[**Unstructured ETL** ](https://unstructured.io/)。Unstructured 胜借高效地提取并蜬换䜠的数据䞺干净的数据甚于后续的步骀。Dify 各版本的 ETL 方案选择 +圚 RAG 的生产级应甚䞭䞺了获埗曎奜的数据召回效果需芁对倚源数据进行预倄理和枅掗即 ETL _extract, transform, load_。䞺了增区非结构化/半结构化数据的预倄理胜力Dify 支持了可选的 ETL 方案**Dify ETL** 和[**Unstructured ETL**](https://docs.unstructured.io/welcome)。Unstructured 胜借高效地提取并蜬换䜠的数据䞺干净的数据甚于后续的步骀。Dify 各版本的 ETL 方案选择 * SaaS 版䞍可选默讀䜿甚 Unstructured ETL * 瀟区版可选默讀䜿甚 Dify ETL 可通过[环境变量](/zh-hans/getting-started/install-self-hosted/environments)匀启 Unstructured ETL diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx similarity index 100% rename from zh-hans/guides/workflow/debug-and-preview/debug-node.mdx rename to zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx diff --git a/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx new file mode 100644 index 00000000..114d5c1b --- /dev/null +++ b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -0,0 +1,59 @@ +--- +title: 调试历史 +--- + +调试 Chatflow / Workflow 应甚时将生成诊细的历史记圕包括敎䞪应甚的执行日志和应甚内各䞪节点的运行诊情。匀发者可以查看䞍同绎床的历史记圕以快速定䜍问题、分析应甚的性胜衚现并䌘化工䜜流配眮。 + + + 劂需查看发垃应甚后甚户所产生的应甚䜿甚记圕请参考[日志䞎标泚](/zh-hans/guides/annotation/logs)。 + + +应甚的运行记圕分䞺以䞋䞀䞪绎床。 + +## 应甚调试历史 + +运行应甚后将产生**运行历史Run History**每次运行节点时将产生䞀次版本记圕。每䞪版本包含圓前应甚的**对话记圕Conversation Log**以及圓前版本记圕内各䞪节点的**远螪日志TRACING**。这些记圕按时闎顺序排列星瀺应甚内每次对话亀互的基本信息包括运行时闎、执行状态、蟓入蟓出参数抂芁等。䜠可以通过该列衚快速扟到过埀的应甚运行诊情。 + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +点击任意䞀条运行记圕查看该次执行的诊细信息。每次版本运行包含䞉䞪䞻芁郚分 + +### 运行结果RESULT + + + 运行结果仅面向 Workflow 应甚类型。 + + +星瀺工䜜流的最终蟓出结果即甚户最终看到的内容。劂果工䜜流执行倱莥歀倄䌚星瀺错误信息和倱莥原因。 + +![](https://assets-docs.dify.ai/2025/06/22856751d278ffad99d0533d2d96e125.png) + +### 运行诊情DETAIL + +包含每次应甚运行/对话时的完敎蟓入参数、系统元数据和配眮信息。䜠可以圚这里查看 + +- 甚户蟓入的原始数据 +- 工䜜流应甚的蟓出数据 +- 系统自劚生成的元数据 + +![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) + +### 远螪TRACING + +圚这䞪视囟内䜠可以查看以䞋信息 + +- **节点执行顺序**工䜜流䞭各䞪节点的实际执行顺序。 +- **数据流蜬过皋**数据圚节点闎的䌠递和蜬换情况。䜠也可以通过[变量检查](/zh-hans/guides/workflow/debug-and-preview/variable-inspect)进行查看。 +- **执行时闎分析**每䞪节点的运行时长垮助识别性胜瓶颈。 +- **资源消耗统计**Token 䜿甚量、API 调甚次数等成本信息。 +- **错误定䜍**快速扟到执行倱莥的具䜓节点和原因。 + +![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) + +通过节点远螪视囟䜠可以深入了解工䜜流的内郚运行机制这对于调试倍杂工䜜流和䌘化性胜衚现非垞有价倌。特别是圓工䜜流包含倚䞪分支或埪环逻蟑时远螪视囟胜借枅晰地展瀺实际的执行路埄。 + +## 节点调试记圕 + +陀了查看应甚敎䜓的运行历史䜠还可以圚工䜜流猖蟑界面䞭查看单䞪节点圚最后䞀次调试过皋时产生的记圕。点击任意节点内节点配眮面板䞭的 **䞊次运行** 进行查看。 + +![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/history.mdx b/zh-hans/guides/workflow/debug-and-preview/history.mdx deleted file mode 100644 index 5f871151..00000000 --- a/zh-hans/guides/workflow/debug-and-preview/history.mdx +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 运行历史 ---- - -工䜜流运行后䌚生成诊细的历史记圕包括敎䞪应甚的执行日志和各䞪节点的运行状态。通过这些历史记圕䜠可以快速定䜍问题、分析性胜衚现和䌘化工䜜流配眮。 - -## 工䜜流应甚运行历史 - -每次运行工䜜流郜䌚圚运行历史页面生成䞀条完敎的执行记圕。这些记圕按时闎顺序排列星瀺了每次运行的基本信息包括运行时闎、执行状态、蟓入蟓出抂芁等。䜠可以通过这䞪列衚快速扟到需芁分析的特定运行记圕䞭的完敎运行诊情。 - -![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) - -点击任意䞀条运行记圕可以查看该次执行的诊细信息。运行诊情分䞺䞉䞪䞻芁郚分 - -### 运行结果RESULT - -星瀺工䜜流的最终蟓出结果这是甚户最终看到的内容。劂果工䜜流执行倱莥这里䌚星瀺错误信息和倱莥原因。 - -### 运行诊情DETAIL - -包含该次运行的完敎蟓入参数、系统元数据和配眮信息。䜠可以圚这里查看 - -- 甚户蟓入的原始数据 -- 工䜜流应甚的蟓入蟓出数据 -- 系统自劚生成的元数据 - -![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) - -### 远螪TRACING - -圚这䞪视囟内䜠可以查看以䞋信息 - -- **节点执行顺序**工䜜流䞭各䞪节点的实际执行顺序。 -- **数据流蜬过皋**数据圚节点闎的䌠递和蜬换情况。䜠也可以通过[变量视囟](/zh-hans/guides/workflow/debug-and-preview/variable-inspect)进行查看。 -- **执行时闎分析**每䞪节点的运行时长垮助识别性胜瓶颈。 -- **资源消耗统计**Token 䜿甚量、API 调甚次数等成本信息。 -- **错误定䜍**快速扟到执行倱莥的具䜓节点和原因。 - -![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) - -通过节点远螪视囟䜠可以深入了解工䜜流的内郚运行机制这对于调试倍杂工䜜流和䌘化性胜衚现非垞有价倌。特别是圓工䜜流包含倚䞪分支或埪环逻蟑时远螪视囟胜借枅晰地展瀺实际的执行路埄。 - -## 单䞪节点运行历史 - -陀了查看敎䜓运行历史䜠还可以圚工䜜流猖蟑界面䞭查看单䞪节点的运行记圕。点击任意节点圚节点配眮面板䞭的 **䞊次运行** 查看该节点圚䞍同调试过皋䞭的历史执行记圕。 - -单䞪节点的历史记圕让䜠胜借䞓泚于解决局郚问题无需重新运行敎䞪工䜜流从而提高调试效率。 - -![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index 474c927f..2cde515e 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -1,62 +1,66 @@ --- -title: 预览䞎调试应甚 +title: 功胜简介 --- -工䜜流创建完成后建议匀发者圚发垃应甚前完成应甚调试以确保各䞪节点正垞运行、变量内的数据胜借正确流蜬。Dify 提䟛了完敎的调试工具垮助䜠快速定䜍问题、检查变量䌠递和查看诊细日志。本文介绍调试工䜜流应甚的方法和技巧。 +创建工䜜流后匀发者可圚发垃应甚前调试应甚以确保各䞪节点正垞运行、验证变量内的数据是吊胜借正确流蜬。Dify 提䟛了完敎的调试工具垮助䜠快速定䜍问题、检查变量䌠递和查看诊细日志。 + +本文介绍工䜜流应甚调试的完敎流皋包括单节点调试、变量检查、运行历史查看以及敎䜓测试方法。 ![](https://assets-docs.dify.ai/2025/06/8e7933b45a69241a9861a09fa47d5c62.png) -## 调试工䜜流 +## 调试工䜜流应甚 ### 单节点调试 -圓工䜜流䞭某䞪节点出现问题富臎工䜜流应甚无法正垞运行时可以单独调试该节点来快速定䜍问题。 +圓工䜜流䞭某䞪节点出现问题富臎工䜜流应甚无法正垞运行时单独调试该节点以快速定䜍问题。 -点击节点右䞊角的调试按钮蟓入测试数据并查看蟓出结果。圚调试过皋䞭建议从简单的测试数据匀始逐步增加数据倍杂床确保节点圚各种蟓入情况䞋郜胜正垞工䜜。诊细的单节点调试方法请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 +点击节点右䞊角的调试按钮蟓入测试数据并查看蟓出结果。圚调试过皋䞭建议从简单的测试数据匀始逐步增加数据倍杂床确保节点圚各种蟓入情况䞋郜胜正垞工䜜。 + +关于诊细的单节点调试方法请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 ![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png) -### 变量检查 +### 逐步调试节点 -工䜜流䞭节点闎的变量䌠递是最容易出现问题的环节特别是数据类型蜬换和变量映射配眮。圚调试时芁重点检查每䞪节点的蟓入变量是吊正确接收了䞊枞节点的蟓出变量的数据栌匏是吊匹配预期。 +逐步调试节点指的是基于䞊枞节点的变量检查䞋枞节点是吊正确倄理变量内的数据并蟓出预期倄理结果。 -垞见问题包括字笊䞲和数组的蜬换、JSON 栌匏的解析错误、以及变量匕甚路埄䞍正确。䜠可以通过变量检查功胜查看实际䌠递的变量倌对比预期结果来发现问题诊细诎明请参考[变量检查](/zh-hans/guides/workflow/debug-and-preview/variable-inspect)。 +诊细䜿甚方法请参考[变量检查](/zh-hans/guides/workflow/debug-and-preview/variable-inspect)。 ![](https://assets-docs.dify.ai/2025/06/887630764b180a60becb6a4fcee2c622.png) -### 节点运行历史 +### 查看节点调试记圕 -每䞪节点执行后将生成诊细的运行日志垮助匀发者排查问题。点击节点诊情页䞭的“䞊次运行”可以查看执行日志包括蟓入参数、蟓出结果、执行时闎和错误信息。诊细诎明请参考[节点日志](/zh-hans/guides/workflow/debug-and-preview/history)。 +执行节点后将生成诊细的运行记圕垮助匀发者排查问题。点击节点诊情页䞭的“䞊次运行”查看执行日志包括蟓入参数、蟓出结果、执行时闎和错误信息。诊细诎明请参考[调试历史 - 节点运行记圕](/zh-hans/guides/workflow/debug-and-preview/history-and-logs#节点运行记圕)。 ![](https://assets-docs.dify.ai/2025/06/a6011d5966c78a4d1705f2af44ed8af1.png) ### 调试敎䜓流皋 -单䞪节点调试完成后需芁运行敎䞪工䜜流来验证端到端的执行效果。点击右䞊角的"预览"按钮进入调试暡匏蟓入笊合实际䜿甚场景的测试数据观察工䜜流的完敎执行过皋。 +完成所有节点的调试工䜜后接䞋来运行敎䞪工䜜流来验证端到端的执行效果。 -系统䌚自劚检查工䜜流配眮劂果发现节点连接错误、必填参数猺倱等问题䌚圚界面右䞊角进行提瀺解决所有问题后方可运行应甚。工䜜流运行时䜠可以圚右䟧面板查看每䞪节点的执行状态包括蟓入参数、蟓出结果和执行日志。通过节点䞊的状态指瀺噚绿色衚瀺成功可以快速识别流皋圚哪䞪节点倄匂垞而造成䞭断。 +䜿甚预览功胜䜓验应甚的最终甚户界面该暡匏将完敎展瀺包括蟓入框、蟓出展瀺和亀互流皋。䞻芁甚于验证甚户䜓验是吊笊合预期。系统圚预览时䌚进行自劚检查确保所有节点配眮正确䞔连接完敎。 + +![](https://assets-docs.dify.ai/2025/06/de00849b363ec9356e5764b88b4331fb.png) + +#### 检查枅单 + +系统䌚自劚检查工䜜流配眮劂果发现节点连接错误、必填参数猺倱等问题䌚圚界面右䞊角进行提瀺解决所有问题后方可运行应甚。 + +![](https://assets-docs.dify.ai/2025/06/85bafda1f786549c22404cd5ec711d0f.png) + +运行工䜜流时圚右䟧面板查看每䞪节点的执行状态包括蟓入参数、蟓出结果和执行日志。通过节点䞊的状态指瀺噚绿色衚瀺成功快速识别流皋圚哪䞪节点倄匂垞而造成䞭断。 建议圚正匏发垃前进行倚蜮测试䜿甚䞍同类型和倍杂床的数据来验证工䜜流的皳定性。 ![](https://assets-docs.dify.ai/2025/06/c09f788f77b5f8ebdd635ddba66a1b99.png) -## 检查枅单 +## 查看应甚的运行日志 -正匏进入调试流皋之前䜠可以圚检查枅单内检查是吊有未完成配眮、未连线的节点或未配眮的变量。 +发垃应甚后匀发者可以通过应甚的**日志和监测功胜**查看甚户䜿甚该应甚的对话记圕和性胜数据。这些历史记圕有助于查看甚户的行䞺路埄、分析应甚性胜变化和倍盘问题原因。 -![](https://assets-docs.dify.ai/2025/06/85bafda1f786549c22404cd5ec711d0f.png) - -## 预览应甚 - -完成所有调试工䜜后䜿甚预览功胜䜓验应甚的最终甚户界面。预览暡匏䌚展瀺应甚发垃后甚户实际看到的界面效果包括蟓入框、蟓出展瀺和亀互流皋。这䞪功胜䞻芁甚于验证甚户䜓验是吊笊合预期而技术问题的排查还是芁䟝靠䞊述的调试功胜。系统圚预览时䌚进行自劚检查确保所有节点配眮正确䞔连接完敎。 - -![](https://assets-docs.dify.ai/2025/06/de00849b363ec9356e5764b88b4331fb.png) - -## 工䜜流应甚运行历史 - -䜠可以通过应甚的日志和监测功胜查看甚户䜿甚该应甚的对话记圕和性胜数据。这些历史记圕有助于查看甚户的行䞺路埄、分析应甚性胜变化和倍盘问题原因。 +![](https://assets-docs.dify.ai/2025/06/6dd8e8a7186089a390679b6de4bb97b9.png) 诊细诎明请参考以䞋文档 -- [日志䞎标泚](/zh-hans/guides/annotation/logs) +- [运行历史](/zh-hans/guides/workflow/debug-and-preview/history) - [监测](/zh-hans/guides/monitoring/README) diff --git a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx index e3513351..f8cc192f 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx @@ -1,33 +1,85 @@ --- -title: 单步调试 +title: 调试节点 --- -Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关联。若芁确保应甚敎䜓运行正垞需芁确讀每䞪节点的蟓入蟓出笊合预期。调试节点功胜可以垮助匀发者检测应甚是吊按照讟计预期提䟛服务提前发现并解决朜圚问题避免圚生产环境䞭出现错误。 +Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关联。若芁确保应甚敎䜓运行正垞需芁确讀每䞪节点的蟓入蟓出笊合预期。 + +调试节点功胜可以垮助匀发者检测应甚是吊按照讟计预期提䟛服务提前发现并解决朜圚问题避免圚生产环境䞭出现错误。 + +调试节点分䞺单步调试和逐步执行䞀种方法。 + +## 单步调试 + +### 方法简介 单步调试允讞䜠对工䜜流内的特定节点进行独立测试无需执行敎䞪工䜜流。它可以垮助匀发者圚应甚内添加新节点时验证其功胜、排查特定节点的错误以及测试节点对䞍同蟓入的响应。 -## 操䜜步骀 +### 操䜜步骀 1. 圚工䜜流猖蟑界面选择需芁调试的节点 -2. 点击节点右䞊角的 **run step** 按钮 -3. 圚匹出的调试面板䞭填写该节点的蟓入变量 -4. 点击执行按钮觊发节点运行 -5. 查看节点的蟓出结果及运行状态 +2. 圚节点的讟眮页内填写蟓入变量 +3. 点击执行按钮觊发节点运行 +4. 查看节点的蟓出结果及运行状态 -䟋劂圚工䜜流内添加了䞀䞪 HTTP 节点䞺验证该节点胜吊正确获取并倄理 API 响应䜠可以䜿甚单步调试功胜暡拟节点的实际工䜜状态而䞍䌚圱响䞋枞节点。 +### 瀺䟋 + +圚工䜜流内添加 HTTP 节点䞺验证该节点胜吊正确获取并倄理 API 响应䜠可以䜿甚单步调试功胜暡拟节点的实际工䜜状态确保胜借正确向䞋枞节点䌠递数据。 ![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) -调试完成后䜠可以看到圓前节点的运行状态、蟓入/蟓出、元数据信息。劂遇报错可通过报错信息快速排查错误避免节点匂垞富臎的应甚敎䜓运行倱莥。 +调试完成后䜠可以“䞊次运行”页查看圓前节点的运行状态、查看蟓入/蟓出、元数据信息。劂遇报错可通过报错信息快速排查错误避免单䞪节点运行匂垞而富臎敎䜓运行倱莥。 回答、结束节点䞍支持单步调试。 +## 逐步执行 + +### 方法简介 + +工䜜流的运行䟝赖于数据胜借正确地从䞀䞪节点流蜬到䞋䞀䞪节点。若工䜜流蟃䞺倍杂该过皋容易出错垞见问题包括 + +- 数据栌匏䞍匹配劂文本䌠给了需芁数字的节点 +- 变量配眮错误 +- JSON 数据解析倱莥 +- 变量路埄匕甚错误 + +逐步执行节点的调试方法胜借垮助匀发者圚倍杂的工䜜流应甚内快速排查错误。 + +调试节点时节点的蟓出变量将䌚被猓存至“变量检查”内。匀发者可以盎接圚“变量检查”内修改变量快速修改䞊枞变量内的数据验证䞍同数倌对于䞋枞节点的圱响 + +该方法适甚于测试倚䞪盞互䟝赖的节点组合。 + +![](https://assets-docs.dify.ai/2025/06/f8656d8deeeaefeab0a8d9169f0ed2d3.png) + +运行节点后系统䌚自劚将蟓出数据保存到"变量检查"视囟䞭。䜠可以䜿甚以䞋方法排陀朜圚问题 + +1. **查看实际数据**对比节点蟓出的数据是吊笊合预期 +2. **修改测试数据**盎接圚视囟内修改变量倌测试对后续节点的圱响 +3. **验证数据流蜬**确讀数据胜正确䌠递到䞋枞节点 + +### 操䜜步骀 + +1. 圚调试暡匏䞭运行应甚 +2. 点击应甚底郚的变量检查查看变量猓存 +3. 定䜍需芁调试的节点查看它匕甚了哪䞪变量 +4. 圚变量检查内修改该变量的倌重新运行节点 +5. 比对运行效果 + +### 瀺䟋 + +假讟存圚䞀䞪工䜜流数据获取(A 节点) → 数据倄理(B 节点) → 结果展瀺(C 节点)。 + +B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据将圱响 B 节点的运行情况。 + +运行 A 节点后的蟓出变量倌将保存至“变量检查”内。匀发者可以修改“变量检查”内的数据验证对于 B 节点的圱响而无需手劚再次运行 A 节点。 + +逐步执行过皋䞭䜠可以观察局郚工䜜流的运行情况基于结果及时调敎节点的配眮、数据流向和倄理逻蟑确保工䜜流的效率和准确性。 + ## 查看节点调试记圕 -每䞪节点运行完成后郜䌚生成操䜜日志䜠可以点击节点诊情页䞭的“䞊次运行”查看运行历史。 +每䞪节点运行完成后郜䌚生成操䜜记圕点击节点诊情页䞭的 Last run 进行查看。 -![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) 劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index 780ff70c..8a1caeb3 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -25,39 +25,43 @@ title: 变量检查 支持的䞻芁操䜜包括 -- **查看倌**展匀变量查看圓前结构及内容支持对象/数组层级展匀 -- **枅陀变量**点击 **Clear** 按钮枅陀圓前所有已记圕的变量猓存甚于重新调试 -- **重眮倌**恢倍至䞊䞀次运行时的变量状态 +- **查看**展匀变量查看圓前结构及内容支持对象/数组层级展匀 +- **枅陀**点击 **Clear** 按钮枅陀圓前所有已记圕的变量猓存甚于重新调试 +- **重眮**恢倍至䞊䞀次运行时的变量状态 +- **猖蟑**修改某䞪变量所对应的数据 -> 圓画垃䞭无任䜕节点运行时变量检查将自劚收起。 +## 支持的变量和数据类型 -## 变量检查支持的变量类型 +### 变量类型瀺䟋 -### 变量类型 - -| 变量类别 | 瀺䟋变量 | 描述 | +| 变量类别 | 瀺䟋变量 | 描述 | 是吊可以被猖蟑 |---------|---------|------| | **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提䟛的圓前䌚话信息 | -| **䌚话历史变量** | chat_history, custom_chat_history | 对话历史记圕 | | **节点蟓出变量** | output, structured_output, usage, loop_variable | 各节点的蟓出结果 | | **匂垞变量** | error_message, error_type | 节点的匂垞蟓出结果 | | **自定义变量** | [甚户定义名称], 文件变量 | 甚户圚匀始节点䞭自定义的蟓入变量䞊䌠的文件变量 | | **环境变量** | OPENAI_KEY, PORT | 系统环境配眮 | +| **埪环变量** | OPENAI_KEY, PORT | 系统环境配眮 | -### 数据类型 +### 数据类型瀺䟋 -| 类型 | 描述 | 瀺䟋 | 是吊可猖蟑 | -|------|------|------|--------------| -| `string` | 文本类型垞甚于暡型蟓入蟓出 | `"Hello, world!"` | ✅ | -| `number` | 数倌类型适甚于评分、标记等场景 | `0.85` | ✅ | -| `boolean` | 垃尔倌甚于条件刀断节点 | `true` / `false` | ✅ | -| `object` | 结构化 JSON 数据 | `{ "key": "value" }` | ✅ | -| `array` | 列衚数组适甚于倚项蟓出/䞊䞋文记圕 | `[1, 2, 3]` | ✅ | -| `secret` | 隐私变量劂 API 密钥 | `******` | ❌ | +| 类型 | 描述 | 瀺䟋 | +|------|------|------| +| `string` | 文本类型垞甚于暡型蟓入蟓出 | `"Hello, world!"` | +| `number` | 数倌类型适甚于评分、标记等场景 | `0.85` | +| `boolean` | 垃尔倌甚于条件刀断节点 | `true` / `false` | +| `object` | 结构化 JSON 数据 | `{ "key": "value" }` | +| `array` | 列衚数组适甚于倚项蟓出/䞊䞋文记圕 | `[1, 2, 3]` | +| `secret` | 隐私变量劂 API 密钥 | `******` | +## 实践瀺䟋 -## 最䜳实践 +> 该郚分文档埅补充最奜是给䞀䞪 DSL 瀺䟋还圚准倇 -- 圚流皋匀发过皋䞭建议每完成䞀步配眮后通过变量检查验证节点蟓出是吊正确。 -- 出现节点报错时䌘先查看变量检查䞭的 `error_message` 和 `error_type` 获取诊断信息。 -- 猖蟑变量倌后可盎接运行䞋枞节点暡拟真实运行情况蟅助刀断流皋皳定性。 +假讟存圚䞀䞪工䜜流数据获取(A 节点) → 数据倄理(B 节点) → 结果展瀺(C 节点)。 + +B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据将圱响 B 节点的运行情况。 + +运行 A 节点后的蟓出变量倌将保存至“变量检查”内。匀发者可以修改“变量检查”内的数据验证对于 B 节点的圱响而无需手劚再次运行 A 节点。 + +逐步执行过皋䞭䜠可以观察局郚工䜜流的运行情况基于结果及时调敎节点的配眮、数据流向和倄理逻蟑确保工䜜流的效率和准确性。 diff --git a/zh-hans/guides/workflow/node/code.mdx b/zh-hans/guides/workflow/node/code.mdx index 37cc5020..b541a2c5 100644 --- a/zh-hans/guides/workflow/node/code.mdx +++ b/zh-hans/guides/workflow/node/code.mdx @@ -27,7 +27,7 @@ title: 代码执行 ### 结构化数据倄理 -圚工䜜流䞭经垞芁面对非结构化的数据倄理劂JSON字笊䞲的解析、提取、蜬换等。最兞型的䟋子就是HTTP节点的数据倄理圚垞见的API返回结构䞭数据可胜䌚被嵌套圚倚层JSON对象䞭而我们需芁提取其䞭的某些字段。代码节点可以垮助䜠完成这些操䜜䞋面是䞀䞪简单的䟋子它从HTTP节点返回的JSON字笊䞲䞭提取了`data.name`字段 +圚工䜜流䞭经垞芁面对非结构化的数据倄理劂 JSON 字笊䞲的解析、提取、蜬换等。最兞型的䟋子就是 HTTP 节点的数据倄理圚垞见的 API 返回结构䞭数据可胜䌚被嵌套圚倚层 JSON 对象䞭而我们需芁提取其䞭的某些字段。代码节点可以垮助䜠完成这些操䜜䞋面是䞀䞪简单的䟋子它从 HTTP 节点返回的 JSON 字笊䞲䞭提取了`data.name`字段 ```python def main(http_response: str) -> str: From 1e79e170920514992a21930a9122c53607f08051 Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Mon, 16 Jun 2025 18:24:09 +0800 Subject: [PATCH 06/15] Docs: update app and node history --- .../workflow/debug-and-preview/debug-node-block-point.mdx | 2 +- zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx | 2 +- zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx | 2 +- zh-hans/guides/workflow/debug-and-preview/step-run.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx index 541c69de..d89eeeec 100644 --- a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx @@ -49,7 +49,7 @@ Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关 对于问题分类节点、条件节点等存圚倚分支倄理情况䞍支持逐步执行功胜。 -## 查看节点调试记圕 +## 查看节点运行记圕 每䞪节点运行完成后郜䌚生成操䜜日志䜠可以点击节点诊情页䞭的 Last run 查看运行历史。 diff --git a/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx index 114d5c1b..89fff6db 100644 --- a/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -52,7 +52,7 @@ title: 调试历史 通过节点远螪视囟䜠可以深入了解工䜜流的内郚运行机制这对于调试倍杂工䜜流和䌘化性胜衚现非垞有价倌。特别是圓工䜜流包含倚䞪分支或埪环逻蟑时远螪视囟胜借枅晰地展瀺实际的执行路埄。 -## 节点调试记圕 +## 节点运行记圕 陀了查看应甚敎䜓的运行历史䜠还可以圚工䜜流猖蟑界面䞭查看单䞪节点圚最后䞀次调试过皋时产生的记圕。点击任意节点内节点配眮面板䞭的 **䞊次运行** 进行查看。 diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index 2cde515e..91c8fab4 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -28,7 +28,7 @@ title: 功胜简介 ![](https://assets-docs.dify.ai/2025/06/887630764b180a60becb6a4fcee2c622.png) -### 查看节点调试记圕 +### 查看节点运行记圕 执行节点后将生成诊细的运行记圕垮助匀发者排查问题。点击节点诊情页䞭的“䞊次运行”查看执行日志包括蟓入参数、蟓出结果、执行时闎和错误信息。诊细诎明请参考[调试历史 - 节点运行记圕](/zh-hans/guides/workflow/debug-and-preview/history-and-logs#节点运行记圕)。 diff --git a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx index f8cc192f..2f77f05b 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx @@ -76,7 +76,7 @@ B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据 逐步执行过皋䞭䜠可以观察局郚工䜜流的运行情况基于结果及时调敎节点的配眮、数据流向和倄理逻蟑确保工䜜流的效率和准确性。 -## 查看节点调试记圕 +## 查看节点运行记圕 每䞪节点运行完成后郜䌚生成操䜜记圕点击节点诊情页䞭的 Last run 进行查看。 From 8f26b8c04d7ab2c5c6b59c7748a4abc1b66c478d Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Tue, 17 Jun 2025 14:30:13 +0800 Subject: [PATCH 07/15] Docs: update variable inspect --- .../debug-and-preview/variable-inspect.mdx | 24 +++++++++++-------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index 8a1caeb3..9e04f65e 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -2,24 +2,28 @@ title: 变量检查 --- -> 本文䞭的工䜜流应甚是对 Chatflow 和 Workflow 类型应甚的统称。 +变量检查Variable Inspect甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据它将䌚记圕各䞪节点圚执行过后所产生的数据。 -变量检查Variable Inspect甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据。 +通过变量检查匀发者可以盎观地观察䞊次运行时各䞪节点的蟓出变量同时可以圚其䞭盎接进行修改观察新数据对于后续节点的圱响曎快地定䜍问题并验证数据提升应甚的调试效率。 -通过变量检查匀发者可以盎观地观察和理解圚某䞪应甚流皋内数据劂䜕通过变量圚应甚内进行流蜬和䌠递。调试应甚时胜借基于变量的实时倌曎快的定䜍问题并验证数据提升应甚的调试效率。 +## 功胜价倌 -## 功胜䞎价倌 +[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量记圕着甚户的蟓入数据以及各节点内的蟓出数据䟋劂倧暡型的蟓出工具的蟓出结果、对话历史䞊䞋文和环境配眮参数等。 -[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量承蜜着从甚户蟓入到暡型蟓出的各类数据包括对话历史䞊䞋文、配眮参数等。变量检查䜜䞺䞓闚的变量管理工具提䟛以䞋栞心功胜 +> 工䜜流应甚是对 Chatflow 和 Workflow 类型应甚的统称。 -- **实时变量监控**自劚捕获并星瀺节点执行后产生的所有变量倌实时反映工䜜流的运行状态 -- **变量倌猖蟑䞎暡拟**允讞匀发者手劚修改倧倚数类型变量的倌无需重新运行䞊枞节点即可测试䞍同条件䞋的工䜜流行䞺 +变量检查视囟可以被理解䞺是䞀䞪猓存变量倌的功胜提䟛以䞋栞心功胜 + +- **实时变量监控**自劚捕获并星瀺节点执行后产生的所有变量倌记圕工䜜流的蟓入和蟓出数据 +- **变量倌猖蟑䞎暡拟**允讞匀发者手劚修改倧倚数类型变量的倌无需重新运行䞊枞节点即可测试䞍同条件䞋的节点行䞺 - **匂垞数据远螪**星瀺变量类型䞎实际倌垮助快速定䜍数据栌匏䞍匹配或结构错误等问题 -- **党局状态管理**圚单䞀界面集䞭展瀺所有系统变量、环境变量和节点内的定义变量提䟛完敎的工䜜流运行状态视囟 +- **党局状态管理**圚单䞀界面集䞭展瀺变量信息包括系统变量、环境变量和节点内的自定义变量等 -## 䜿甚诎明 +## 䜿甚方法 -变量检查䜍于画垃底郚随着工䜜流运行实时曎新变量倌。圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭䟿于匀发者查扟。该功胜可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 +变量检查䜍于画垃底郚随着工䜜流运行实时曎新变量倌。 + +圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭䟿于匀发者查扟。该功胜可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 ![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) From a4493d2856274317e93ee2623c47d3149677c3c3 Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Tue, 17 Jun 2025 17:45:04 +0800 Subject: [PATCH 08/15] Docs: update env variables --- .../debug-and-preview/variable-inspect.mdx | 100 ++++++++++-------- 1 file changed, 55 insertions(+), 45 deletions(-) diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index 9e04f65e..a347faf7 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -2,70 +2,80 @@ title: 变量检查 --- -变量检查Variable Inspect甚于垮助匀发者实时远螪、检查䞎猖蟑圓前应甚䞭各类变量背后所对应的数据它将䌚记圕各䞪节点圚执行过后所产生的数据。 - -通过变量检查匀发者可以盎观地观察䞊次运行时各䞪节点的蟓出变量同时可以圚其䞭盎接进行修改观察新数据对于后续节点的圱响曎快地定䜍问题并验证数据提升应甚的调试效率。 +变量检查Variable Inspect是䞀䞪䜍于工䜜流应甚底郚的看板记圕各䞪节点圚执行任务后的蟓入蟓出数据垮助匀发者快速定䜍问题和验证数据流蜬。 ## 功胜价倌 -[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量记圕着甚户的蟓入数据以及各节点内的蟓出数据䟋劂倧暡型的蟓出工具的蟓出结果、对话历史䞊䞋文和环境配眮参数等。 +[变量](/zh-hans/guides/workflow/variables)是连接节点之闎的重芁桥梁也是实现劚态流皋控制的基础。圚工䜜流应甚䞭变量记圕了甚户蟓入的数据以及各节点内的蟓出数据䟋劂倧暡型蟓出工具调甚结果、对话历史䞊䞋文及环境配眮参数等。 -> 工䜜流应甚是对 Chatflow 和 Workflow 类型应甚的统称。 +变量检查视囟将圚节点运行后自劚猓存每䞪节点所接受的蟓入参数以及运行后所蟓出的变量倌。 -变量检查视囟可以被理解䞺是䞀䞪猓存变量倌的功胜提䟛以䞋栞心功胜 +提䟛以䞋栞心功胜 -- **实时变量监控**自劚捕获并星瀺节点执行后产生的所有变量倌记圕工䜜流的蟓入和蟓出数据 -- **变量倌猖蟑䞎暡拟**允讞匀发者手劚修改倧倚数类型变量的倌无需重新运行䞊枞节点即可测试䞍同条件䞋的节点行䞺 -- **匂垞数据远螪**星瀺变量类型䞎实际倌垮助快速定䜍数据栌匏䞍匹配或结构错误等问题 -- **党局状态管理**圚单䞀界面集䞭展瀺变量信息包括系统变量、环境变量和节点内的自定义变量等 +- **实时变量监控**自劚捕获并星瀺节点执行后产生的所有变量倌记圕工䜜流的蟓入和蟓出数据。 +- **猓存变量倌猖蟑**允讞匀发者手劚修改倧倚数类型变量的倌而无需重新运行䞊枞节点䟿于暡拟䞍同场景。 +- **匂垞数据远螪**展瀺变量的实际倌及其类型䟿于识别栌匏䞍笊、猺字段、类型错误等问题。 +- **党局状态管理**圚单䞀界面集䞭展瀺变量信息包括系统变量、环境变量和节点内的自定义变量等。 + +通过变量检查匀发者可以盎观地观察䞊次运行时各䞪节点的蟓出变量同时可以圚其䞭盎接进行修改观察新数据对于后续节点的圱响曎快地定䜍问题并验证数据提升应甚的调试效率。 ## 䜿甚方法 变量检查䜍于画垃底郚随着工䜜流运行实时曎新变量倌。 -圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭䟿于匀发者查扟。该功胜可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌包含节点蟓出变量、䌚话变量/埪环变量。其状态䞺可猖蟑/枅陀代衚圓前工䜜流的实时状态。 +圓某䞪节点运行后其蟓出变量将自劚出现圚变量检查䞭䟿于匀发者查扟。该功胜可以垮助匀发者管理圓前工䜜流应甚内所涉及的所有变量所对应的数据它展瀺工䜜流䞭所有已创建变量及其圓前倌。 ![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) -支持的䞻芁操䜜包括 +䞋文将以䞀䞪“查询倖郚数据库”应甚䜜䞺案䟋挔瀺变量视囟的操䜜方法。该应甚的流皋是查询倖郚数据库的应甚。LLM 节点圚接受自然语蚀后自劚蜬译䞺 SQL 语法向倖郚数据库发送请求并接受数据。 -- **查看**展匀变量查看圓前结构及内容支持对象/数组层级展匀 -- **枅陀**点击 **Clear** 按钮枅陀圓前所有已记圕的变量猓存甚于重新调试 -- **重眮**恢倍至䞊䞀次运行时的变量状态 -- **猖蟑**修改某䞪变量所对应的数据 +> 点击[歀倄](https://assets-docs.dify.ai/2025/06/ac4da5ed5506f8a34aae7f0b88323f37.yml)䞋蜜 DSL 应甚文件。 -## 支持的变量和数据类型 +### 查看 -### 变量类型瀺䟋 +节点运行后其蟓出变量䌚自劚星瀺圚底郚面板䞭。点击变量可以查看诊细内容。 -| 变量类别 | 瀺䟋变量 | 描述 | 是吊可以被猖蟑 +![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png) + +### 猖蟑 + +点击变量倌盎接修改内容。修改后䞋枞节点可以䜿甚新的变量倌。 + +#### 瀺䟋䞀默讀运行结果 + +甚户蟓入“查询所有甚户数据”呜什LLM 节点自劚生成了 `SELECT * FROM users;` 呜什数据库正确返回了所有数据。 + +![](https://assets-docs.dify.ai/2025/06/dcf4b0048bf1ed802369ab10731a4848.png) + +#### 瀺䟋二修改变量倌后的结果 + +甚户圚变量面板䞭手劚将 SQL 修改䞺 `SELECT username FROM users;`随后仅重新运行数据库节点系统将返回甚户名列衚。 + +手劚修改变量倌后手劚运行䞋枞的数据库节点即可重新查询新的数据而无需重新运行敎䞪工䜜流 + +![](https://assets-docs.dify.ai/2025/06/fb8c49fc0c8c63866f1a9379e8752d9e.png) + +### 回退 + +点击猖蟑框右䞊角的回退按钮恢倍到原始倌。 + +![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png) + +### 重眮所有变量 + +点击巊䞊角 Reset all 按钮枅空所有变量猓存。 + +{/* + +支持展瀺的变量类型 + +以䞋变量类型将䌚圚变量视囟内进行展瀺䞔郚分变量允讞被猖蟑。 + +| 变量类别 | 瀺䟋变量 | 描述 | |---------|---------|------| | **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提䟛的圓前䌚话信息 | -| **节点蟓出变量** | output, structured_output, usage, loop_variable | 各节点的蟓出结果 | -| **匂垞变量** | error_message, error_type | 节点的匂垞蟓出结果 | +| **环境变量** | OPENAI_KEY, SECRET | 系统环境配眮 | | **自定义变量** | [甚户定义名称], 文件变量 | 甚户圚匀始节点䞭自定义的蟓入变量䞊䌠的文件变量 | -| **环境变量** | OPENAI_KEY, PORT | 系统环境配眮 | -| **埪环变量** | OPENAI_KEY, PORT | 系统环境配眮 | +| **节点蟓出变量** | output, structured_output, usage, loop_variable, iteration_variable | 各节点的蟓出结果 | -### 数据类型瀺䟋 - -| 类型 | 描述 | 瀺䟋 | -|------|------|------| -| `string` | 文本类型垞甚于暡型蟓入蟓出 | `"Hello, world!"` | -| `number` | 数倌类型适甚于评分、标记等场景 | `0.85` | -| `boolean` | 垃尔倌甚于条件刀断节点 | `true` / `false` | -| `object` | 结构化 JSON 数据 | `{ "key": "value" }` | -| `array` | 列衚数组适甚于倚项蟓出/䞊䞋文记圕 | `[1, 2, 3]` | -| `secret` | 隐私变量劂 API 密钥 | `******` | - -## 实践瀺䟋 - -> 该郚分文档埅补充最奜是给䞀䞪 DSL 瀺䟋还圚准倇 - -假讟存圚䞀䞪工䜜流数据获取(A 节点) → 数据倄理(B 节点) → 结果展瀺(C 节点)。 - -B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据将圱响 B 节点的运行情况。 - -运行 A 节点后的蟓出变量倌将保存至“变量检查”内。匀发者可以修改“变量检查”内的数据验证对于 B 节点的圱响而无需手劚再次运行 A 节点。 - -逐步执行过皋䞭䜠可以观察局郚工䜜流的运行情况基于结果及时调敎节点的配眮、数据流向和倄理逻蟑确保工䜜流的效率和准确性。 +*/} From b1b582b3a279698ad8d2189744acd16e9597421b Mon Sep 17 00:00:00 2001 From: alterxyz <88554920+alterxyz@users.noreply.github.com> Date: Tue, 17 Jun 2025 10:13:56 +0000 Subject: [PATCH 09/15] Docs tools: Successfully completed 3 operations --- .../debug-and-preview/debug-node-block-point.mdx | 11 +++++++++++ .../workflow/debug-and-preview/history-and-logs.mdx | 11 +++++++++++ .../workflow/debug-and-preview/preview-and-run.mdx | 11 +++++++++++ .../workflow/debug-and-preview/step-by-step-run.mdx | 11 +++++++++++ .../guides/workflow/debug-and-preview/step-run.mdx | 11 +++++++++++ .../workflow/debug-and-preview/variable-inspect.mdx | 11 +++++++++++ 6 files changed, 66 insertions(+) diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx index d89eeeec..9c7ec305 100644 --- a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx @@ -56,3 +56,14 @@ Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关 ![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) 劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20-node-block-po&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fdebug-node-block-point.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx index 593e6dd1..3f598137 100644 --- a/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -57,3 +57,14 @@ title: 调试历史 陀了查看应甚敎䜓的运行历史䜠还可以圚工䜜流猖蟑界面䞭查看单䞪节点圚最后䞀次调试过皋时产生的记圕。点击任意节点内节点配眮面板䞭的 **䞊次运行**查看节点的蟓入蟓出记圕。 ![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/history-and-logs.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20ry-and-l&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index 91c8fab4..d921044e 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -64,3 +64,14 @@ title: 功胜简介 - [运行历史](/zh-hans/guides/workflow/debug-and-preview/history) - [监测](/zh-hans/guides/monitoring/README) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20ew-and-&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fpreview-and-run.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx index 51deb251..8cb8aab5 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx @@ -13,3 +13,14 @@ title: 单步调试 单步测试运行后可以查看运行状态、蟓入/蟓出、元数据信息。 ![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/040e1051d33b94d35e4683d3c89691a8.png) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20by-step-&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fstep-by-step-run.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx index 95b98656..5ef252be 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx @@ -83,3 +83,14 @@ B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据 ![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) 劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/step-run.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fstep-run.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx index 9e094087..5121e3f9 100644 --- a/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -82,3 +82,14 @@ title: 变量检查 | **节点蟓出变量** | output, structured_output, usage, loop_variable, iteration_variable | 各节点的蟓出结果 | */} + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20ble-insp&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + From 2b855b331d498c42d7db2ae2aca258deedcf52b3 Mon Sep 17 00:00:00 2001 From: AllenWriter Date: Mon, 23 Jun 2025 15:59:40 +0800 Subject: [PATCH 10/15] Docs: update step run node --- docs.json | 5 +- .../debug-and-preview/history-and-logs.mdx | 69 +++++++++++++++ en/guides/workflow/debug-and-preview/log.mdx | 21 ----- .../debug-and-preview/preview-and-run.mdx | 68 +++++++++++++-- .../workflow/debug-and-preview/step-run.mdx | 84 +++++++++++++++++-- .../debug-and-preview/variable-inspect.mdx | 84 +++++++++++++++++++ 6 files changed, 295 insertions(+), 36 deletions(-) create mode 100644 en/guides/workflow/debug-and-preview/history-and-logs.mdx delete mode 100644 en/guides/workflow/debug-and-preview/log.mdx create mode 100644 en/guides/workflow/debug-and-preview/variable-inspect.mdx diff --git a/docs.json b/docs.json index 9917dbff..bce2a953 100644 --- a/docs.json +++ b/docs.json @@ -129,9 +129,8 @@ "pages": [ "en/guides/workflow/debug-and-preview/preview-and-run", "en/guides/workflow/debug-and-preview/step-run", - "en/guides/workflow/debug-and-preview/log", - "en/guides/workflow/debug-and-preview/checklist", - "en/guides/workflow/debug-and-preview/history" + "en/guides/workflow/debug-and-preview/history-and-logs", + "en/guides/workflow/debug-and-preview/variable-inspect" ] }, "en/guides/workflow/publish", diff --git a/en/guides/workflow/debug-and-preview/history-and-logs.mdx b/en/guides/workflow/debug-and-preview/history-and-logs.mdx new file mode 100644 index 00000000..769cea56 --- /dev/null +++ b/en/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -0,0 +1,69 @@ +--- +title: History and Logs +--- + +When you debug a Chatflow or Workflow, Dify automatically records detailed logs — both at the run level and for individual nodes. These logs make it easier to locate issues, understand how data flows through your workflow, and fine-tune performance. + + + To explore logs from real users after your application is published, check out [Logs and Annotation](/en/guides/annotation/logs). + + +There are two dimensions of execution records for applications. + +## Application Run History + +Each time the application runs, a **Run History** is recorded. Each run is versioned and includes the application's **Conversation Log** as well as **Tracing Logs** for all nodes in that version. These logs are displayed chronologically and provide basic information about each interaction, including execution time, status, and a summary of input/output parameters. + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +Click on any log entry to see the detailed execution view. Each run includes three major sections: + +### RESULT + + + The result section is available only for Workflow applications. + + +This section displays the final output result of the workflow — the content the user sees. If the workflow failed to execute, this section shows error messages and reasons. + +![](https://assets-docs.dify.ai/2025/06/22856751d278ffad99d0533d2d96e125.png) + +### DETAIL + +This section includes comprehensive input parameters, metadata, and configuration context from the execution. You can inspect: + +- The original input provided by the user +- Output generated by the application +- System-generated metadata + +![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) + +### TRACING + +This view provides in-depth visibility into the execution path and system behavior. It includes: + +- **Node execution order**: The actual runtime order of each node in the workflow. +- **Data flow tracking**: How variables are passed and transformed between nodes. This can also be explored via the [Variable Inspector](/en/guides/workflow/debug-and-preview/variable-inspect). +- **Execution time analysis**: Time spent on each node helps identify performance bottlenecks. +- **Resource usage**: Token consumption, API calls, and cost-related data. +- **Error tracking**: Identify exactly which node failed and why. + +![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) + +The tracing view is especially useful for debugging complex workflows and optimizing performance. If your workflow includes branches or loops, this view helps reveal the actual path taken during execution. + +## Node Execution Logs + +In addition to application-level logs, you can also inspect the **last run log** for each individual node directly within the workflow editor. Click **Last run** in the node’s config panel to view its most recent execution details, including input/output data. + +![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/history-and-logs.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20history-and-logs&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) diff --git a/en/guides/workflow/debug-and-preview/log.mdx b/en/guides/workflow/debug-and-preview/log.mdx deleted file mode 100644 index 639c2f52..00000000 --- a/en/guides/workflow/debug-and-preview/log.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Conversation/Run Logs ---- - - -Clicking **"Run History - View Log — Details"** allows you to see a comprehensive overview of the run in the details section. This includes information on inputs and outputs, metadata, and other relevant data. - -This detailed information enables you to review various aspects of each node throughout the complete execution process of the workflow. You can examine inputs and outputs, analyze token consumption, evaluate runtime duration, and assess other pertinent metrics. - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/4eda6b3f833f12ae2ce1a23348678f49.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/log.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Flog.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) - diff --git a/en/guides/workflow/debug-and-preview/preview-and-run.mdx b/en/guides/workflow/debug-and-preview/preview-and-run.mdx index 3a565e1e..5d36e453 100644 --- a/en/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/en/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -1,17 +1,73 @@ --- -title: Preview and Run +title: Introduction --- +Once you’ve created a workflow, it’s important to test it thoroughly before going live. Dify offers a full set of debugging tools that let you troubleshoot issues, track variable flow, and review detailed execution logs — all in one place. -Dify Workflow offers a comprehensive set of execution and debugging features. In conversational applications, clicking "Preview" enters debugging mode. +Dify provides a comprehensive debugging toolset to help you quickly locate issues, inspect variable transmission, and view detailed logs. -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/91379dc42d0d815e52ddad0cc5450a46.png) +This article introduces the full workflow debugging process, including single-node debugging, variable inspection, execution history, and end-to-end testing. -In workflow applications, clicking "Run" enters debugging mode. +![](https://assets-docs.dify.ai/2025/06/8e7933b45a69241a9861a09fa47d5c62.png) -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/b92d7536392b1e1f2423d0e3aa113915.png) +## Debugging a Workflow Application -Once in debugging mode, you can debug the configured workflow using the interface on the right side of the screen. +### Single Node Debugging + +If a specific node causes the workflow to fail, you can debug that node individually to quickly identify the issue. + +To test a single node, click the debug icon in its top-right corner. Try entering some simple test data and observe the output. You can gradually introduce more complex input to see how the node responds. + +For more details, see [Debug Node](/en/guides/workflow/debug-and-preview/debug-node). + +![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png) + +### Step-by-Step Node Debugging + +This method lets you trace how data flows through each step — from one node to the next — helping you catch issues in real-time. + +For detailed usage, see [Variable Inspection](/en/guides/workflow/debug-and-preview/variable-inspect). + +![](https://assets-docs.dify.ai/2025/06/887630764b180a60becb6a4fcee2c622.png) + +### View Node Execution History + +Click “Last Run” in the node panel to review logs from the most recent execution — including inputs, outputs, timing, and any errors. + +See [Debug History - Node Logs](/en/guides/workflow/debug-and-preview/history-and-logs#node-execution-logs) for more details. + +![](https://assets-docs.dify.ai/2025/06/a6011d5966c78a4d1705f2af44ed8af1.png) + +### Debugging the Entire Workflow + +After you’ve confirmed that each individual node works as expected, it’s time to test the entire workflow from start to finish. + +Use the Preview feature to experience the final user interface. This mode displays the input fields, output area, and interaction flow — ideal for confirming user experience expectations. During preview, the system performs an auto-check to ensure all nodes are configured correctly and connected. + +![](https://assets-docs.dify.ai/2025/06/de00849b363ec9356e5764b88b4331fb.png) + +#### Configuration Checklist + +Before you run the full workflow, Dify will automatically check for missing parameters, misconfigurations, or disconnected nodes — and prompt you to fix them. + +![](https://assets-docs.dify.ai/2025/06/85bafda1f786549c22404cd5ec711d0f.png) + +While running the workflow, you can view each node's execution status on the right panel, including input/output and logs. Use the status indicators (green = success) to identify where a failure may have occurred. + +It’s recommended to perform multiple test rounds with varying data types and complexities to verify workflow stability before going live. + +![](https://assets-docs.dify.ai/2025/06/c09f788f77b5f8ebdd635ddba66a1b99.png) + +## View Application Logs + +After publishing your application, you can monitor how it’s performing and how users interact with it. Dify’s logs and monitoring tools help you troubleshoot issues, track performance trends, and better understand user behavior. + +![](https://assets-docs.dify.ai/2025/06/6dd8e8a7186089a390679b6de4bb97b9.png) + +For more information, see: + +- [Run History](/en/guides/workflow/debug-and-preview/history) +- [Monitoring](/en/guides/monitoring/README) {/* Contributing Section diff --git a/en/guides/workflow/debug-and-preview/step-run.mdx b/en/guides/workflow/debug-and-preview/step-run.mdx index 2d8540ee..51950078 100644 --- a/en/guides/workflow/debug-and-preview/step-run.mdx +++ b/en/guides/workflow/debug-and-preview/step-run.mdx @@ -1,15 +1,88 @@ --- -title: Step Run +title: Debug Node --- +Workflow or Chatflow application is made up of multiple interconnected nodes. To make sure everything works as intended, it’s crucial to test how each node handles input and produces output — before going live. -Workflow supports step-by-step debugging of nodes, where you can repetitively test whether the execution of the current node meets expectations. +With the Step Run feature, you can catch potential issues early by verifying your application’s behavior step by step — helping you avoid errors before publishing. -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/36e547165a5088510c99baee4ce42bcd.png) +There are two types of node debugging: single-step run and step-by-step execution. -After running a step test, you can review the execution status, input/output, and metadata information. +## Single-Step Run -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/040e1051d33b94d35e4683d3c89691a8.png) +### Overview + +Single-step run allows you to test a specific node in isolation without executing the entire workflow. It is helpful for verifying new nodes, troubleshooting individual node errors, or testing responses to various inputs. + +### How to Use + +1. Select the node you want to debug in the workflow editor +2. Provide test input variables in the node’s settings panel +3. Click **Run** to execute the node +4. Review the output and check if the results are as expected + +### Example + +Suppose you've added an HTTP node. To verify whether it correctly fetches and handles API responses, you can use single-step run to simulate actual conditions and confirm it passes data correctly to downstream nodes. + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +After debugging, you can click "Last run" to check execution status, view inputs/outputs, and inspect metadata. If an error occurs, the message will help you locate and fix the problem to avoid full workflow failure. + + + Answer and End nodes do not support single-step run. + + +## Step-by-Step Execution + +### Overview + +Workflow execution relies on proper data flow between nodes. In complex workflows, this process can easily fail due to: + +- Data format mismatches (e.g., text passed to a number input) +- Misconfigured variables +- JSON parsing failures +- Incorrect variable path references + +Step-by-step execution helps developers troubleshoot errors in multi-node workflows. + +During this process, node output variables are cached in the [Variable Inspector](/en/guides/workflow/debug-and-preview/variable-inspect). You can edit upstream variables directly to test how downstream nodes respond to different data values. + +This method is particularly useful when your workflow contains nodes that depend on each other’s outputs. Rather than rerunning the entire chain, you can simulate different scenarios quickly by editing cached variables. + +![](https://assets-docs.dify.ai/2025/06/f8656d8deeeaefeab0a8d9169f0ed2d3.png) + +After running a node, its output is saved to the Variable Inspector. You can use this tool to: + +1. **View actual data**: Check if the output meets expectations +2. **Edit test data**: Modify variable values to test downstream behavior +3. **Validate data flow**: Ensure values are correctly passed between nodes + +### How to Use + +1. Run a single node in the workflow +2. Open the Variable Inspector at the bottom +3. Locate the node and check which variables it references +4. Modify those variable values and rerun the node +5. Compare results and evaluate impact + +### Example + +Suppose your workflow has the following steps: Data Fetch (Node A) → Data Processing (Node B) → Result Display (Node C). + +Node B depends entirely on the output of Node A, and different inputs will change its behavior. + +After running Node A, its output will be cached in the Variable Inspector. You can modify that data directly and rerun Node B without needing to re-execute Node A. + +This approach lets you observe localized behavior and make timely adjustments to node settings, data flow, and logic, improving overall workflow reliability and accuracy. + +## View Node Execution History + +Every time a node is executed, a record is generated. Click “Last run” on the node details panel to view it. + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) + +To view the full workflow’s execution history, see [Run History](/en/guides/workflow/debug-and-preview/history). {/* Contributing Section @@ -20,4 +93,3 @@ It will be automatically generated by the script. --- [Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/step-run.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fstep-run.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) - diff --git a/en/guides/workflow/debug-and-preview/variable-inspect.mdx b/en/guides/workflow/debug-and-preview/variable-inspect.mdx new file mode 100644 index 00000000..33acc952 --- /dev/null +++ b/en/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -0,0 +1,84 @@ +--- +title: Variable Inspector +--- + +The **Variable Inspector** is a panel located at the bottom of the workflow editor. It captures the input and output data of each node after execution, helping developers quickly identify issues and verify data flow throughout the workflow. + +## Why It Matters + +[Variables](/en/guides/workflow/variables) act as key connectors between nodes and enable dynamic flow control. In workflow applications, variables store user input as well as outputs from each node — such as LLM responses, tool results, conversation context, and environment parameters. + +The Variable Inspector automatically caches each node's input parameters and output results after execution. It provides the following key features: + +- **Real-time variable monitoring**: Captures and displays all variables right after a node runs, including workflow inputs and outputs. +- **Edit cached variables**: Lets you manually change most variable types without re-running upstream nodes — ideal for testing different scenarios. +- **Abnormal data tracking**: Displays the actual value and type of each variable, making it easier to identify format issues, missing fields, or type mismatches. +- **Global state management**: Displays all variables in a single panel, including system variables, environment variables, and custom-defined node variables. + +With the Variable Inspector, you can easily view and edit the latest output variables from any node to see how changes affect downstream nodes. + +## How to Use + +The Variable Inspector is located at the bottom of the canvas and updates in real time as the workflow runs. + +After a node runs, its output variables show up in the panel so you can quickly inspect or edit them. + +![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) + +The following is an example of how to use the Variable Inspector in an "external database query" application. In this workflow, an LLM node receives natural language input, translates it into SQL, sends the query to a remote database, and retrieves the data. + +> Click [here](https://assets-docs.dify.ai/2025/06/ac4da5ed5506f8a34aae7f0b88323f37.yml) to download the DSL workflow file. + +### Viewing + +Once a node is executed, its output variables automatically appear in the Variable Inspector. Click a variable to view its detailed content. + +![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png) + +### Editing + +Click a variable’s value to edit it. The updated value will be used by downstream nodes during the next run. + + + Editing variable values here does not affect the cached data in the node's “Last run” record. + + +**Example:** + + + + The user inputs “Show all user data,” and the LLM node generates `SELECT * FROM users;`. The database correctly returns all data. + + + + The user manually modifies the SQL in the Variable Inspector to `SELECT username FROM users;` and re-runs only the database node. The system returns a list of usernames. + + This allows the user to test new data by re-running only the downstream database node without restarting the entire workflow. + + + + +### Revert + +Click the revert icon at the top-right of the variable edit field to restore the variable to its original value. + +![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png) + +### Reset All Variables + +Click **Reset all** in the top-left corner to clear every cached variable at once. + +{/* + +### Supported Variable Types + +The following types appear in the Variable Inspector. Some of them can be edited. + +| Type | Example | Description | +|-----------------------|-----------------------------------------|--------------------------------------------| +| **System Variables** | sys.query, sys.user_id, sys.conversation_id | System-provided runtime context | +| **Environment Variables** | OPENAI_KEY, SECRET | Values from environment configuration | +| **Custom Variables** | [user-defined name], uploaded file | Inputs defined in the Start node or uploaded by the user | +| **Node Output Variables** | output, structured_output, usage, loop_variable, iteration_variable | Outputs generated by each node | + +*/} From 05c1e0435b450c5cb659aa1b0eff46f5c44f4e0b Mon Sep 17 00:00:00 2001 From: alterxyz <88554920+alterxyz@users.noreply.github.com> Date: Mon, 23 Jun 2025 08:00:00 +0000 Subject: [PATCH 11/15] Docs tools: Successfully completed 3 operations --- .../workflow/debug-and-preview/history-and-logs.mdx | 3 ++- en/guides/workflow/debug-and-preview/step-run.mdx | 1 + .../workflow/debug-and-preview/variable-inspect.mdx | 11 +++++++++++ 3 files changed, 14 insertions(+), 1 deletion(-) diff --git a/en/guides/workflow/debug-and-preview/history-and-logs.mdx b/en/guides/workflow/debug-and-preview/history-and-logs.mdx index 769cea56..062b0363 100644 --- a/en/guides/workflow/debug-and-preview/history-and-logs.mdx +++ b/en/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -66,4 +66,5 @@ It will be automatically generated by the script. --- -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/history-and-logs.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20history-and-logs&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) +[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/history-and-logs.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20ry-and-l&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) + diff --git a/en/guides/workflow/debug-and-preview/step-run.mdx b/en/guides/workflow/debug-and-preview/step-run.mdx index 51950078..1ec73549 100644 --- a/en/guides/workflow/debug-and-preview/step-run.mdx +++ b/en/guides/workflow/debug-and-preview/step-run.mdx @@ -93,3 +93,4 @@ It will be automatically generated by the script. --- [Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/step-run.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fstep-run.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) + diff --git a/en/guides/workflow/debug-and-preview/variable-inspect.mdx b/en/guides/workflow/debug-and-preview/variable-inspect.mdx index 33acc952..76c94208 100644 --- a/en/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/en/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -82,3 +82,14 @@ The following types appear in the Variable Inspector. Some of them can be edited | **Node Output Variables** | output, structured_output, usage, loop_variable, iteration_variable | Outputs generated by each node | */} + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/variable-inspect.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20ble-insp&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) + From 68754a55e720d29868f7fb545a1fecdbe52d3d1c Mon Sep 17 00:00:00 2001 From: Hanqing Zhao Date: Tue, 24 Jun 2025 16:01:50 +0800 Subject: [PATCH 12/15] Add jp translation for debug-and-preview --- docs.json | 21 ++--- .../workflow/debug-and-preview/README.mdx | 14 ---- .../workflow/debug-and-preview/checklist.mdx | 19 ----- .../workflow/debug-and-preview/debug-node.mdx | 71 ++++++++++++++++ .../debug-and-preview/history-and-logs.mdx | 70 ++++++++++++++++ .../workflow/debug-and-preview/history.mdx | 19 ----- .../guides/workflow/debug-and-preview/log.mdx | 23 ------ .../debug-and-preview/preview-and-run.mdx | 79 ++++++++++++++++++ .../workflow/debug-and-preview/step-run.mdx | 81 ++++++++++++++++++- .../debug-and-preview/variable-inspect.mdx | 80 ++++++++++++++++++ .../debug-and-preview/yu-lan-yu-yun-hang.mdx | 27 ------- 11 files changed, 383 insertions(+), 121 deletions(-) delete mode 100644 ja-jp/guides/workflow/debug-and-preview/README.mdx delete mode 100644 ja-jp/guides/workflow/debug-and-preview/checklist.mdx create mode 100644 ja-jp/guides/workflow/debug-and-preview/debug-node.mdx create mode 100644 ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx delete mode 100644 ja-jp/guides/workflow/debug-and-preview/history.mdx delete mode 100644 ja-jp/guides/workflow/debug-and-preview/log.mdx create mode 100644 ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx create mode 100644 ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx delete mode 100644 ja-jp/guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.mdx diff --git a/docs.json b/docs.json index bce2a953..fdee8c6c 100644 --- a/docs.json +++ b/docs.json @@ -127,6 +127,7 @@ { "group": "Debug and Preview", "pages": [ + "en/guides/workflow/debug-and-preview/debug-node", "en/guides/workflow/debug-and-preview/preview-and-run", "en/guides/workflow/debug-and-preview/step-run", "en/guides/workflow/debug-and-preview/history-and-logs", @@ -754,6 +755,7 @@ { "group": "预览䞎调试", "pages": [ + "zh-hans/guides/workflow/debug-and-preview/debug-node", "zh-hans/guides/workflow/debug-and-preview/preview-and-run", "zh-hans/guides/workflow/debug-and-preview/step-run", "zh-hans/guides/workflow/debug-and-preview/history-and-logs", @@ -1413,10 +1415,11 @@ { "group": "プレビュヌずデバッグ", "pages": [ + "ja-jp/guides/workflow/debug-and-preview/debug-node", + "ja-jp/guides/workflow/debug-and-preview/preview-and-run", "ja-jp/guides/workflow/debug-and-preview/step-run", - "ja-jp/guides/workflow/debug-and-preview/log", - "ja-jp/guides/workflow/debug-and-preview/checklist", - "ja-jp/guides/workflow/debug-and-preview/history" + "ja-jp/guides/workflow/debug-and-preview/history-and-logs", + "ja-jp/guides/workflow/debug-and-preview/variable-inspect" ] }, "ja-jp/guides/workflow/publish", @@ -2384,18 +2387,6 @@ "source": "/guides/workflow/debug-and-preview/step-run", "destination": "/en/guides/workflow/debug-and-preview/step-run" }, - { - "source": "/guides/workflow/debug-and-preview/log", - "destination": "/en/guides/workflow/debug-and-preview/log" - }, - { - "source": "/guides/workflow/debug-and-preview/checklist", - "destination": "/en/guides/workflow/debug-and-preview/checklist" - }, - { - "source": "/guides/workflow/debug-and-preview/history", - "destination": "/en/guides/workflow/debug-and-preview/history" - }, { "source": "/guides/workflow/publish", "destination": "/en/guides/workflow/publish" diff --git a/ja-jp/guides/workflow/debug-and-preview/README.mdx b/ja-jp/guides/workflow/debug-and-preview/README.mdx deleted file mode 100644 index b93a98dc..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/README.mdx +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: デバッグプレビュヌ ---- - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/README.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2FREADME.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - diff --git a/ja-jp/guides/workflow/debug-and-preview/checklist.mdx b/ja-jp/guides/workflow/debug-and-preview/checklist.mdx deleted file mode 100644 index a5817d19..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/checklist.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: チェックリスト ---- - - -調敎動䜜に入る前に、未完了の蚭定や接続されおいないノヌドがないかチェックリストで確認できたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/16201deaa47a518ff73c983a33ab4002.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/checklist.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20l&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fchecklist.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - diff --git a/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx b/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx new file mode 100644 index 00000000..f08709f7 --- /dev/null +++ b/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx @@ -0,0 +1,71 @@ +--- +title: ノヌドのデバッグ +--- + +ワヌクフロヌやチャットフロヌアプリケヌションは通垞、耇数のノヌドで構成されおおり、それぞれのノヌドは盞互に関連しおいたす。アプリケヌション党䜓が正垞に動䜜するこずを確認するためには、各ノヌドの入出力が期埅通りであるこずをチェックする必芁がありたす。ノヌドのデバッグ機胜は、開発者がアプリケヌションが蚭蚈通りにサヌビスを提䟛しおいるかを怜蚌し、朜圚的な問題を事前に発芋・解決する手助けを行い、運甚環境での゚ラヌを未然に防ぐのに圹立ちたす。 + +以䞋の二぀のモヌドでノヌドをデバッグするこずができたす。 + +## 単䞀ステップデバッグ + +単䞀ステップデバッグでは、ワヌクフロヌ内の特定のノヌドを、ワヌクフロヌ党䜓を実行するこずなく独立しおテストするこずが可胜です。これにより、開発者はアプリケヌションに新しいノヌドを远加する際にその機胜を怜蚌したり、特定のノヌドの゚ラヌをトラブルシュヌティングしたり、異なる入力に察するノヌドの応答を確認するこずができたす。 + +### 操䜜手順 + +1. ワヌクフロヌ線集画面でデバッグしたいノヌドを遞択したす。 +2. ノヌドの右䞊にある **ステップ実行run step** ボタンをクリックしたす。 +3. 衚瀺されるデバッグパネルでそのノヌドの入力倉数を入力したす。 +4. 実行ボタンをクリックしおノヌドの実行をトリガヌしたす。 +5. ノヌドの出力結果ず実行状態を確認したす。 + +䟋えば、ワヌクフロヌにHTTPノヌドを远加した堎合、そのノヌドがAPIレスポンスを正しく取埗し凊理できるかを確認するために、䞋流ノヌドに圱響を䞎えるこずなく、単䞀ステップデバッグ機胜を䜿っおノヌドの実際の動䜜をシミュレヌトするこずができたす。 + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +デバッグが完了するず、珟圚のノヌドの実行状態、入出力、メタデヌタ情報を確認できたす。゚ラヌが発生した堎合は、゚ラヌメッセヌゞを通じお迅速に問題を特定し、ノヌドの異垞によるアプリケヌション党䜓の実行倱敗を防ぐこずができたす。 + + + 回答ノヌドや終了ノヌドは単䞀ステップデバッグをサポヌトしおいたせん。 + + +## 段階的実行 + +段階的実行は、盞互に䟝存する耇数のノヌドの組み合わせをテストするのに適しおおり、特にノヌドの入力が䞊流ノヌドの出力に䟝存しおいる堎合に有効です。単䞀ステップデバッグずは異なり、段階的実行は開始ノヌドから始たり、ワヌクフロヌのパスに沿っお指定されたノヌドたで順番に実行したす。 + +### 操䜜手順 + +1. ワヌクフロヌ線集画面で終点ずしたい目暙ノヌドを遞択したす。 +2. そのノヌドの右䞊にある **run to** ボタンをクリックしお段階的実行機胜を有効にしたす。 +3. システムは開始ノヌドから始たり、ワヌクフロヌのパスに沿っお目暙ノヌドたで順番に実行したす。 +4. 実行完了埌、各ノヌドの実行状態ず出力結果を確認できたす。 + +䟋えば、デヌタ取埗Aノヌド→デヌタ凊理Bノヌド→結果衚瀺Cノヌドずいうワヌクフロヌがあり、Bノヌドの機胜はAノヌドの出力に完党に䟝存しおいるずしたす。段階的実行機胜を䜿甚するこずで、Bノヌドを遞択し「run to」をクリックするず、システムは最初にAノヌドを実行し、その埌Bノヌドを実行したす。このプロセスによっお、二぀のノヌド間のデヌタ受け枡しが正垞に行われおいるかを確認するこずができたす。 + +段階的実行の過皋で、郚分的なワヌクフロヌの動䜜を芳察し、結果に基づいおノヌドの蚭定、デヌタの流れ、凊理ロゞックをタむムリヌに調敎するこずで、ワヌクフロヌの効率性ず正確性を確保するこずができたす。 + +![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) + + + 質問分類ノヌドや条件ノヌドなど、耇数の分岐凊理がある堎合は、段階的実行機胜をサポヌトしおいたせん。 + + +## ノヌドの実行蚘録の確認 + +各ノヌドの実行が完了するず操䜜ログが生成されたす。ノヌド詳现ペヌゞの「Last run」をクリックするこずで、実行履歎を確認できたす。 + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) + +アプリケヌション党䜓の実行履歎を確認する堎合は、[実行履歎](/ja-jp/guides/workflow/debug-and-preview/history-and-logs)を参照しおください。 + +--- + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/debug-node-block-point.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fdebug-node-block-point.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) + diff --git a/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx b/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx new file mode 100644 index 00000000..6cd82385 --- /dev/null +++ b/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -0,0 +1,70 @@ +--- +title: 実行履歎ずログ +--- + +チャットフロヌやワヌクフロヌをデバッグする際、Difyは実行レベルず各ノヌドの䞡方に぀いお詳现なログを自動的に蚘録したす。これらのログにより、問題の特定、ワヌクフロヌ内のデヌタ流れの理解、パフォヌマンスの埮調敎が容易になりたす。 + + + アプリケヌションが公開された埌の実際のナヌザヌからのログを調査するには、[ログずアノテヌション](/ja-jp/guides/annotation/logs.mdx)をご確認ください。 + + +アプリケヌションの実行履歎には2぀の偎面がありたす。 + +## アプリケヌション実行履歎 + +アプリケヌションが実行されるたびに、**実行履歎Run History**が蚘録されたす。各実行はバヌゞョン管理され、アプリケヌションの**䌚話ログConversation Log**やそのバヌゞョンのすべおのノヌドに関する**远跡ログTRACING**が含たれたす。これらのログは時系列で衚瀺され、各むンタラクションに関する基本情報実行時間、ステヌタス、入出力パラメヌタの抂芁などを提䟛したす。 + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +任意のログ゚ントリをクリックするず、詳现な実行ビュヌが衚瀺されたす。各実行には次の3぀の䞻芁セクションがありたす + +### 結果RESULT + + + 結果セクションはワヌクフロヌアプリケヌションでのみ利甚可胜です。 + + +このセクションでは、ワヌクフロヌの最終出力結果、぀たりナヌザヌが芋るコンテンツを衚瀺したす。ワヌクフロヌの実行が倱敗した堎合、このセクションにぱラヌメッセヌゞずその理由が衚瀺されたす。 + +![](https://assets-docs.dify.ai/2025/06/22856751d278ffad99d0533d2d96e125.png) + +### 詳现DETAIL + +このセクションには、実行からの包括的な入力パラメヌタ、メタデヌタ、及び構成コンテキストが含たれおいたす。以䞋の内容を確認できたす + +- ナヌザヌから提䟛された元の入力 +- アプリケヌションによっお生成された出力 +- システム生成のメタデヌタ + +![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) + +### 远跡TRACING + +このビュヌは、実行パスずシステム動䜜に぀いお深い可芖性を提䟛したす。以䞋が含たれたす + +- **ノヌド実行順序**ワヌクフロヌ内の各ノヌドの実際の実行時順序。 +- -**デヌタフロヌの远跡**倉数がノヌド間でどのように受け枡され、倉換されるか。これは[倉数むンスペクタヌ](/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx)でも調査できたす。 +- **実行時間の分析**各ノヌドにかかる時間は、パフォヌマンスのボトルネックを特定するのに圹立ちたす。 +- **リ゜ヌス䜿甚量**トヌクン消費量、API呌び出し、及びコスト関連デヌタ。 +- **゚ラヌ远跡**どのノヌドが倱敗し、その理由を正確に特定したす。 + +![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) + +远跡ビュヌは、耇雑なワヌクフロヌのデバッグずパフォヌマンスの最適化に特に圹立ちたす。ワヌクフロヌに分岐やルヌプが含たれおいる堎合、このビュヌは実行䞭に実際に通ったパスを明らかにするのに圹立ちたす。 + +## ノヌド実行ログ + +アプリケヌションレベルのログに加えお、ワヌクフロヌ゚ディタ内で各ノヌドの最終実行ログを盎接怜査するこずもできたす。ノヌドの蚭定パネルで最終実行をクリックするず、入力および出力デヌタを含む最新の実行詳现が衚瀺されたす。 + +![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) + diff --git a/ja-jp/guides/workflow/debug-and-preview/history.mdx b/ja-jp/guides/workflow/debug-and-preview/history.mdx deleted file mode 100644 index 3759aeb6..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/history.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 実行履歎 ---- - - -「実行履歎」では、珟圚のワヌクフロヌのデバッグ履歎の実行結果およびログ情報を確認できたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/5ff3e82563c43b41e359c83483fd0f9b.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/history.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fhistory.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - diff --git a/ja-jp/guides/workflow/debug-and-preview/log.mdx b/ja-jp/guides/workflow/debug-and-preview/log.mdx deleted file mode 100644 index 7c53e270..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/log.mdx +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 察話/実行ログ ---- - - -「ログを衚瀺—詳现」をクリックするず、詳现情報、入力/出力、メタデヌタ情報などの実行抂芁を芋るこずができたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/9b88af156ab35bb5b05b00ffc3e84dc7.png) - -「ログを衚瀺-远跡」をクリックするず、ワヌクフロヌの各ノヌドの入力/出力、トヌクン消費、実行時間などの完党な実行過皋を芋るこずができたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/b1e0a84aabbafd96897d277d787019de.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/log.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Flog.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - diff --git a/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx new file mode 100644 index 00000000..a6c3bb26 --- /dev/null +++ b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -0,0 +1,79 @@ +--- +title: 機胜玹介 +--- + +ワヌクフロヌを䜜成した埌、開発者はアプリケヌションを公開する前に、各ノヌドが正垞に動䜜しおいるかどうかを確認し、倉数内のデヌタが正しく流れおいるかを怜蚌するためにデバッグを行うこずができたす。 + +Difyは完党なデバッグツヌルを提䟛し、問題の迅速な特定、倉数の受け枡しの確認、詳现なログの衚瀺をサポヌトしたす。 + +本蚘事では、ワヌクフロヌアプリケヌションのデバッグの党プロセスを玹介したす。これには、単䞀ノヌドのデバッグ、倉数チェック、実行履歎の確認、および党䜓テスト方法が含たれたす。 + +![](https://assets-docs.dify.ai/2025/06/8e7933b45a69241a9861a09fa47d5c62.png) + +## ワヌクフロヌアプリケヌションのデバッグ + +### ノヌドデバッグ + +ワヌクフロヌ内の特定のノヌドに問題が発生し、ワヌクフロヌアプリケヌションが正垞に実行できない堎合、そのノヌドを単独でデバッグしお問題を迅速に特定したす。 + +ノヌドの右䞊にあるデバッグボタンをクリックし、テストデヌタを入力しお出力結果を確認したす。デバッグの過皋では、シンプルなテストデヌタから始めお、埐々にデヌタの耇雑さを増やし、さたざたな入力状況でノヌドが正垞に動䜜するこずを確認するこずをお勧めしたす。 + +単䞀ノヌドのデバッグ方法の詳现に぀いおは、[ノヌドのデバッグ](/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx)を参照しおください。 + +![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png) + +### ステップデバッグ + +ステップデバッグでは、䞊流ノヌドの倉数に基づいお、䞋流ノヌドが倉数内のデヌタを正しく凊理し、期埅される結果を出力しおいるかを確認したす。 + +詳しい䜿甚方法に぀いおは、倉数チェックを参照しおください。 + +![](https://assets-docs.dify.ai/2025/06/887630764b180a60becb6a4fcee2c622.png) + +### ノヌドの実行蚘録の確認 + +ノヌドを実行するず、詳现な実行蚘録が生成され、開発者の問題解決をサポヌトしたす。ノヌドの詳现ペヌゞの「前回の実行」をクリックするず、入力パラメヌタ、出力結果、実行時間、゚ラヌ情報などの実行ログを確認できたす。詳现に぀いおは[デバッグ履歎 - ノヌド実行蚘録](/ja-jp/guides/workflow/debug-and-preview/history-and-logs#アプリケヌション実行履歎)を参照しおください。 + +![](https://assets-docs.dify.ai/2025/06/a6011d5966c78a4d1705f2af44ed8af1.png) + +### 党䜓フロヌのデバッグ + +すべおのノヌドのデバッグが完了したら、次にワヌクフロヌ党䜓を実行しお゚ンドツヌ゚ンドの実行効果を怜蚌したす。 + +プレビュヌ機胜を䜿甚しおアプリケヌションの最終ナヌザヌむンタヌフェヌスを䜓隓できたす。このモヌドでは、入力フィヌルド、出力衚瀺、むンタラクションプロセスなどが完党に衚瀺され、䞻にナヌザヌ䜓隓が期埅通りかを怜蚌するために䜿甚されたす。システムはプレビュヌ時に自動チェックを行い、すべおのノヌドが正しく蚭定され、接続が完党であるこずを確認したす。 + +![](https://assets-docs.dify.ai/2025/06/de00849b363ec9356e5764b88b4331fb.png) + +#### チェックリスト + +システムはワヌクフロヌ蚭定を自動的にチェックし、ノヌド接続゚ラヌや必須パラメヌタの欠萜などの問題が芋぀かった堎合、画面右䞊に通知を衚瀺したす。すべおの問題を解決した埌にのみアプリケヌションを実行できたす。 + +![](https://assets-docs.dify.ai/2025/06/85bafda1f786549c22404cd5ec711d0f.png) + +ワヌクフロヌを実行する際には、右偎のパネルで各ノヌドの実行状態入力パラメヌタ、出力結果、実行ログを含むを確認できたす。ノヌド䞊のステヌタスむンゞケヌタヌ緑色は成功を瀺すを通じお、フロヌがどのノヌドで異垞が発生しお䞭断したかを玠早く識別できたす。 + +正匏リリヌス前に耇数回のテストを行い、異なる皮類や耇雑さのデヌタを䜿甚しおワヌクフロヌの安定性を怜蚌するこずをお勧めしたす。 + +![](https://assets-docs.dify.ai/2025/06/c09f788f77b5f8ebdd635ddba66a1b99.png) + +## アプリケヌションの実行ログの確認 + +アプリケヌションを公開した埌、開発者はログずモニタリング機胜を通じお、ナヌザヌがアプリケヌションを䜿甚した際の察話蚘録やパフォヌマンスデヌタを確認できたす。この履歎蚘録は、ナヌザヌの行動パスの確認、アプリケヌションのパフォヌマンス倉化の分析、問題の原因の振り返りに圹立ちたす。 + +![](https://assets-docs.dify.ai/2025/06/6dd8e8a7186089a390679b6de4bb97b9.png) + +詳现に぀いおは以䞋のドキュメントを参照しおください + +- [実行履歎ずログ](/ja-jp/guides/workflow/debug-and-preview/history-and-logs) +- [モニタリング](/ja-jp/guides/monitoring/README) + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fpreview-and-run.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) + diff --git a/ja-jp/guides/workflow/debug-and-preview/step-run.mdx b/ja-jp/guides/workflow/debug-and-preview/step-run.mdx index 3bbd47db..2a2d5af1 100644 --- a/ja-jp/guides/workflow/debug-and-preview/step-run.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/step-run.mdx @@ -2,14 +2,87 @@ title: ステップ実行 --- +ワヌクフロヌやチャットフロヌアプリケヌションは通垞、耇数のノヌドで構成され、それぞれのノヌドは盞互に関連しおいたす。アプリ党䜓が正垞に動䜜するためには、各ノヌドの入出力が期埅通りであるこずを確認する必芁がありたす。 -ワヌクフロヌはノヌドのステップの実行をサポヌトしおおり、ステップを実行䞭に珟圚のノヌドの実行が期埅通りかどうかを繰り返しテストするこずができたす。 +ノヌドデバッグ機胜は、開発者がアプリケヌションが蚭蚈通りに機胜しおいるかを怜蚌し、朜圚的な問題を早期に発芋しお解決し、本番環境での゚ラヌを防ぐのに圹立ちたす。 -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/36e547165a5088510c99baee4ce42bcd.png) +ノヌドのデバッグには、単䞀ステップデバッグず段階的実行の2぀の方法がありたす。 -ステップテスト実行埌、実行ステヌタス、入力/出力、メタデヌタ情報を確認するこずができたす。 +## 単䞀ステップデバッグ -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/040e1051d33b94d35e4683d3c89691a8.png) +### 方法の抂芁 + +単䞀ステップデバッグを䜿甚するず、ワヌクフロヌ内の特定のノヌドを独立しおテストするこずができたす。これにより、開発者はアプリケヌションに新しいノヌドを远加する際にその機胜を怜蚌したり、特定のノヌドの゚ラヌを蚺断したり、異なる入力に察するノヌドの応答をテストしたりするこずができたす。 + +### 操䜜手順 + +1. ワヌクフロヌの線集画面でデバッグしたいノヌドを遞択する +2. ノヌドの蚭定ペヌゞで入力倉数を入力する +3. 実行ボタンをクリックしおノヌドを実行する +4. ノヌドの出力結果ず実行状態を確認する + +### 䟋 + +ワヌクフロヌ内にHTTPノヌドを远加した堎合、そのノヌドがAPIレスポンスを正しく取埗しお凊理できるかを怜蚌するために、単䞀ステップデバッグ機胜を䜿甚しおノヌドの実際の動䜜状態をシミュレヌトし、䞋流ノヌドにデヌタが正しく枡されるこずを確認できたす。 + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +デバッグが完了したら、「最終実行」ペヌゞで珟圚のノヌドの実行状態、入出力、メタデヌタ情報を確認できたす。゚ラヌが発生した堎合は、゚ラヌメッセヌゞを通じお問題を迅速に蚺断し、単䞀ノヌドの異垞が党䜓の実行倱敗に぀ながるのを防ぐこずができたす。 + + + 応答ノヌドず終了ノヌドは単䞀ステップデバッグをサポヌトしおいたせん。 + + +## 段階的実行 + +### 方法の抂芁 + +ワヌクフロヌの運甚は、デヌタが䞀぀のノヌドから次のノヌドぞ正しく流れるこずに䟝存しおいたす。ワヌクフロヌが耇雑な堎合、このプロセスぱラヌが発生しやすく、よくある問題には以䞋のようなものがありたす + +- デヌタ圢匏の䞍䞀臎䟋テキストが数倀を必芁ずするノヌドに枡される +- 倉数の蚭定ミス +- JSONデヌタの解析倱敗 +- 倉数パスの参照゚ラヌ + +段階的実行によるノヌドデバッグ方法は、開発者が耇雑なワヌクフロヌアプリケヌション内で゚ラヌを玠早く特定するのに圹立ちたす。 + +ノヌドをデバッグしおいるずき、ノヌドの出力倉数は[倉数怜査](/ja/guides/workflow/debug-and-preview/variable-inspect)にキャッシュされたす。開発者は「倉数怜査」内で盎接倉数を修正し、䞊流倉数内のデヌタを迅速に倉曎しお、異なる倀が䞋流ノヌドに䞎える圱響を確認できたす。 + +この方法は、盞互に䟝存する耇数のノヌドをテストするのに適しおいたす。 + +![](https://assets-docs.dify.ai/2025/06/f8656d8deeeaefeab0a8d9169f0ed2d3.png) + +ノヌドを実行するず、システムは自動的に出力デヌタを「倉数怜査」ビュヌに保存したす。以䞋の方法で朜圚的な問題を排陀できたす + +1. **実際のデヌタを確認する**ノヌド出力のデヌタが期埅通りかを比范する +2. **テストデヌタを修正する**ビュヌ内で盎接倉数倀を修正し、埌続ノヌドぞの圱響をテストする +3. **デヌタフロヌを怜蚌する**デヌタが䞋流ノヌドに正しく䌝達されるこずを確認する + +### 操䜜手順 + +1. デバッグモヌドでアプリケヌションを実行する +2. アプリケヌション䞋郚の「倉数怜査」をクリックし、倉数キャッシュを確認する +3. デバッグが必芁なノヌドを特定し、どの倉数を参照しおいるかを確認する +4. 「倉数怜査」内でその倉数の倀を修正し、ノヌドを再実行する +5. 実行結果を比范する + +### 䟋 + +䟋えば、次のようなワヌクフロヌがあるずしたすデヌタ取埗(Aノヌド) → デヌタ凊理(Bノヌド) → 結果衚瀺(Cノヌド)。 + +Bノヌドの機胜はAノヌドの出力デヌタに完党に䟝存しおおり、異なるデヌタがBノヌドの実行状況に圱響を䞎えたす。 + +Aノヌドを実行した埌の出力倉数倀は「倉数怜査」に保存されたす。開発者は「倉数怜査」内のデヌタを修正し、Aノヌドを手動で再実行するこずなく、Bノヌドぞの圱響を怜蚌できたす。 + +段階的実行の過皋で、局所的なワヌクフロヌの実行状況を芳察し、結果に基づいおノヌドの蚭定、デヌタフロヌ、凊理ロゞックをタむムリヌに調敎し、ワヌクフロヌの効率性ず正確性を確保できたす。 + +## ノヌドの実行蚘録の確認 + +各ノヌドの実行完了埌に操䜜蚘録が生成され、ノヌド詳现ペヌゞの「最終実行」をクリックしお確認できたす。 + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) + +アプリケヌション党䜓の実行履歎を確認する堎合は、[実行履歎](/ja/guides/workflow/debug-and-preview/history-and-logs)を参照しおください。 {/* Contributing Section diff --git a/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx b/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx new file mode 100644 index 00000000..467f3ece --- /dev/null +++ b/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -0,0 +1,80 @@ +--- +title: 倉数むンスペクタヌ +--- + +**倉数むンスペクタヌ**は、ワヌクフロヌ゚ディタヌの䞋郚に配眮されおいるパネルです。このパネルは、実行埌の各ノヌドの入力デヌタず出力デヌタをキャッチし、開発者がワヌクフロヌ党䜓のデヌタフロヌにおける問題を玠早く特定し、怜蚌するのに圹立ちたす。 + +## なぜ重芁か + +[倉数](/ja-jp/guides/workflow/variables)はノヌド間の䞻芁な接続点ずしお機胜し、動的なフロヌ制埡を可胜にしたす。ワヌクフロヌアプリケヌションでは、倉数はナヌザヌからの入力だけでなく、各ノヌドからの出力LLMの応答、ツヌルの結果、䌚話のコンテキスト、環境パラメヌタなどを保存したす。 + +倉数むンスペクタヌは、実行埌に各ノヌドの入力パラメヌタず出力結果を自動的にキャッシュしたす。以䞋の䞻な機胜を提䟛しおいたす + +- **リアルタむムの倉数監芖**ノヌドが実行された盎埌にワヌクフロヌの入出力を含むすべおの倉数を捕捉しお衚瀺したす。 +- **キャッシュされた倉数の線集**䞊流のノヌドを再実行せずに、ほずんどのタむプの倉数を手動で倉曎するこずができたす — 異なるシナリオをテストするのに最適です。 +- **異垞デヌタの远跡**各倉数の実際の倀ずタむプを衚瀺し、フォヌマットの問題や欠萜フィヌルド、型の䞍䞀臎を特定しやすくしたす。 +- **グロヌバル状態管理**システム倉数、環境倉数、カスタム定矩されたノヌド倉数を含むすべおの倉数を1぀のパネルに衚瀺したす。 + +倉数むンスペクタヌを䜿甚するこずで、任意のノヌドから最新の出力倉数を簡単に確認・線集でき、倉曎が䞋流のノヌドにどのように圱響するかを確認できたす。 + +## 䜿甚方法 + +倉数むンスペクタヌはキャンバスの䞋郚に䜍眮し、ワヌクフロヌが実行されるずリアルタむムで曎新されたす。 + +ノヌドが実行されるず、その出力倉数がパネルに衚瀺され、迅速に怜査たたは線集が可胜です。 + +![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) + +以䞋は、"倖郚デヌタベヌスク゚リ"アプリケヌションにおける倉数むンスペクタヌの䜿甚䟋です。このワヌクフロヌでは、LLMノヌドが自然蚀語入力を受け取り、それをSQLに倉換し、リモヌトデヌタベヌスにク゚リを送信しおデヌタを取埗したす。 + +> [こちら](https://assets-docs.dify.ai/2025/06/ac4da5ed5506f8a34aae7f0b88323f37.yml)をクリックしおDSLワヌクフロヌファむルをダりンロヌドできたす。 + +### 衚瀺 + +ノヌドが実行されるず、その出力倉数は自動的に倉数むンスペクタヌに衚瀺されたす。倉数をクリックするず、詳现な内容を確認できたす。 + +![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png) + +### 線集 + +倉数の倀をクリックしお線集したす。曎新された倀は、次回の実行時に䞋流のノヌドで䜿甚されたす。 + + + ここで倉数の倀を線集しおも、ノヌドの「最終実行」蚘録内のキャッシュデヌタには圱響したせん。 + + +**䟋** + + + + ナヌザヌが「すべおのナヌザヌデヌタを衚瀺」ず入力するず、LLMノヌドが`SELECT * FROM users;`を生成したす。デヌタベヌスはすべおのデヌタを正しく返したす。 + + + + ナヌザヌが倉数むンスペクタヌでSQLを手動で`SELECT username FROM users;`に倉曎し、デヌタベヌスノヌドのみを再実行したす。システムはナヌザヌ名のリストを返したす。 + + これにより、ワヌクフロヌ党䜓を再起動するこずなく、䞋流のデヌタベヌスノヌドだけを再実行しお新しいデヌタをテストするこずができたす。 + + + + +### 元に戻す + +倉数線集フィヌルドの右䞊にある元に戻すアむコンをクリックするず、倉数を元の倀に埩元できたす。 + +![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png) + +### すべおの倉数をリセット + +巊䞊の**すべおリセット**をクリックするず、キャッシュされたすべおの倉数を䞀床にクリアできたす。 + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) + diff --git a/ja-jp/guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.mdx b/ja-jp/guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.mdx deleted file mode 100644 index f4ed5ec2..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: プレビュヌず実行 ---- - - -Difyワヌクフロヌでは、完党な実行ずデバッグ機胜を提䟛しおいたす。察話型アプリケヌションでは、クリック「プレビュヌ」でデバッグモヌドに入りたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/91379dc42d0d815e52ddad0cc5450a46.png) - -ワヌクフロヌアプリケヌションでは、クリック「実行」でデバッグモヌドに入りたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/b92d7536392b1e1f2423d0e3aa113915.png) - -デバッグモヌドに入るず、むンタヌフェヌスの右偎で蚭定枈みのワヌクフロヌをデバッグできたす。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/debug-and-preview/4c81791508592e0f8019b8ebf8f119ea.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/yu-lan-yu-yun-hang.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20n-yu-yun-h&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fyu-lan-yu-yun-hang.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - From 651ce2671463ad6c0d8ac0b96139396fe119a59d Mon Sep 17 00:00:00 2001 From: Hanqing Zhao Date: Tue, 24 Jun 2025 16:02:09 +0800 Subject: [PATCH 13/15] Erase useless files --- .../workflow/debug-and-preview/checklist.mdx | 19 ----- .../workflow/debug-and-preview/debug-node.mdx | 69 +++++++++++++++++++ .../workflow/debug-and-preview/history.mdx | 19 ----- .../debug-and-preview/preview-and-run.mdx | 2 +- .../workflow/debug-and-preview/step-run.mdx | 2 +- .../workflow/debug-and-preview/checklist.mdx | 22 ------ ...ug-node-block-point.mdx => debug-node.mdx} | 2 +- .../guides/workflow/debug-and-preview/log.mdx | 22 ------ .../debug-and-preview/preview-and-run.mdx | 2 +- .../debug-and-preview/step-by-step-run.mdx | 26 ------- .../workflow/debug-and-preview/step-run.mdx | 2 +- 11 files changed, 74 insertions(+), 113 deletions(-) delete mode 100644 en/guides/workflow/debug-and-preview/checklist.mdx create mode 100644 en/guides/workflow/debug-and-preview/debug-node.mdx delete mode 100644 en/guides/workflow/debug-and-preview/history.mdx delete mode 100644 zh-hans/guides/workflow/debug-and-preview/checklist.mdx rename zh-hans/guides/workflow/debug-and-preview/{debug-node-block-point.mdx => debug-node.mdx} (99%) delete mode 100644 zh-hans/guides/workflow/debug-and-preview/log.mdx delete mode 100644 zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx diff --git a/en/guides/workflow/debug-and-preview/checklist.mdx b/en/guides/workflow/debug-and-preview/checklist.mdx deleted file mode 100644 index 2070efbc..00000000 --- a/en/guides/workflow/debug-and-preview/checklist.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Checklist ---- - - -Before publishing the App, you can check the checklist to see if there are any nodes with incomplete configurations or that have not been connected. - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/be2b57394186c9b607a94614793dd5ca.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/checklist.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20l&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fchecklist.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) - diff --git a/en/guides/workflow/debug-and-preview/debug-node.mdx b/en/guides/workflow/debug-and-preview/debug-node.mdx new file mode 100644 index 00000000..24e2ae1c --- /dev/null +++ b/en/guides/workflow/debug-and-preview/debug-node.mdx @@ -0,0 +1,69 @@ +--- +title: Debug Nodes +--- + +Workflow and Chatflow applications typically consist of multiple interconnected nodes. To ensure your entire application runs smoothly, you need to verify each node's inputs and outputs meet expectations. The debugging feature helps developers confirm the application functions as designed, identify potential issues early, and prevent errors in production environments. + +You can debug nodes using two methods: + +## Step Debugging + +Step debugging lets you test specific nodes independently without executing the entire workflow. This is useful when adding new nodes, troubleshooting specific errors, or testing how nodes handle different inputs. + +### How to Step Debug + +1. Select the node you want to debug in the workflow editor +2. Click the **Run Step** button in the top right corner of the node +3. Enter the required input variables in the debug panel +4. Click Execute to run the node +5. Review the output results and execution status + +For example, if you've added an HTTP node and want to verify it correctly retrieves API responses, you can use step debugging to test the node's behavior without affecting downstream nodes. + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +After debugging, you'll see the node's execution status, input/output data, and metadata. If errors occur, you can quickly troubleshoot using the error messages, preventing individual node failures from causing application-wide issues. + + + Answer and End nodes don't support step debugging. + + +## Sequential Execution + +Sequential execution works best for testing interdependent nodes, especially when a node requires output from upstream nodes. Unlike step debugging, this method starts from the initial node and follows the workflow path sequentially until reaching your specified target node. + +### How to Run Sequentially + +1. Select your target endpoint node in the workflow editor +2. Click the **Run To** button in the top right corner of the node +3. The system will execute all nodes in sequence from the start until reaching your target node +4. After execution, you can examine each node's status and output results + +For example, if your workflow contains data retrieval (Node A) → data processing (Node B) → result display (Node C), and Node B depends on Node A's output, you can select Node B and click "Run To". The system will execute Node A first, then Node B, allowing you to verify data flows correctly between them. + +During sequential execution, you can observe the partial workflow in action and make adjustments to configurations, data flow, and processing logic based on the results. + +![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) + + + Sequential execution isn't supported for nodes with multiple branches, such as question classification nodes and condition nodes. + + +## View Node Execution Records + +Each node generates logs after execution. You can click **Last Run** in the node details page to view the execution history. + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) + +To view the overall execution history of your application, see [Execution History](/en/guides/workflow/debug-and-preview/history-and-logs) for more details. + +{/* +Contributing Section +DO NOT edit this section! +It will be automatically generated by the script. +*/} + +--- + +[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/debug-node.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20l&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) + diff --git a/en/guides/workflow/debug-and-preview/history.mdx b/en/guides/workflow/debug-and-preview/history.mdx deleted file mode 100644 index cedc7b55..00000000 --- a/en/guides/workflow/debug-and-preview/history.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Run History ---- - - -In the "Run History," you can view the run results and log information from the historical debugging of the current workflow. - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/debug-and-preview/e6b7b1b00b43109d42cc265ed77ab58f.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/history.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fhistory.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) - diff --git a/en/guides/workflow/debug-and-preview/preview-and-run.mdx b/en/guides/workflow/debug-and-preview/preview-and-run.mdx index 5d36e453..624a4e76 100644 --- a/en/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/en/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -66,7 +66,7 @@ After publishing your application, you can monitor how it’s performing and how For more information, see: -- [Run History](/en/guides/workflow/debug-and-preview/history) +- [History and Logs](/en/guides/workflow/debug-and-preview/history-and-logs) - [Monitoring](/en/guides/monitoring/README) {/* diff --git a/en/guides/workflow/debug-and-preview/step-run.mdx b/en/guides/workflow/debug-and-preview/step-run.mdx index 1ec73549..f6403295 100644 --- a/en/guides/workflow/debug-and-preview/step-run.mdx +++ b/en/guides/workflow/debug-and-preview/step-run.mdx @@ -82,7 +82,7 @@ Every time a node is executed, a record is generated. Click “Last run” on th ![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) -To view the full workflow’s execution history, see [Run History](/en/guides/workflow/debug-and-preview/history). +To view the full workflow’s execution history, see [Run History](/en/guides/workflow/debug-and-preview/history-and-logs). {/* Contributing Section diff --git a/zh-hans/guides/workflow/debug-and-preview/checklist.mdx b/zh-hans/guides/workflow/debug-and-preview/checklist.mdx deleted file mode 100644 index 237ab73e..00000000 --- a/zh-hans/guides/workflow/debug-and-preview/checklist.mdx +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 检查枅单埅園档 ---- - - - 本篇内容已園档至 [预览应甚](/zh-hans/guides/workflow/debug-and-preview/preview-and-run)。 - - -圚进入调试运行之前䜠可以圚检查枅单内检查是吊有未完成配眮或者未连线的节点。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/16201deaa47a518ff73c983a33ab4002.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/checklist.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20l&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fchecklist.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) - diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx similarity index 99% rename from zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx rename to zh-hans/guides/workflow/debug-and-preview/debug-node.mdx index 9c7ec305..e10b6a4a 100644 --- a/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx @@ -55,7 +55,7 @@ Workflow / Chatflow 类型应甚通垞包含倚䞪节点每䞪节点互有关 ![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) -劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 +劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history-and-logs)。 {/* Contributing Section diff --git a/zh-hans/guides/workflow/debug-and-preview/log.mdx b/zh-hans/guides/workflow/debug-and-preview/log.mdx deleted file mode 100644 index 0bc77cce..00000000 --- a/zh-hans/guides/workflow/debug-and-preview/log.mdx +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 对话/运行日志 ---- - -点击「查看日志—诊情」可以圚诊情䞭查看运行总览信息、蟓入/蟓出 、元数据信息等。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/9b88af156ab35bb5b05b00ffc3e84dc7.png) - -点击「查看日志-远螪」可以查看工䜜流完敎运行过皋各节点的蟓入/蟓出、Token 消耗、运行时长等。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/b1e0a84aabbafd96897d277d787019de.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/log.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Flog.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) - diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index d921044e..c4be655a 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -62,7 +62,7 @@ title: 功胜简介 诊细诎明请参考以䞋文档 -- [运行历史](/zh-hans/guides/workflow/debug-and-preview/history) +- [运行历史](/zh-hans/guides/workflow/debug-and-preview/history-and-logs) - [监测](/zh-hans/guides/monitoring/README) {/* diff --git a/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx deleted file mode 100644 index 8cb8aab5..00000000 --- a/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 单步调试 ---- - - - 本篇内容已園档至 [调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 - - -工䜜流支持节点的单步调试圚单步调试䞭䜠可以重倍测试圓前节点的执行是吊笊合预期。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/36e547165a5088510c99baee4ce42bcd.png) - -单步测试运行后可以查看运行状态、蟓入/蟓出、元数据信息。 - -![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/guides/workflow/debug-and-preview/040e1051d33b94d35e4683d3c89691a8.png) - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/step-by-step-run.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20by-step-&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fstep-by-step-run.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) - diff --git a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx index 5ef252be..f95195da 100644 --- a/zh-hans/guides/workflow/debug-and-preview/step-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/step-run.mdx @@ -82,7 +82,7 @@ B 节点的功胜完党䟝赖于 A 节点的蟓出数据并䞔䞍同的数据 ![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) -劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history)。 +劂需查看应甚敎䜓的运行历史诊细诎明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history-and-logs)。 {/* Contributing Section From 239d78383d65ce81db33738f5af21e20d81ccbaa Mon Sep 17 00:00:00 2001 From: alterxyz <88554920+alterxyz@users.noreply.github.com> Date: Tue, 24 Jun 2025 08:02:57 +0000 Subject: [PATCH 14/15] Docs tools: Successfully completed 3 operations --- en/guides/workflow/debug-and-preview/debug-node.mdx | 2 +- ja-jp/guides/workflow/debug-and-preview/debug-node.mdx | 2 +- ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx | 2 +- ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx | 2 +- ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx | 2 +- zh-hans/guides/workflow/debug-and-preview/debug-node.mdx | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/en/guides/workflow/debug-and-preview/debug-node.mdx b/en/guides/workflow/debug-and-preview/debug-node.mdx index 24e2ae1c..6d930679 100644 --- a/en/guides/workflow/debug-and-preview/debug-node.mdx +++ b/en/guides/workflow/debug-and-preview/debug-node.mdx @@ -65,5 +65,5 @@ It will be automatically generated by the script. --- -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/debug-node.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20l&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) +[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/debug-node.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20-n&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) diff --git a/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx b/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx index f08709f7..413ab098 100644 --- a/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx @@ -67,5 +67,5 @@ It will be automatically generated by the script. --- -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/debug-node-block-point.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fdebug-node-block-point.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20-n&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) diff --git a/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx b/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx index 6cd82385..2a844e83 100644 --- a/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx @@ -66,5 +66,5 @@ It will be automatically generated by the script. --- -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/history-and-logs.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20ry-and-l&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fhistory-and-logs.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) diff --git a/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx index a6c3bb26..35bd998d 100644 --- a/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -75,5 +75,5 @@ It will be automatically generated by the script. --- -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fpreview-and-run.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20ew-and-&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fpreview-and-run.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) diff --git a/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx b/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx index 467f3ece..b7cadaa8 100644 --- a/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx @@ -76,5 +76,5 @@ It will be automatically generated by the script. --- -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) +[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/variable-inspect.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20ble-insp&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) diff --git a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx index e10b6a4a..142a79df 100644 --- a/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx @@ -65,5 +65,5 @@ It will be automatically generated by the script. --- -[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/debug-node-block-point.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20-node-block-po&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fdebug-node-block-point.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) +[猖蟑歀页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/debug-node.mdx) | [提亀问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20-n&body=%23%23%20问题描述%0A%3C%21--%20请简芁描述悚发现的问题%20--%3E%0A%0A%23%23%20页面铟接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20劂果有具䜓的修改建议请圚歀诎明%20--%3E%0A%0A%3C%21--%20感谢悚对文档莚量的关泚%20--%3E) From b05bf8c32037e958564bdb6bd502c10dc87437e9 Mon Sep 17 00:00:00 2001 From: Hanqing Zhao Date: Tue, 24 Jun 2025 16:53:08 +0800 Subject: [PATCH 15/15] Docs: modify files --- docs.json | 3 - .../workflow/debug-and-preview/debug-node.mdx | 69 ------------------ .../debug-and-preview/preview-and-run.mdx | 2 +- .../workflow/debug-and-preview/debug-node.mdx | 71 ------------------- .../debug-and-preview/preview-and-run.mdx | 2 +- .../debug-and-preview/preview-and-run.mdx | 2 +- 6 files changed, 3 insertions(+), 146 deletions(-) delete mode 100644 en/guides/workflow/debug-and-preview/debug-node.mdx delete mode 100644 ja-jp/guides/workflow/debug-and-preview/debug-node.mdx diff --git a/docs.json b/docs.json index fdee8c6c..a7871801 100644 --- a/docs.json +++ b/docs.json @@ -127,7 +127,6 @@ { "group": "Debug and Preview", "pages": [ - "en/guides/workflow/debug-and-preview/debug-node", "en/guides/workflow/debug-and-preview/preview-and-run", "en/guides/workflow/debug-and-preview/step-run", "en/guides/workflow/debug-and-preview/history-and-logs", @@ -755,7 +754,6 @@ { "group": "预览䞎调试", "pages": [ - "zh-hans/guides/workflow/debug-and-preview/debug-node", "zh-hans/guides/workflow/debug-and-preview/preview-and-run", "zh-hans/guides/workflow/debug-and-preview/step-run", "zh-hans/guides/workflow/debug-and-preview/history-and-logs", @@ -1415,7 +1413,6 @@ { "group": "プレビュヌずデバッグ", "pages": [ - "ja-jp/guides/workflow/debug-and-preview/debug-node", "ja-jp/guides/workflow/debug-and-preview/preview-and-run", "ja-jp/guides/workflow/debug-and-preview/step-run", "ja-jp/guides/workflow/debug-and-preview/history-and-logs", diff --git a/en/guides/workflow/debug-and-preview/debug-node.mdx b/en/guides/workflow/debug-and-preview/debug-node.mdx deleted file mode 100644 index 6d930679..00000000 --- a/en/guides/workflow/debug-and-preview/debug-node.mdx +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Debug Nodes ---- - -Workflow and Chatflow applications typically consist of multiple interconnected nodes. To ensure your entire application runs smoothly, you need to verify each node's inputs and outputs meet expectations. The debugging feature helps developers confirm the application functions as designed, identify potential issues early, and prevent errors in production environments. - -You can debug nodes using two methods: - -## Step Debugging - -Step debugging lets you test specific nodes independently without executing the entire workflow. This is useful when adding new nodes, troubleshooting specific errors, or testing how nodes handle different inputs. - -### How to Step Debug - -1. Select the node you want to debug in the workflow editor -2. Click the **Run Step** button in the top right corner of the node -3. Enter the required input variables in the debug panel -4. Click Execute to run the node -5. Review the output results and execution status - -For example, if you've added an HTTP node and want to verify it correctly retrieves API responses, you can use step debugging to test the node's behavior without affecting downstream nodes. - -![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) - -After debugging, you'll see the node's execution status, input/output data, and metadata. If errors occur, you can quickly troubleshoot using the error messages, preventing individual node failures from causing application-wide issues. - - - Answer and End nodes don't support step debugging. - - -## Sequential Execution - -Sequential execution works best for testing interdependent nodes, especially when a node requires output from upstream nodes. Unlike step debugging, this method starts from the initial node and follows the workflow path sequentially until reaching your specified target node. - -### How to Run Sequentially - -1. Select your target endpoint node in the workflow editor -2. Click the **Run To** button in the top right corner of the node -3. The system will execute all nodes in sequence from the start until reaching your target node -4. After execution, you can examine each node's status and output results - -For example, if your workflow contains data retrieval (Node A) → data processing (Node B) → result display (Node C), and Node B depends on Node A's output, you can select Node B and click "Run To". The system will execute Node A first, then Node B, allowing you to verify data flows correctly between them. - -During sequential execution, you can observe the partial workflow in action and make adjustments to configurations, data flow, and processing logic based on the results. - -![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) - - - Sequential execution isn't supported for nodes with multiple branches, such as question classification nodes and condition nodes. - - -## View Node Execution Records - -Each node generates logs after execution. You can click **Last Run** in the node details page to view the execution history. - -![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) - -To view the overall execution history of your application, see [Execution History](/en/guides/workflow/debug-and-preview/history-and-logs) for more details. - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/guides/workflow/debug-and-preview/debug-node.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?title=Documentation%20Issue%3A%20-n&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fen/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E) - diff --git a/en/guides/workflow/debug-and-preview/preview-and-run.mdx b/en/guides/workflow/debug-and-preview/preview-and-run.mdx index 624a4e76..037c5c2a 100644 --- a/en/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/en/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -18,7 +18,7 @@ If a specific node causes the workflow to fail, you can debug that node individu To test a single node, click the debug icon in its top-right corner. Try entering some simple test data and observe the output. You can gradually introduce more complex input to see how the node responds. -For more details, see [Debug Node](/en/guides/workflow/debug-and-preview/debug-node). +For more details, see [Debug Node](/en/guides/workflow/debug-and-preview/step-run). ![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png) diff --git a/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx b/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx deleted file mode 100644 index 413ab098..00000000 --- a/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: ノヌドのデバッグ ---- - -ワヌクフロヌやチャットフロヌアプリケヌションは通垞、耇数のノヌドで構成されおおり、それぞれのノヌドは盞互に関連しおいたす。アプリケヌション党䜓が正垞に動䜜するこずを確認するためには、各ノヌドの入出力が期埅通りであるこずをチェックする必芁がありたす。ノヌドのデバッグ機胜は、開発者がアプリケヌションが蚭蚈通りにサヌビスを提䟛しおいるかを怜蚌し、朜圚的な問題を事前に発芋・解決する手助けを行い、運甚環境での゚ラヌを未然に防ぐのに圹立ちたす。 - -以䞋の二぀のモヌドでノヌドをデバッグするこずができたす。 - -## 単䞀ステップデバッグ - -単䞀ステップデバッグでは、ワヌクフロヌ内の特定のノヌドを、ワヌクフロヌ党䜓を実行するこずなく独立しおテストするこずが可胜です。これにより、開発者はアプリケヌションに新しいノヌドを远加する際にその機胜を怜蚌したり、特定のノヌドの゚ラヌをトラブルシュヌティングしたり、異なる入力に察するノヌドの応答を確認するこずができたす。 - -### 操䜜手順 - -1. ワヌクフロヌ線集画面でデバッグしたいノヌドを遞択したす。 -2. ノヌドの右䞊にある **ステップ実行run step** ボタンをクリックしたす。 -3. 衚瀺されるデバッグパネルでそのノヌドの入力倉数を入力したす。 -4. 実行ボタンをクリックしおノヌドの実行をトリガヌしたす。 -5. ノヌドの出力結果ず実行状態を確認したす。 - -䟋えば、ワヌクフロヌにHTTPノヌドを远加した堎合、そのノヌドがAPIレスポンスを正しく取埗し凊理できるかを確認するために、䞋流ノヌドに圱響を䞎えるこずなく、単䞀ステップデバッグ機胜を䜿っおノヌドの実際の動䜜をシミュレヌトするこずができたす。 - -![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) - -デバッグが完了するず、珟圚のノヌドの実行状態、入出力、メタデヌタ情報を確認できたす。゚ラヌが発生した堎合は、゚ラヌメッセヌゞを通じお迅速に問題を特定し、ノヌドの異垞によるアプリケヌション党䜓の実行倱敗を防ぐこずができたす。 - - - 回答ノヌドや終了ノヌドは単䞀ステップデバッグをサポヌトしおいたせん。 - - -## 段階的実行 - -段階的実行は、盞互に䟝存する耇数のノヌドの組み合わせをテストするのに適しおおり、特にノヌドの入力が䞊流ノヌドの出力に䟝存しおいる堎合に有効です。単䞀ステップデバッグずは異なり、段階的実行は開始ノヌドから始たり、ワヌクフロヌのパスに沿っお指定されたノヌドたで順番に実行したす。 - -### 操䜜手順 - -1. ワヌクフロヌ線集画面で終点ずしたい目暙ノヌドを遞択したす。 -2. そのノヌドの右䞊にある **run to** ボタンをクリックしお段階的実行機胜を有効にしたす。 -3. システムは開始ノヌドから始たり、ワヌクフロヌのパスに沿っお目暙ノヌドたで順番に実行したす。 -4. 実行完了埌、各ノヌドの実行状態ず出力結果を確認できたす。 - -䟋えば、デヌタ取埗Aノヌド→デヌタ凊理Bノヌド→結果衚瀺Cノヌドずいうワヌクフロヌがあり、Bノヌドの機胜はAノヌドの出力に完党に䟝存しおいるずしたす。段階的実行機胜を䜿甚するこずで、Bノヌドを遞択し「run to」をクリックするず、システムは最初にAノヌドを実行し、その埌Bノヌドを実行したす。このプロセスによっお、二぀のノヌド間のデヌタ受け枡しが正垞に行われおいるかを確認するこずができたす。 - -段階的実行の過皋で、郚分的なワヌクフロヌの動䜜を芳察し、結果に基づいおノヌドの蚭定、デヌタの流れ、凊理ロゞックをタむムリヌに調敎するこずで、ワヌクフロヌの効率性ず正確性を確保するこずができたす。 - -![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png) - - - 質問分類ノヌドや条件ノヌドなど、耇数の分岐凊理がある堎合は、段階的実行機胜をサポヌトしおいたせん。 - - -## ノヌドの実行蚘録の確認 - -各ノヌドの実行が完了するず操䜜ログが生成されたす。ノヌド詳现ペヌゞの「Last run」をクリックするこずで、実行履歎を確認できたす。 - -![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) - -アプリケヌション党䜓の実行履歎を確認する堎合は、[実行履歎](/ja-jp/guides/workflow/debug-and-preview/history-and-logs)を参照しおください。 - ---- - -{/* -Contributing Section -DO NOT edit this section! -It will be automatically generated by the script. -*/} - ---- - -[このペヌゞを線集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20-n&body=%23%23%20問題の説明%0A%3C%21--%20発芋した問題に぀いお簡単に説明しおください%20--%3E%0A%0A%23%23%20ペヌゞリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/workflow/debug-and-preview%2Fdebug-node.mdx%0A%0A%23%23%20提案される倉曎%0A%3C%21--%20特定の倉曎案がある堎合は、ここで説明しおください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向䞊にご協力いただきありがずうございたす%20--%3E) - diff --git a/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx index 35bd998d..d96911a3 100644 --- a/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/ja-jp/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -18,7 +18,7 @@ Difyは完党なデバッグツヌルを提䟛し、問題の迅速な特定、 ノヌドの右䞊にあるデバッグボタンをクリックし、テストデヌタを入力しお出力結果を確認したす。デバッグの過皋では、シンプルなテストデヌタから始めお、埐々にデヌタの耇雑さを増やし、さたざたな入力状況でノヌドが正垞に動䜜するこずを確認するこずをお勧めしたす。 -単䞀ノヌドのデバッグ方法の詳现に぀いおは、[ノヌドのデバッグ](/ja-jp/guides/workflow/debug-and-preview/debug-node.mdx)を参照しおください。 +単䞀ノヌドのデバッグ方法の詳现に぀いおは、[ノヌドのデバッグ](/ja-jp/guides/workflow/debug-and-preview/step-run.mdx)を参照しおください。 ![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png) diff --git a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx index c4be655a..b5b09648 100644 --- a/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx +++ b/zh-hans/guides/workflow/debug-and-preview/preview-and-run.mdx @@ -16,7 +16,7 @@ title: 功胜简介 点击节点右䞊角的调试按钮蟓入测试数据并查看蟓出结果。圚调试过皋䞭建议从简单的测试数据匀始逐步增加数据倍杂床确保节点圚各种蟓入情况䞋郜胜正垞工䜜。 -关于诊细的单节点调试方法请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/debug-node)。 +关于诊细的单节点调试方法请参考[调试节点](/zh-hans/guides/workflow/debug-and-preview/step-run)。 ![](https://assets-docs.dify.ai/2025/06/44decb6644b140e46ed2e1e9246f48f7.png)