行为流节点

目前已支持数据库操作、执行 AI、权限修改、API 调用、执行代码块等多类型节点。

数据库

可以选择一张表进行数据的查询、插入、修改和删除

⚠️

目前单个数据库查询节点最大支持查询 1000 行数据，如需查询更多数据，请使用循环分批查询。

调用 API

可以选择执行一个已在 API 功能中配置的 API，将返回结果绑定到出参上，即可在行为流中输出该 API 的执行结果。

运行 AI

执行配置好的 Agent（行为流执行方式需改为异步）。

运行行为流

调用另一个行为流。同步行为流无法调用异步行为流。

设置变量

对已经声明的行为流变量进行赋值。

当前用户

获取当前用户 ID，以及微信 Union ID、Open ID、Access Token。

权限

对指定用户进行角色授权或移除。

运行代码

执行自定义代码块，具体教程见代码块。

文件

保存外部图片、视频和文件，并转换为 Zion 的对应类型。

条件分支

用于分支逻辑判断，执行顺序为从左到右依次判断。

列表循环

用于遍历列表中的每个元素，并对每个元素执行指定操作。循环的运行过程如下：

输入： 此节点接收一个列表作为数据源。
执行： 从列表第一项开始，执行循环体内的全部动作；完成后自动处理下一项，直至列表处理完毕。
输出： 每次迭代中，可将「项数据 (item)」和「项索引 (index)」作为内部节点的输入。

如需循环固定次数，可用 SEQUENCE 公式生成相应长度的数组，并将其作为循环数据源。

条件循环

用于循环执行指定次数的逻辑。循环的运行过程如下：

条件： 设置一个条件表达式。
执行： 如果条件表达式为真，则执行循环体内的全部动作；否则跳出循环。
结束： 当条件表达式为假时，循环结束。

为防止无限循环，单个条件循环最多可执行 100 次。

跳出循环

用于跳出最近一层循环。

Gemini Veo 3.1

视频生成节点。Veo 3.1 可生成最长约 8 秒、720p / 1080p / 4K 的高保真视频，并支持原生音频（行为流执行方式需改为异步）。

参数说明

参数	说明	类型	是否必填
prompt	视频的文字说明提示词。支持音频提示。	文本	是
negativePrompt	描述视频中不应包含的内容。不可与referenceImage一起使用，否则调用会失败	文本	否
firstImage	视频的第一帧，不可与referenceImage一起使用，否则调用会失败	图片	否
lastImage	视频的最后一帧，不可与referenceImage一起使用，必须与firstImage参数搭配使用，否则调用会失败。	图片	否
referenceImage1/2/3	用作风格和内容参考的3张图片，最多3张，如果referenceType为null，这个字段不生效	图片	否
referenceType1/2/3	参考图片的类型，只能填”asset”或”style”。“asset”:参考图片为生成的视频提供素材，例如：场景、物体或角色。“style”:参考图片为生成的视频提供风格信息，例如：场景颜色、光照或纹理（类型为style最多只能有一张图）。如果referenceImage为null，这个字段不生效	文本	否
aspectRatio	视频的宽高比（只支持两种比例：“16:9”（默认值）、“9:16”）	文本	否
resolution	视频分辨率，只支持”720p”,“1080p”,“4k”这三种，默认720p	文本	否
durationSeconds	生成的视频的时长。只支持4,6,8这三种，默认8,单位秒。	整数	否
video	生成的结果视频	视频	是

发送短信 - 阿里云

发送阿里云短信节点，用于在自动化流程中调用阿里云短信服务，向指定手机号发送验证码、通知或营销短信。

若需在用户注册、登录、重置密码等场景下使用该节点发送验证码，需要先在 设置 → 验证码 中添加自定义配置，然后在该节点中选择自定义配置。具体教程见用户事件 - 发送验证码。

1. 准备工作 (在阿里云控制台完成)

在使用此节点前，您必须在阿里云平台完成以下准备：

