变量赋值节点

定义

“变量赋值”节点允许用户在工作流执行期间为变量赋予特定的值。这使得工作流能够动态存储和传输数据，促进不同节点之间的数据共享和交互。变量赋值节点充当数据容器，将用户指定的数据存储在变量中，以供后续节点使用。

快速入门 / 如何使用

节点配置的详细说明：在GoInsight.AI中，右键单击并选择“添加节点”以在工作流中添加变量赋值节点。

1. 配置变量赋值节点的赋值参数

点击“变量赋值节点”，然后在右侧的配置面板中点击“+”以配置此变量赋值节点的“目标变量模式”、“已分配变量”、“写入模式”、“输入类型”和“输入值”。

• 目标变量
  • 用于选择对变量的操作方法，有两个选项：“添加新变量”和“从现有变量导入”。前者创建一个新变量并赋值，后者允许为现有变量重新赋值。
  • 客户服务系统：选择“添加新变量”以创建新变量记录用户姓名；选择“选择现有变量”以更新已记录的用户名变量。
• 
• 
• 已分配变量
  • 如果在“目标变量模式”中选择了“添加新变量”，则“已分配变量”必须包含“新变量名称”（必填）和新变量的数据类型。 如果在“目标变量模式”中选择了“选择现有变量”，则必须从“已分配变量”下拉菜单中选择要分配的变量。

选择“添加新变量”时使用不同系统预设的数据类型的提示和说明：

• 写入模式
  

  写入模式决定目标变量如何分配新值，有三种选项：

  1. 追加模式将新值添加到现有变量中；字符串会进行连接，数组会添加新元素，保留原始数据并实现增量更新。
  2. 覆盖模式用新值完全替换变量的现有值，将变量内容更新为最新数据。
  3. 数组合并对于数组变量，将新数组与原数组的内容合并为一个包含所有元素的新数组。
  • 使用写入模式时：在“追加模式”下，为非数组类型变量赋值时，可以选择是否“自动添加换行符”。

• 类型
  
  定义输入值的类型，有以下两个选项：
1. 变量
   表示值是从工作流中的其他现有变量获取的。这允许使用已生成或存储的数据为当前变量赋值，实现变量间的数据传输与共享。
2. 值
   直接使用用户指定的静态值为变量赋值。此值在工作流执行期间不会动态变化，是固定输入内容。

• 值
  

  输入值是指用于赋值给目标变量的数据。输入值需考虑以下几点：

1. 数据类型一致性
   输入值的数据类型必须与目标变量的数据类型保持一致。例如，如果目标变量是[数字]，则输入值也必须为数字类型。
2. 数组类型输入值
   当目标变量为数组类型时，输入值必须为数组或单个元素。 如果是数组合并写入模式，输入值必须为数组。 对于[布尔]类型的目标变量，输入值只能为[真]或[假]。
3. 必填项
   [输入值]为必填项，不能留空，否则配置将无法保存。

注意事项

• 在“添加新变量”选项中，写入模式的“追加模式”不可用。
• “追加模式”的目标变量必须为数组/字符串类型。例如，如果目标变量是数组[数字]，则输入值必须为数字类型。
• “数组合并”的目标变量必须为数组类型。

实际案例场景

• 客户服务场景：动态记录用户填写的联系信息，并自动生成后续个性化提醒。
  用户在对话过程中输入他们的联系信息（例如手机号码、电子邮件地址）。通过“变量赋值”节点，将这些信息存储在会话变量中。系统可以在后续对话中使用此变量，以便自动识别用户并推送个性化提醒或通知。

• 客户场景工作流的设计步骤：
  1. 设置会话变量：创建一个会话变量，例如[userContact]，用于存储用户的联系信息。将[userContact]设置为对象（Object），以便记录电子邮件和电话号码等字段。
  2. 信息提取：在LLM节点中，提示模型从用户输入中提取有效的联系信息。输出会将用户输入的电子邮件或电话号码映射为键值对，例如
     {"email": "...", "phone": "..."}。
  3. 变量赋值：使用“变量赋值”节点将提取的信息分配给会话变量[userContact]。写入模式可以根据需要设置为[覆盖模式]或[追加模式]（覆盖模式：完全替换现有的[userContact]值；追加模式：仅更新或添加现有字段，不影响其他已存储字段）。[输入类型]选择为[变量]，表示输入值由工作流动态生成，而非固定值。
  4. 后续引用：在后续对话中，通过引用[userContact]变量，模型可以直接访问用户的电子邮件或电话号码，并根据需要自动发送提醒或生成个性化问候语。