---
title: ステップ実行
---

ワークフローやチャットフローアプリケーションは通常、複数のノードで構成され、それぞれのノードは相互に関連しています。アプリ全体が正常に動作するためには、各ノードの入出力が期待通りであることを確認する必要があります。

ノードデバッグ機能は、開発者がアプリケーションが設計通りに機能しているかを検証し、潜在的な問題を早期に発見して解決し、本番環境でのエラーを防ぐのに役立ちます。

ノードのデバッグには、単一ステップデバッグと段階的実行の2つの方法があります。

## 単一ステップデバッグ

### 方法の概要

単一ステップデバッグを使用すると、ワークフロー内の特定のノードを独立してテストすることができます。これにより、開発者はアプリケーションに新しいノードを追加する際にその機能を検証したり、特定のノードのエラーを診断したり、異なる入力に対するノードの応答をテストしたりすることができます。

### 操作手順

1. ワークフローの編集画面でデバッグしたいノードを選択する
2. ノードの設定ページで入力変数を入力する
3. 実行ボタンをクリックしてノードを実行する
4. ノードの出力結果と実行状態を確認する

### 例

ワークフロー内にHTTPノードを追加した場合、そのノードがAPIレスポンスを正しく取得して処理できるかを検証するために、単一ステップデバッグ機能を使用してノードの実際の動作状態をシミュレートし、下流ノードにデータが正しく渡されることを確認できます。

![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png)

デバッグが完了したら、「最終実行」ページで現在のノードの実行状態、入出力、メタデータ情報を確認できます。エラーが発生した場合は、エラーメッセージを通じて問題を迅速に診断し、単一ノードの異常が全体の実行失敗につながるのを防ぐことができます。

<Warning>
    応答ノードと終了ノードは単一ステップデバッグをサポートしていません。
</Warning>

## 段階的実行

### 方法の概要

ワークフローの運用は、データが一つのノードから次のノードへ正しく流れることに依存しています。ワークフローが複雑な場合、このプロセスはエラーが発生しやすく、よくある問題には以下のようなものがあります：

- データ形式の不一致（例：テキストが数値を必要とするノードに渡される）
- 変数の設定ミス
- 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
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/step-run.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)