开通服务：开通阿里云短信服务。
获取凭证：在阿里云 RAM 控制台创建一个子账号（建议），授予 AliyunDysmsFullAccess（或按需精细授权）权限，并获取对应的 AccessKey ID 和 AccessKey Secret。
申请签名：在短信控制台申请“短信签名”（如：阿里云），并等待审核通过。
申请模板：在短信控制台申请“短信模板”（例如：您的验证码为：${code}，5分钟内有效。），并获取对应的模板 Code（如：SMS_153055555）。

2. 配置行为流节点 (在 Zion 完成)

更详细的字段说明，见阿里云短信 API 文档。

access_key
- 填写说明：输入您在阿里云获取的 AccessKey ID。
- 示例：LTAI5t7*******
access_secret
- 填写说明：输入与 AccessKey ID 对应的 AccessKey Secret。请注意保密，不要泄露。
phone_numbers (接收手机号)
- 填写说明：输入需要接收短信的手机号码。支持国内和国际手机号。
- 支持群发：如果需要向多个手机号发送，可以以英文逗号 , 分隔（例如：+8613900000000,+8613811111111），最多支持 1000 个手机号。可以通过绑定前置节点的数据来动态填入。
手机号格式必须为 E.164（含 + 与国家码），例如：+8613900000000。否则可能被识别为非法手机号，导致发送失败。
sign_name (短信签名)
- 填写说明：输入在阿里云控制台已审核通过的短信签名名称。
- 示例：阿里云（不需要包含签名外面的【】括号）。
template_code (短信模板 Code)
- 填写说明：输入在阿里云控制台已审核通过的短信模板的 Code。
- 示例：SMS_153055555
template_params (模板参数)
- 填写说明：如果您的短信模板中包含变量（如 ${code}），需要在此处传入变量的实际值。
- 配置技巧： 该参数类型为 JSON，若编辑器无法直接填写 JSON，建议在发送短信节点前添加运行代码节点生成对象并绑定到本字段。示例：
```
const code = context.getArg('code');
context.setReturn('code_param', {
  code: code
});
```
代码说明：通过入参 code 将验证码传入，组装成 JSON 字符串后通过出参 code_param 返回。实际返回的 JSON 为 {"code":"123456"}。
sms_up_extend_code (上行短信扩展码 - 高级选项)
- 填写说明：非必填。用于定制某种服务或完成查询的上行短信扩展码。无特殊业务需求请留空。
out_id (外部流水扩展字段 - 高级选项)
- 填写说明：非必填。外部系统的流水号。如果您需要在阿里云的短信回执中携带您自己系统的订单号或流水号以便对账，可以填入此字段。无特殊需要请留空。

发送短信 - Twilio

Twilio 是全球常用的云通信平台，该节点常用于向海外用户发送短信验证码、国际物流通知等，也支持发送国内短信。

若需在用户注册、登录、重置密码等场景下用该节点发送验证码，需要先在 设置 → 验证码 中添加自定义配置，并在自定义发送行为流中绑定本节点参数。具体教程见用户事件 - 发送验证码。

1. 准备工作（在 Twilio 控制台完成）

在使用此节点前，请在 Twilio 完成以下准备：

注册并登录：拥有 Twilio 账号并进入 Console 。
获取凭证：在控制台查看 Account SID 与 Auth Token（Auth Token 需点击显示后复制，注意保密）。
发信号码：在 Twilio 购买或使用试用提供的、已具备短信（SMS）能力的发信号码；该号码将填在节点的 from_phone_number 中。号码格式需符合 Twilio 要求（通常为带国家码的 E.164，如 +12025550100）。

2. 配置行为流节点（在 Zion 完成）

右侧面板「输入」中的字段与 Twilio 发信所需信息一一对应。更完整的参数与限制说明见 Twilio 文档。

