KeyValuePair 单键值对字典封装节点
节点核心功能 (What is it?)
KeyValuePair 节点用于快速创建仅包含单一键值映射的简易字典对象。它接收一个独立的键名（Key）与一个关联数值（Value），并将它们自动组装为形如 {"key": "value"} 的紧凑单键字典向外输出。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 快速构建由单个键值对构成的轻量级字典对象；
- 动态生成单一的特定运行时配置参数；
- 采用模块化、积木式的方式逐块拼装复杂的大型数据结构；
- 将上游两个分立的文本或变量合成为下游节点所要求的字典入参；
- 为后续的字典合并节点（如
MergeKeyValuePair）准备标准化输入源。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 KeyValuePair 节点。
- 在
key输入框中填入或接入目标键名字符串。 - 在
value输入框中填入或接入与该键名绑定的取值。 - 在
dictionary输出引脚处引出构建好的单键字典。
参数输入插槽 (Parameters)
- key：用作字典键名的标识字符串（
string）。 - value：与该键名相关联的取值（
string，支持录入多行长文本或由上游动态注入）。
输出引脚 (Outputs)
- dictionary：仅包含该组独立映射关系的单键字典工件（例如
{"key": "value"}）。
典型工作流示例 (Example)
假设您正在为一个大模型推理请求组装一个配置选项：
- 添加一个 KeyValuePair 节点至画布。
- 将
key参数设为"max_tokens"。 - 将
value参数填为"1024"。 - 节点即时输出字典工件：
{"max_tokens": "1024"}。 - 将
dictionary输出端直接连入需要此项配置参数的模型推理节点。
关键技术特性 (Important Notes)
- 文本类型统一 (String Preservation)：该节点默认将键名与对应值均以标准字符串（String）格式进行规范化打包。
- 支持多行富文本 (Multiline Text)：
value输入插槽提供对长段落、提示词模板及多行代码段的完整录入支持。 - 模块化组装能力：支持同时摆放多个
KeyValuePair节点，并通过下游的MergeKeyValuePair算子一次性聚合为大型多字段字典。