变量选择器

概述

变量选择器是自动化工作流（Automation）中用于引用上游触发器或执行器输出数据的可视化工具。通过变量选择器，您可以在配置动作（Action）时，将前一步的数据传递给后续步骤，以满足复杂的业务场景需求。

例如，在群发邮件的场景中，可按以下流程配置自动化：

使用“获取记录”执行器筛选目标客户名单；
在“循环”执行器中逐条处理名单；
针对每位客户，调用“DeepSeek – 文本生成”执行器生成定制化邮件正文；
最后，将客户邮箱地址作为变量，传递给“发送邮件”执行器完成群发。

如何使用

在配置自动化工作流执行器的时候，将光标放在输入框中
按下键盘上的 / 键，即可唤起变量选择器
在弹出的选择器中浏览可用变量
点击所需变量将其插入到当前配置项中

注意，仅部分执行器配置项支持变量的插入使用，请根据界面上的提示进行操作。

工作原理

变量选择器会列出当前步骤之前所有触发器与执行器的输出结果。每个触发器或执行器在运行后均会产生 JSON 结构化输出，变量选择器将其可视化为可点击列表，方便引用。

要正确加载变量列表，请先在触发器或执行器面板点击「运行测试」，以确保已有输出结果可供选择。

变量的数据类型

变量基于 JavaScript 数据结构，常见类型包括对象（Object）、数组（Array）、文本（String）和数字（Number）。在列表中，每个变量名前方均有图标标识其类型。

对象

右侧显示 “>” 图标，表示可展开查看子字段；
若出现「选择」按钮，表示可将整个对象插入配置。

数组

与对象类型类似，可展开查看元素。常与“循环”执行器配合，用于批量处理。

示例：

“获取记录”执行器输出一个客户记录数组；
“循环”执行器遍历该数组，为每位客户调用 AI 生成正文；
再将生成的正文和邮箱地址，分别传递给“发送邮件”执行器。

下方动图展示了如何在“循环”执行器中选择"获取记录"执行器的输出结果作为输入变量：

文本与数字

无子字段，右侧无展开图标；
可直接点击插入。

特殊变量

某些触发器或执行器会输出格式化文本变量，常见于与数据表记录相关的组件，包括：

“有记录满足条件时”触发器
“有新记录创建”触发器
“获取记录”／“创建记录”／“更新记录”执行器

变量 记录列表（文本） 会将若干条记录输出为 Markdown 语法的文本列表。该变量建议与 “发送报告” 或 “发送邮件”执行器配合使用。当该变量作为报告正文的一部分使用时，它的呈现效果如下：

变量 网格列表（文本） 会将若干条记录输出为 Markdown 语法的文本表格。

如何查看变量的结构/数值

要准确引用变量，建议先使用“运行测试”功能预览上游输出结果：

在触发器或执行器配置界面点击「运行测试」。
在弹窗中查看完整的 JSON 输出结构。

注意：部分组件（如“Webhook”触发器）仅在接收到真实请求时才会产生输出，无法通过「运行测试」获取。此时，请在工作流主界面点击「立即运行」，完成一次真实执行后，再在运行历史中查看各步骤输出。

常见问题

Q: 为什么我看不到某些变量？

变量仅显示当前步骤之前已生成输出的触发器/执行器。
需对每个步骤执行「运行测试」或完成一次真实运行，才能在变量选择器中加载结构。

Q: 如何知道变量的具体结构？

可以先执行一次工作流，然后查看执行历史中各步骤的输出结果，了解变量的实际结构。

模板

帮助

价格

博客

社区