辞書 (Dictionary)
概要 (What is it?)
Dictionary(辞書)ノードを使用すると、キーと値のリストをそれぞれ指定して辞書(Key-Value ペアのコレクション)を作成できます。ワークフロー全体で利用可能な、名前付きの値を持つ関連データを手軽に整理できます。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します:
- 名前付きの値を使って関連データを整理したい場合
- 他のノードに渡す構造化データを作成したい場合
- 他のコンポーネント用の設定データ(コンフィグ)を構築したい場合
- キーでアクセスしやすい形式でデータを準備したい場合
- 複数の値を単一の構造体にまとめたい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに Dictionary ノードを追加します
- キーと値のリストを設定します
- 構造化データを必要とする他のノードに辞書出力を接続します
パラメータ一覧 (Parameters)
- keys: 辞書のキーとして使用する文字列のリスト
- values: 各キーに対応する値のリスト(文字列、数値、真偽値など)
出力 (Outputs)
- dict: すべての Key-Value ペアを含む構築された辞書
使用例 (Example)
ユーザープロファイル用の設定辞書を作成したい場合の例:
- ワークフローに Dictionary ノードを追加します
- "keys" パラメータを次のように設定します:
["name", "age", "premium_member", "interests"] - "values" パラメータを次のように設定します:
["Jane Smith", 32, true, ["hiking", "photography", "coding"]] - 出力される辞書は次のようになります:
{"name": "Jane Smith", "age": 32, "premium_member": true, "interests": ["hiking", "photography", "coding"]} - この辞書を、ユーザープロファイル情報を必要とする他のノードに接続します
重要な注意点 (Important Notes)
- キーは自動的に文字列型に変換されます
- 値の数よりもキーの数が多い場合、余剰のキーには
Noneが割り当てられます - 空または
Noneのキーはスキップされます(それが唯一のキーであり値が存在する場合を除く) - リストの代わりに単一の値を渡した場合、自動的に要素数1のリストとして変換されます
- 文字列、数値、真偽値、ネストされたリストなど、多様な値の型に対応しています
- 出力される辞書フォーマットは、辞書入力を受け付けるすべてのノードと互換性があります
よくある問題 (Common Issues)
- リストの長さの不一致: キーのリストと値のリストの要素数が異なる場合、一部のキーの値が
Noneになるか、一部の値が無視される可能性があります - キーの文字列変換: すべてのキーは強制的に文字列型に変換されるため、複雑なオブジェクトをキーとして渡すと意図しない挙動になる場合があります
- 空のキー: 空文字列や
Noneをキーとして渡した場合、値の有無によってスキップされることがあります