Skip to main content

​
Data Transform

当你需要在另一个步骤读取之前重塑现有工作流输出时，请使用 Data Transform。 Data Transform 不调用外部服务。它在 Google Sheets、Airtable、Custom API 以及后续 Iteration 步骤之前很有用。

​
配置

从 Search steps… 的 Utilities 分组添加此步骤。

​
模式

​
Build Rows

使用 Build Rows 按索引将数组打包成一组对象。 每个字段都有 Key 和 Source Value。键变为对象属性。源可以是完整的变量引用，例如 {{tool_names}} 或 {{step_3.output}}，或者静态值。 数组源值按索引读取。静态标量值会为每一行重复。 示例:
Build Rows 字段:
输出:
当数组长度不同时，使用 Mismatch Policy:

​
Concat Arrays

使用 Concat Arrays 将多个数组追加为一个更长的数组。 每个源必须解析为数组。如果源解析为字符串、对象、数字或布尔值，步骤将失败。 示例 sources:
如果这些值为 ["a", "b"] 和 ["c"]，则输出为:

​
Flatten Array

使用 Flatten Array 将一个数组扁平化一层。 嵌套数组元素会展开。非数组元素保持原位。 示例 source:
输出:

​
Objects to Grid

当上一步返回对象数组，并且你想把该数据集写入 Google Sheets 时，使用 Objects to Grid。 将 Source Value 设为记录数组，例如 {{step_2.output}}。如果上一步把行包在某个字段中（例如 AI Keyword Data Search），请改用该字段，例如 {{step_2.output.items}}。将 Headers 留空即可按首次出现的顺序使用每个对象键。也可以传入解析为列名数组的占位符，或逗号分隔列表，例如 keyword, volume, difficulty。 示例 source:
输出:
将这些值传入 Google Sheets Upsert Rows 步骤:
缺失的键会变成空单元格。记录中的嵌套对象或数组会原样传递；Google Sheets 单元格最适合文本和数字这类简单值。

​
输出

Data Transform 将其结果存储在:
对于 Build Rows，输出是一个对象数组。这种形状非常适合期望记录或行的集成步骤。 对于 Concat Arrays 和 Flatten Array，输出是后续步骤可以遍历的数组。 对于 Objects to Grid，输出是包含 headers 和 rows 的对象。将其用于 Google Sheets Upsert Rows。

​
备注

  • 源值应该是完整的占位符，例如 {{step_2.output}}，或者静态标量值。
  • Data Transform V1 不支持混合模板字符串，例如 Research for {{tool_names}}。
  • Data Transform 将数组和对象保留为结构化 JSON，供下游步骤使用。
  • Data Transform 是免费的实用步骤。
另见:Google Sheets、Airtable、Custom API 和 测试与迭代