JSON 数据处理：JSON Operations 组件（AI Flowi Workflow）
JSON 数据处理组件 JSON Operations 可修改或选取 JSON 对象中的数据。将它放在 Data 或 JSON 数据源之后，以及需要重构、过滤或检查对象的步骤之前。
以下输入参考来自 AI Flowi Workflow 1.9.2 组件目录。一个在线验证模板记录了其 JQ 配置的生产环境测试；这些证据并不涵盖所有操作。
作者：Ai Flowi · 发布于
输入
| 名称 | 类型 | 必填 | 接受的输入类型 | 通俗说明 |
|---|---|---|---|---|
append_update_data | dict | 否 | 未列出 | 用于 Append or Update 操作的字典。 |
data | other | 是 | Data, JSON | 待处理的对象。此必填输入接受 Data 或 JSON 连接。 |
filter_key | str | 否 | Message | 用于过滤的键。导出内容未定义键路径的语法。 |
filter_values | dict | 否 | 未列出 | 用于 Filter Values 操作的值字典。 |
mapped_json_display | str | 否 | Message | 以映射后的 JSON 显示命名的文本字段；目录未说明其可写入的格式及运行时作用。 |
operations | sortableList | 否 | 未列出 | 从下列 JSON 操作中选择，并可调整顺序。 |
operator | str | 否 | 未列出 | 比较选项：等于、不等于、包含、以指定内容开头或以指定内容结尾。 |
query | str | 否 | Message | 已测试模板中的 JQ 表达式。使用 JQ Expression 时，应保持此字段可见。 |
remove_keys_input | str | 否 | Message | 指定 Remove Keys 所用键的文本；此次导出未提供分隔符格式。 |
rename_keys_input | dict | 否 | 未列出 | 用于 Rename Keys 的字典。目录未定义映射方向。 |
select_keys_input | str | 否 | Message | 指定 Select Keys 所用键的文本；此处未记录具体的列表语法。 |
selected_key | str | 否 | 未列出 | 键选择字段。导出的选项列表为空。 |
operations 的选项包括 Select Keys、Literal Eval、Combine、Filter Values、Append or Update、Remove Keys、Rename Keys、Path Selection 和 JQ Expression。“非必填”标记只是目录元数据，并不保证某项操作无需自身设置即可运行：已记录的 JQ 失败表明，query 不能为空。
输出
| 名称 | 显示名称 | 类型 | 用途 |
|---|---|---|---|
data_output | JSON | JSON | 处理后的对象，通过 JSON 输出提供。连接下游操作前，应检查对象结构。 |
何时使用 JSON Operations
现有对象的键或值需要处理时，可使用此组件。所链接的模板使用 JQ 进行验证。如果输入是编码为文本的 JSON， JSON String Parser 的文档说明了如何将包含对象的字符串转换为 JSON。
何时选择其他组件
若要将分别连接的值组装到可配置的键下，请参阅 JSON Object Builder。若要通过模板提取文本，请选择 Parser。若要在验证后选择 Verified 或 Rejected 分支，请使用 Verification Router；其目录说明指出，它会将完整的验证结果路由到相应分支，而不更改字段。
已测试的模板及记录结果
已测试模板：验证 webhook 输入并返回 200 或 422。其状态记录显示，在 2026年10月9日 的生产环境中，使用 AI Flowi Workflow 1.9.2， 28 个用例全部通过
。
生产环境运行返回了 200 响应并回显规范化后的数据，或返回附带原因的 422 响应。
该模板将 Universal Webhook 的请求数据连接到 data，通过 operations 选择 JQ Expression，并在 query中填入已发布的验证表达式。其 JSON 输出连接到 Verification Router。完整查询和响应分支请参阅所链接的模板；此处未将任何新配置作为测试结果展示。
该模板验证四个必填文本字段，去除首尾空白，并将电子邮件地址中的 ASCII 字母转换为小写。其证据未记录对导入副本的验证，也未实测节点计费；200 响应仅确认验证通过。
限制
- 应保持 JQ 字段可见。所提供的 webhook 到 Google Sheets 教程记录了隐藏 query 时出现 HTTP 500，并提示“JSON Query is required and cannot be blank”（JSON 查询为必填项，不能为空）。
- 在该教程的 Sheets 映射中，裸列表结果被包装为 {"result": …}，并在较早的编辑器测试中于 Append Rows 步骤失败。带有 values 字段的对象则未经包装直接传递；应匹配下游接口约定，不要假定列表会保持原样。
- 目录列出了操作名称，但未提供每项操作的详细参数格式。不要根据字段名猜测键列表的分隔符或重命名映射的方向。
- 这 28 个用例的结果涵盖了验证模板的 JQ 表达式及已配置路径，并不能证明 Literal Eval、Combine 或其他操作经过生产环境测试。
- Verification Router 负责路由验证结果；在已测试的验证流程中，它不捕获运行时异常。账户故障和超时仍可能返回平台错误。
已记录的 JQ 字段可见性问题及列表包装行为的来源： Sheets 教程的限制说明 及 较早的编辑器测试.
相关组件
JSON String Parser · JSON Object Builder · Verification Router · Parser
节点用量
套餐：Go 年付方案每月 USD8 起（月付 USD10），Plus 年付方案每月 USD16 起（月付 USD20），Pro 100 年付方案每月 USD80 起（月付 USD100），Pro 200 年付方案每月 USD160 起（月付 USD200），Pro 500 年付方案每月 USD400 起（月付 USD500），每月包含 5,000 至 250,000 个 Flowi Tokens，并支持充值；每次节点运行消耗 1 个 token；不包含第三方 API 和模型使用费用。
参考来源
组件目录: processing.DataOperations，AI Flowi Workflow 1.9.2，导出日期为 2026年10月9日。