コンテンツにスキップ

辞書 (Dictionary)

概要 (What is it?)

Dictionary(辞書)ノードを使用すると、キーと値のリストをそれぞれ指定して辞書(Key-Value ペアのコレクション)を作成できます。ワークフロー全体で利用可能な、名前付きの値を持つ関連データを手軽に整理できます。

使用する場面 (When would I use it?)

以下のような場面でこのノードを使用します:

  • 名前付きの値を使って関連データを整理したい場合
  • 他のノードに渡す構造化データを作成したい場合
  • 他のコンポーネント用の設定データ(コンフィグ)を構築したい場合
  • キーでアクセスしやすい形式でデータを準備したい場合
  • 複数の値を単一の構造体にまとめたい場合

使い方 (How to use it)

基本セットアップ

  1. ワークフローに Dictionary ノードを追加します
  2. キーと値のリストを設定します
  3. 構造化データを必要とする他のノードに辞書出力を接続します

パラメータ一覧 (Parameters)

  • keys: 辞書のキーとして使用する文字列のリスト
  • values: 各キーに対応する値のリスト(文字列、数値、真偽値など)

出力 (Outputs)

  • dict: すべての Key-Value ペアを含む構築された辞書

使用例 (Example)

ユーザープロファイル用の設定辞書を作成したい場合の例:

  1. ワークフローに Dictionary ノードを追加します
  2. "keys" パラメータを次のように設定します:
    ["name", "age", "premium_member", "interests"]
    
  3. "values" パラメータを次のように設定します:
    ["Jane Smith", 32, true, ["hiking", "photography", "coding"]]
    
  4. 出力される辞書は次のようになります:
    {"name": "Jane Smith", "age": 32, "premium_member": true, "interests": ["hiking", "photography", "coding"]}
    
  5. この辞書を、ユーザープロファイル情報を必要とする他のノードに接続します

重要な注意点 (Important Notes)

  • キーは自動的に文字列型に変換されます
  • 値の数よりもキーの数が多い場合、余剰のキーには None が割り当てられます
  • 空または None のキーはスキップされます(それが唯一のキーであり値が存在する場合を除く)
  • リストの代わりに単一の値を渡した場合、自動的に要素数1のリストとして変換されます
  • 文字列、数値、真偽値、ネストされたリストなど、多様な値の型に対応しています
  • 出力される辞書フォーマットは、辞書入力を受け付けるすべてのノードと互換性があります

よくある問題 (Common Issues)

  • リストの長さの不一致: キーのリストと値のリストの要素数が異なる場合、一部のキーの値が None になるか、一部の値が無視される可能性があります
  • キーの文字列変換: すべてのキーは強制的に文字列型に変換されるため、複雑なオブジェクトをキーとして渡すと意図しない挙動になる場合があります
  • 空のキー: 空文字列や None をキーとして渡した場合、値の有無によってスキップされることがあります