跳到主要内容

变量读取节点

从 AI 应用的应用变量中读取指定变量的值，供下游节点使用。

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

一、应用场景​

  • 跨轮次上下文传递：在多轮对话中，通过读取上一轮赋值的应用变量（如用户偏好、已选商品、当前步骤编号等），使流程在新一轮对话时仍能延续上下文。
  • 用户个性化配置获取：读取存储在应用变量中的用户昵称、语言偏好、角色标签等信息，驱动后续 LLM 提示词或回复节点做个性化输出。
  • 流程状态恢复：当一个长流程被拆为多个子流程或多轮调用时，通过读取应用变量中的中间状态值，还原上一次执行进度。
  • 计数器/标志位读取：读取记录在应用变量中的访问次数、已完成步骤标志等，供条件分支或循环节点做判断。

二、添加变量读取节点​

在画布中点击前一节点右侧的 ，在节点列表中选择变量读取节点完成添加。

三、节点配置详解​

1. 读取变量配置​

  • 至少配置 1 个变量，可通过点击 添加变量 增加多个。
  • 每一行为一个输入框，填写需要读取的变量名（即 AI 应用中已定义的应用变量名称）。
  • 变量名不能重复，若存在重复名称，保存/校验时会提示错误。
  • 支持删除变量（列表中仅剩 1 个时删除按钮隐藏）。
配置项说明
变量名填写 AI 应用中已定义的应用变量名，用于从变量服务中读取对应值
添加变量点击可新增一行空变量
删除点击行尾删除图标移除该变量，至少保留 1 个

2. 输出变量​

  • 每个已配置的变量名会自动生成同名的输出字段，类型为 string。
  • 下游节点可通过变量选择器引用本节点输出，例如读取了变量 userName，下游即可选择 变量读取.userName。
  • 若 AI 应用中该变量尚未赋值或不存在，返回空字符串。

3. 配置示例​

假设 AI 应用中已经配置并存储了以下变量：

  • userName = "张三"
  • visitCount = "5"

在变量读取节点中添加两行：

  1. 变量名填写 userName
  2. 变量名填写 visitCount

执行后，下游节点即可通过 {{userName}} 和 {{visitCount}} 引用对应值。

四、注意事项​

该节点必须在 AI 应用中关联流程后使用。若流程未关联 AI 应用，节点执行时将报错："变量读取需要关联AI应用，请在AI应用中使用该流程"。

应用变量是按用户隔离的，不同用户在同一 AI 应用中读取到的变量值各自独立。

变量名需与赋值时使用的名称严格一致（区分大小写），否则将读取到空值。