mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-03-26 13:18:34 +07:00
70 lines
4.8 KiB
Plaintext
70 lines
4.8 KiB
Plaintext
---
|
||
title: 変数インスペクター
|
||
---
|
||
|
||
**変数インスペクター**は、ワークフローエディターの下部に配置されているパネルです。このパネルは、実行後の各ノードの入力データと出力データをキャッチし、開発者がワークフロー全体のデータフローにおける問題を素早く特定し、検証するのに役立ちます。
|
||
|
||
## なぜ重要か
|
||
|
||
[変数](/versions/3-0-x/ja-jp/user-guide/workflow/variables)はノード間の主要な接続点として機能し、動的なフロー制御を可能にします。ワークフローアプリケーションでは、変数はユーザーからの入力だけでなく、各ノードからの出力（LLMの応答、ツールの結果、会話のコンテキスト、環境パラメータなど）を保存します。
|
||
|
||
変数インスペクターは、実行後に各ノードの入力パラメータと出力結果を自動的にキャッシュします。以下の主な機能を提供しています：
|
||
|
||
- **リアルタイムの変数監視**：ノードが実行された直後にワークフローの入出力を含むすべての変数を捕捉して表示します。
|
||
- **キャッシュされた変数の編集**：上流のノードを再実行せずに、ほとんどのタイプの変数を手動で変更することができます — 異なるシナリオをテストするのに最適です。
|
||
- **異常データの追跡**：各変数の実際の値とタイプを表示し、フォーマットの問題や欠落フィールド、型の不一致を特定しやすくします。
|
||
- **グローバル状態管理**：システム変数、環境変数、カスタム定義されたノード変数を含むすべての変数を1つのパネルに表示します。
|
||
|
||
変数インスペクターを使用することで、任意のノードから最新の出力変数を簡単に確認・編集でき、変更が下流のノードにどのように影響するかを確認できます。
|
||
|
||
## 使用方法
|
||
|
||
変数インスペクターはキャンバスの下部に位置し、ワークフローが実行されるとリアルタイムで更新されます。
|
||
|
||
ノードが実行されると、その出力変数がパネルに表示され、迅速に検査または編集が可能です。
|
||
|
||
|
||
|
||
以下は、"外部データベースクエリ"アプリケーションにおける変数インスペクターの使用例です。このワークフローでは、LLMノードが自然言語入力を受け取り、それをSQLに変換し、リモートデータベースにクエリを送信してデータを取得します。
|
||
|
||
> [こちら](https://assets-docs.dify.ai/2025/06/ac4da5ed5506f8a34aae7f0b88323f37.yml)をクリックしてDSLワークフローファイルをダウンロードできます。
|
||
|
||
### 表示
|
||
|
||
ノードが実行されると、その出力変数は自動的に変数インスペクターに表示されます。変数をクリックすると、詳細な内容を確認できます。
|
||
|
||
|
||
|
||
### 編集
|
||
|
||
変数の値をクリックして編集します。更新された値は、次回の実行時に下流のノードで使用されます。
|
||
|
||
<Info>
|
||
ここで変数の値を編集しても、ノードの「最終実行」記録内のキャッシュデータには影響しません。
|
||
</Info>
|
||
|
||
**例：**
|
||
|
||
<Steps>
|
||
<Step title="デフォルト結果">
|
||
ユーザーが「すべてのユーザーデータを表示」と入力すると、LLMノードが`SELECT * FROM users;`を生成します。データベースはすべてのデータを正しく返します。
|
||
<img src="https://assets-docs.dify.ai/2025/06/dcf4b0048bf1ed802369ab10731a4848.png" />
|
||
</Step>
|
||
<Step title="変数編集後">
|
||
ユーザーが変数インスペクターでSQLを手動で`SELECT username FROM users;`に変更し、データベースノードのみを再実行します。システムはユーザー名のリストを返します。
|
||
|
||
これにより、ワークフロー全体を再起動することなく、下流のデータベースノードだけを再実行して新しいデータをテストすることができます。
|
||
<img src="https://assets-docs.dify.ai/2025/06/fb8c49fc0c8c63866f1a9379e8752d9e.png" />
|
||
</Step>
|
||
</Steps>
|
||
|
||
### 元に戻す
|
||
|
||
変数編集フィールドの右上にある元に戻すアイコンをクリックすると、変数を元の値に復元できます。
|
||
|
||
|
||
|
||
### すべての変数をリセット
|
||
|
||
左上の**すべてリセット**をクリックすると、キャッシュされたすべての変数を一度にクリアできます。
|