From 68754a55e720d29868f7fb545a1fecdbe52d3d1c Mon Sep 17 00:00:00 2001 From: Hanqing Zhao Date: Tue, 24 Jun 2025 16:01:50 +0800 Subject: [PATCH] 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) -