account_sid
- 填写说明：Twilio 控制台 Account Info 中的 Account SID。
- 示例：ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
auth_token
- 填写说明：与上述 Account 配对的 Auth Token，用于接口鉴权。请勿泄露或提交到公开仓库。
from_phone_number
- 填写说明：Twilio 侧用于发短信的号码，须为你在控制台已启用短信能力、且允许作为发件方的号码。
- 示例：+12025550100
to_phone_number
- 填写说明：接收短信的手机号。
- 示例：+8613800138000
from_phone_number 与 to_phone_number 均须为 E.164（含 + 与国家码），例如：+8613800138000。否则可能被识别为非法手机号，导致发送失败。
message
- 填写说明：短信正文，纯文本。长度与拆分条数受运营商与 Twilio 规则限制，请以 Twilio 文档与实际报错为准。若配合发送验证码自定义行为流，通常将行为流入参中的验证码拼进正文。

发送邮件 - 阿里云

该节点封装了阿里云邮件推送的单条发信接口，用于向指定邮箱发送通知、验证码或营销类邮件。

若需在用户注册、登录、重置密码等场景下使用该节点发送邮件，需要先在 设置 → 验证码 中添加自定义配置，然后在该节点中选择自定义配置。具体教程见用户事件 - 发送验证码。

1. 准备工作（在阿里云控制台完成）

在使用此节点前，请在阿里云完成以下准备：

开通服务：开通「邮件推送」服务。
配置发信域名与地址：在控制台配置发信域名（按指引完成 DNS 解析与所有权验证），并新建已通过验证的发信地址（例如 noreply@mail.yourdomain.com）。
获取凭证：在 RAM 中创建子账号，授予邮件推送调用权限（如 AliyunDirectMailFullAccess，或按业务做精细授权），并获取 AccessKey ID 与 AccessKey Secret。
邮件标签（按需）：若需按标签统计到达率、打开率等，请在控制台预先创建邮件标签；开启数据追踪时通常必须配合使用标签（见下文 click_trace 说明）。

2. 配置行为流节点（在 Zion 完成）

更详细的字段说明，见阿里云邮件推送 API 文档。

access_key
- 填写说明：填入 RAM 子账号的 AccessKey ID。
- 示例：LTAI5t7*******
access_secret
- 填写说明：与 AccessKey ID 配对的 Secret，注意保密，勿泄露或提交到公开仓库。
account_name（发信地址）
- 填写说明：填写在阿里云控制台已验证通过的发信地址。
- 示例：notice@mail.example.com
address_type（地址类型）
- 填写说明：填数字。建议填 1（使用已配置的发信地址发信，收件人看到的是你的正式发信邮箱）。填 0 时，收件人侧可能显示为系统随机生成的长地址（多用于特定防退信场景）。
reply_to_address
- 填写说明：是否使用控制台配置的默认回信地址，填 true 或 false。为 true 时，用户点击「回复」将发往控制台默认回信地址。
to_address（收信人）
- 填写说明：收信邮箱；多人时用英文逗号 , 分隔，单次最多 100 个地址。可通过魔法棒绑定前置节点输出动态填入。
subject（邮件主题）
- 填写说明：邮件标题，例如「欢迎注册」。注意阿里云对主题长度有限制（常见为不超过 100 个字符，以官方文档为准）。
html_body 与 text_body（正文）
- 填写说明：两者至少填其一。需要排版、图片、按钮等时，将 HTML 填入 html_body；纯文字通知可只填 text_body。
from_alias（发件人昵称）
- 填写说明：选填。例如 XX公司官方团队，收件人可能看到昵称与发信地址的组合展示；注意昵称长度等限制以控制台与官方文档为准（常见建议不超过约 15 个字符）。
reply_address / reply_address_alias（自定义回信）
- 填写说明：若希望本封邮件的回复发往指定邮箱（而非控制台默认），可填 reply_address；reply_address_alias 为对应显示昵称。与 reply_to_address 的配合关系以实现与官方文档为准。
tag_name 与 click_trace（数据追踪）
- 填写说明：需要统计打开、点击等行为时，可将 click_trace 设为 1。若开启追踪（click_trace 为 1），通常必须同时填写已在控制台创建好的 tag_name，否则可能调用失败，具体以接口报错与官方文档为准。