變數賦值節點

定義

'變數賦值'節點允許使用者在工作流程執行過程中為變數分配特定值。這使得工作流程能夠動態儲存和轉移資料，促進不同節點之間的資料共享和互動。變數賦值節點充當資料容器，將使用者指定的資料儲存在變數中，以供後續節點使用。

快速入門 / 如何使用

節點配置詳細說明：在GoInsight.AI中，右鍵點擊並選擇「新增節點」以將「變數賦值」節點添加到工作流程中。

1. 配置「變數賦值」節點的變數建立參數

點擊「變數賦值」節點，然後點擊右側配置面板中的「+」來設定此節點的「目標變數模式」、「指定變數」、「寫入模式」、「輸入類型」和「輸入值」。

• 目標變數
  • 這用於選擇對變數的操作方式，提供兩個選項：「新增變數」和「選擇已存在的變數」。前者會建立一個新變數並賦予其值，而後者則允許重新為現有變數賦值。
  • 客戶服務系統：選擇「新增變數」來建立一個新變數以記錄使用者的姓名；選擇「選取現有變數」來更新先前記錄的使用者姓名變數。
• 新增變數:

  
• 選擇已存在的變數:

  
• 指定變數
  • 若在「目標變數模式」中選擇「新增變數」，則「賦值的變數」必須包含「新變數名稱」（必填）並選擇新變數的資料類型。
  • 若在「目標變數模式」中選擇「選擇已存在的變數」，則必須從「賦值的變數」下拉式選單中選擇要賦值的變數。
  • 當變量為“Number”類型時，可以對其值進行“添加”、“刪減”或“覆蓋”。

使用不同系統預設資料類型選擇"添加新變數"的提示和說明：

• 寫入模式
  

  寫入模式決定了如何為目標變數賦予新值，提供三種選擇：

  1. 追加模式：將新值附加到現有變數中；字串將串接，陣列將新增元素，保留原始資料並逐步更新。
  2. 覆蓋模式：會完全以新值取代變數的舊值，將變數內容更新為最新資料。
  3. 陣列合併：對於陣列變數，會將新陣列與原始陣列的內容合併，形成包含兩者元素的新陣列。
  使用寫入模式時：在“追加模式”下，為非數組類型變量賦值時，可以選擇是否“自動新增換行”。

• 類型
  
  定義值的輸入類型，提供以下兩種選擇：
1. 變數
   表示值是來自工作流程中其他現有變數的資料。這允許使用已產生或儲存的資料來賦值給當前變數，實現變數之間的資料傳輸與共享。
2. 值
   直接使用使用者指定的靜態值來賦值給變數。此值在工作流程執行期間不會動態變化，是固定的輸入內容。

• 值
  

  輸入值指的是用於賦予目標變數的資料內容。以下是輸入值的考量因素：

1. 資料類型一致性：
   輸入值的資料類型必須與目標變數的資料類型一致。例如，若目標變數是 [數字]，則輸入值也必須是數字。
2. 陣列類型輸入值：
   當目標變數是陣列類型時，輸入值也必須是陣列或單個元素。若在數字合併寫入模式下，輸入值必須是陣列。布林類型限制：對於 [布林] 類型的目標變數，輸入值只能是 [true] 或 [false]。
3. 必填：
   [輸入值] 是必填項，不可留空，否則配置無法儲存。

注意事項

• 在「新增變數」選項中，寫入模式的「追加模式」不可用。
• 「追加模式」的目標變數必須是陣列/字串類型。例如，若目標變數是陣列 [數字]，則輸入變數必須是數字類型。
• 「陣列合併」的目標變數必須是陣列類型。

實用案例情境

• 客戶服務情境：動態記錄使用者填寫的聯絡資訊，並自動產生後續的個人化提醒。
  使用者在對話中輸入聯絡資訊（例如手機號碼、電子郵件地址）。透過「變數賦值」節點，將此資訊儲存在會話變數中。系統可以在後續對話中使用此變數，自動識別使用者並推送個人化提醒或通知。

• 客戶場景工作流程設計步驟：
  1. 設定會話變數：建立一個會話變數，例如 [userContact]，以儲存使用者的聯絡資訊。將 [userContact] 設定為物件（Object），以便未來記錄電子郵件和電話號碼等欄位。
  2. 資訊提取：在 LLM 節點中，提示模型從使用者輸入中提取有效的聯絡資訊。輸出會將使用者輸入的電子郵件或電話號碼映射為鍵值對，例如
     {"email": "...", "phone": "..."}
     。
  3. 變數賦值：使用「變數賦值」節點將提取的資訊賦值到會話變數 [userContact]。寫入模式可根據需求設定為「覆蓋模式」或「追加模式」（覆蓋模式：完全取代現有 [userContact] 值；追加模式：僅更新現有欄位或新增欄位而不影響其他已儲存的欄位）。選擇 [輸入類型] 為 [變數]，表示輸入值是由工作流程動態產生，而不是固定值。
  4. 後續引用：在後續對話中，透過插入對 [userContact] 變數的引用，模型可以直接存取使用者的電子郵件或電話號碼。根據需求，自動向使用者發送提醒或產生個人化問候語句。