跳到主要内容

变量赋值节点

将指定值写入 AI 应用的应用变量中,供后续轮次或其他流程读取。

该节点需要在 AI 应用中关联当前流程才能正常工作。

一、应用场景

  • 跨轮次状态持久化:在对话结束前,将当前轮次的关键结果(如订单号、推荐结果、用户选择)写入应用变量,下一轮对话可通过"变量读取"节点恢复状态。
  • 用户偏好存储:将用户在交互过程中表达的语言偏好、回复风格、常用地址等信息持久化到应用变量,后续轮次自动使用。
  • 计数器/标志位更新:记录用户访问次数、完成步骤标志、错误重试次数等状态,配合条件分支节点实现复杂流程控制。
  • 多节点结果暂存:将 LLM、HTTP、SQL 等节点的输出值赋给应用变量,跨流程共享数据。

二、添加变量赋值节点

在画布中点击前一节点右侧的 ,在节点列表中选择变量赋值节点完成添加。

三、节点配置详解

1. 赋值变量配置

  • 至少配置 1 个变量,可通过点击 添加变量 增加多个。
  • 每一行由三部分组成:变量名 = 变量值
  • 变量名不能重复,若存在重复名称,保存/校验时会提示错误。
  • 支持删除变量(列表中仅剩 1 个时删除按钮隐藏)。
配置项说明
变量名(左侧输入框)填写目标应用变量名,该名称将作为写入 AI 应用变量服务的 key
变量值(右侧选择器)支持两种取值方式,见下文详细说明
添加变量点击可新增一行空变量
删除点击行尾删除图标移除该变量,至少保留 1 个

2. 变量值来源

变量值支持以下两种方式,通过右侧选择器切换:

方式一:引用上游节点输出

  • 通过下拉框选择当前节点之前的节点输出变量。
  • 仅展示 string 类型的上游变量。
  • 选择后自动记录来源节点 ID 和字段名,运行时从流程上下文中取值。

方式二:自定义值

  • 切换为自定义输入模式后,可直接填写固定文本值。
  • 适用于设置常量、默认值、标志位(如 true0已完成)等场景。

引用上游变量时,变量必须来自当前节点之前的串行节点,不能引用并行或后续节点的输出。

3. 配置示例

假设流程中 LLM 节点输出了 result(摘要文本),需要将其存入应用变量供下轮使用,同时记录一个操作标志:

变量名值来源说明
lastSummary引用:LLM 节点 → result保存 LLM 生成的摘要
hasProcessed自定义值:true标记本轮已处理

执行后,下一轮对话中通过"变量读取"节点即可读取 lastSummaryhasProcessed

四、注意事项

该节点必须在 AI 应用中关联流程后使用。若流程未关联 AI 应用,节点执行时将报错:"变量赋值需要关联AI应用,请在AI应用中使用该流程"。

应用变量是按用户隔离的,不同用户在同一 AI 应用中赋值的变量互不影响。

该节点没有输出变量。它的作用是将值写入 AI 应用的变量服务,而非在当前流程上下文中产出新变量。

若同一变量名被多次赋值,后赋的值会覆盖先赋的值。