キー・値ペア (KeyValuePair)
概要 (What is it?)
KeyValuePair ノードは、単一の Key-Value ペアを含むシンプルな辞書を作成します。キーと値を入力として受け取り、そのマッピングを含む1要素の辞書を出力します。
使用する場面 (When would I use it?)
以下のような場面で KeyValuePair ノードを使用します:
- 単一のキーと値の対応関係を持つシンプルな辞書を作成したい場合
- 設定パラメータを動的に生成したい場合
- データ構造をパーツごとに段階的に構築したい場合
- 2つの独立した値を辞書形式に変換したい場合
- 辞書入力を要求するノードに渡すデータを準備したい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに KeyValuePair ノードを追加します
- "key" パラメータに任意の辞書キーを設定します
- "value" パラメータにそのキーに関連付ける値を設定します
- "dictionary" 出力を辞書入力を必要とする他のノードに接続します
パラメータ一覧 (Parameters)
- key: 辞書のキーとして使用される文字列 (string)
- value: キーに関連付けられる文字列(string、複数行テキストをサポート)
出力 (Outputs)
- dictionary: 単一の Key-Value ペアを含む辞書
使用例 (Example)
設定オプションを指定する必要があるワークフローを作成する場合の例:
- ワークフローに KeyValuePair ノードを追加します
- "key" パラメータを "max_tokens" に設定します
- "value" パラメータを "1024" に設定します
- "dictionary" 出力を設定パラメータを要求するノードに接続します
出力される辞書は次のようになります:{"max_tokens": "1024"}
この辞書は、ワークフロー内の設定パラメータを必要とする後続ノードで利用できます。
重要な注意点 (Important Notes)
- このノードでは、キーと値の両方が文字列 (string) として扱われます
- value パラメータは複数行テキスト入力をサポートしており、長いテキストも保持できます
- 複数の Key-Value ペアを持つ辞書を作成したい場合は、複数の KeyValuePair ノードを使用して、その出力をマージノードで結合できます