变量选择器
概述
变量选择器是自动化工作流（Automation）中用于引用上游触发器或执行器输出数据的可视化工具。通过变量选择器，您可以在配置动作（Action）时，将前一步的数据传递给后续步骤，以满足复杂的业务场景需求。
例如，在群发邮件的场景中，可按以下流程配置自动化：
-
使用“获取记录”执行器筛选目标客户名单；
-
在“循环”执行器中逐条处理名单；
-
针对每位客户，调用“DeepSeek – 文本生成”执行器生成定制化邮件正文；
-
最后，将客户邮箱地址作为变量，传递给“发送邮件”执行器完成群发。
如何使用
- 在配置自动化工作流执行器的时候，将光标放在输入框中
- 按下键盘上的
/键，即可唤起变量选择器 - 在弹出的选择器中浏览可用变量
- 点击所需变量将其插入到当前配置项中
注意，仅部分执行器配置项支持变量的插入使用，请根据界面上的提示进行操作。
工作原理
变量选择器会列出当前步骤之前所有触发器与执行器的输出结果。每个触发器或执行器在运行后均会产生 JSON 结构化输出，变量选择器将其可视化为可点击列表，方便引用。
要正确加载变量列表，请先在触发器或执行器面板点击「运行测试」，以确保已有输出结果可供选择。
变量的数据类型
变量基于 JavaScript 数据结构，常见类型包括对象（Object）、数组（Array）、文本（String）和数字（Number）。在列表中，每个变量名前方均有图标标识其类型。
对象
- 右侧显示 “>” 图标，表示可展开查看子字段；
- 若出现「选择」按钮，表示可将整个对象插入配置。
数组
与对象类型类似，可展开查看元素。常与“循环”执行器配合，用于批量处理。
示例：
-
“获取记录”执行器输出一个客户记录数组；
-
“循环”执行器遍历该数组，为每位客户调用 AI 生成正文；
-
再将生成的正文和邮箱地址，分别传递给“发送邮件”执行器。
下方动图展示了如何在“循环”执行器中选择"获取记录"执行器的输出结果作为输入变量：
文本与数字
- 无子字段，右侧无展开图标；
- 可直接点击插入。
特殊变量
某些触发器或执行器会输出格式化文本变量，常见于与数据表记录相关的组件，包括：
-
“有记录满足条件时”触发器
-
“有新记录创建”触发器
-
“获取记录”／“创建记录”／“更新记录”执行器
变量 记录列表（文本） 会将若干条记录输出为 Markdown 语法的文本列表。该变量建议与 “发送报告” 或 “发送邮件”执行器配合使用。当该变量作为报告正文的一部分使用时，它的呈现效果如下：
变量 网格列表（文本） 会将若干条记录输出为 Markdown 语法的文本表格。
如何查看变量的结构/数值
要准确引用变量，建议先使用“运行测试”功能预览上游输出结果：
- 在触发器或执行器配置界面点击「运行测试」。
- 在弹窗中查看完整的 JSON 输出结构。
注意：部分组件（如“Webhook”触发器）仅在接收到真实请求时才会产生输出，无法通过「运行测试」获取。 此时，请在工作流主界面点击「立即运行」，完成一次真实执行后，再在运行历史中查看各步骤输出。
常见问题
Q: 为什么我看不到某些变量？
- 变量仅显示当前步骤之前已生成输出的触发器/执行器。
- 需对每个步骤执行「运行测试」或完成一次真实运行，才能在变量选择器中加载结构。
Q: 如何知道变量的具体结构？
可以先执行一次工作流，然后查看执行历史中各步骤的输出结果，了解变量的实际结构。
推荐阅读
推荐AI自动化模板
