変数

在此章節，會詳細介紹變數的欄位與使用方式。

新增變數

只要您是 Roflow 的 PLUS 專業版或 PLUS 團隊版⽤⼾，都能使⽤變數功能。

在 Roflow 專案內的左側邊欄，點選「① 變數」就能開啟變數清單，管理此專案中的所有變數。初次使⽤時，尚無任何已設定的變數，請點擊⾴⾯右上⾓的「② 新增」按鈕，開始新增變數。

💡 ⼀個專案中，最多能新增 100 個變數。

新增變數時，需填寫以下內容。

① 名稱：變數名稱。命名請注意：
• 使⽤英⽂字⺟作為第⼀個字元，⼤⼩寫視為不同字
• 只能使⽤英數字及符號下底線（Underscore）_
• 變數名稱必須為唯⼀，不可和同專案內的其他變數名稱重複（跨專案不限）
• 不建議使⽤長名稱，操作時可能無法完整顯⽰
• 完成新增變數後，不能再變更名稱

② 類別：⽬前僅可使⽤⼀般（Normal）類別

③ 資料型別：根據欲蒐集的資料性質，來選擇數字（Number）/ 字串（String）

④ 資料來源：本地端（Robot）/ 伺服器（Remote Server）。
前者為機器⼈裝置在⽤⼾互動過程中產⽣的資料；後者為即時接收指定伺服器的資料。
若專案尚未設定伺服器，請⾄專案設定｜變數結果儲存位置設定，若欲選擇其他伺服器（非女媧伺服器）請設定路徑
💡 若不同變數取⽤了相同路徑，系統將作提⽰，您可依使⽤需求來判斷是否更改路徑。

⑤ 起始值：變數資料計算的起算預設值，需判斷「資料型別」來填寫。
若資料型別是數字（Number），起始值也須為數字；若資料型別是字串（String），起始值可為數字、字串或不填寫內容（即為空值）

⑥ 標籤：非必填，每個變數可加入 10 個標籤來幫助辨識。可在此選擇/新增/刪除標籤
💡 變數的名稱、類別、資料型別，在完成新增後不可更改。

變數管理

在變數清單中，您能瀏覽此專案所有的變數並進⾏管理。
💡 每個專案各⾃獨立管理其中的變數，即使變數名稱相同，不同專案之間的變數也沒有關聯。

① 搜尋變數：在本專案變數清單中搜尋
② 以標籤搜尋：輸入「標籤關鍵字」來篩選標籤，可單/多選標籤來搜尋變數
③ 以關鍵字搜尋：不論有無選擇標籤，都能輸入「變數名稱關鍵字」來搜尋變數
④ 搜尋按鈕：指定標籤/ 關鍵字等搜尋條件後，點此按鈕開始搜尋
⑤ 刪除變數：可於變數清單中，⼀次勾選多個變數來刪除
⑥ 最後編輯：各變數的最後編輯時間、最後編輯者
⑦ 編輯：編輯或刪除某個變數
⑧ 清單⾴籤：若變數清單有多筆資料，將分⾴顯⽰。點擊⾴碼或左/右側按鈕來切換分⾴

在模組加入變數

新增變數後，您就可以在服務流程的各個模組中加入變數，以蒐集機器⼈裝置和終端⽤⼾互動後獲得的資料，以供後續模組使⽤並記錄特定資訊；也能進⾏賦值或運算。

如何在流程中運⽤變數？

範例 1：若凱比認得和他互動的⼈員，可唸出⼈員名稱

在「觸發條件_看到⼈」模組中，您可以加入變數來記錄機器⼈所⾒的⼈員名稱，並在後續流程的模組中宣告此變數，讓機器⼈在對話中唸出這位⼈員的名稱。

範例 2：設計問卷並記錄填寫內容

⽤多個「資料填寫」模組來組成⼀份問券，每個模組為⼀則問題。您可以在每個「資料填寫」模組中，分別加入不同的變數，來針對特定問題記錄回答內容。

有些模組在機器⼈上能預設儲存部分資料。除了在模組加入⾃定義變數，您也可以在變數操作時取⽤/宣告「模組儲存值」。

⽀援「模組儲存值」的模組有：觸發條件、語⾳分流、選單/題⽬、資料填寫、辨識、AI 對話、MQTT 模組。

在模組中加入變數，以觸發條件模組為例。

① 變數：在模組設定視窗裡找到「變數」項⽬，點擊「設定」來加入變數
② 加入變數視窗：點擊「設定」後將在右側展開此視窗，來加入變數
③ 加入變數：點擊按鈕，在此模組加入變數，請⾒變數操作與運算
④ 加入時機：可收合/展開，查看此時機中加入的所有變數操作
　💡 在同⼀個模組中，可以加入多個不同時機的變數
⑤ 變數操作：每完成⼀次加入變數，將新增⼀則變數操作（運算式）
⑥ 更改順序：長按橫條圖⽰，上下拖曳來更改每則變數操作的順序
⑦ 編輯：編輯/ 刪除單則變數操作
　⚠ 請注意：若此專案已被部署執⾏，刪除任一變數，都有可能影響現有數據的回收。
⑧ 取消：不儲存此次變數設定
⑨ 儲存：儲存此次變數設定
⑩ 關閉右側視窗：關閉「加入變數」視窗，不儲存此次編輯
⑪ 編輯限制：加入變數時，不可更改觸發⽅式、MQTT 消息接收/發送等設定

變數操作與運算

在模組中加入變數操作時，需做以下設定。以觸發條件模組為例。

① 加入時機：選擇加入變數的時機，各模組有不同的時機選項
② 加入變數：選擇⾃訂變數
③ 執⾏操作：輸入「{{」來宣告變數，進⾏賦值或運算。可宣告模組儲存值/ ⾃訂變數
④ 模組儲存值：有些模組在機器⼈上能預設儲存某些資料，以供取⽤/宣告。各模組有不同的儲存值，但並非所有模組都有儲存值。例如指定觸發條件為「看到⼈」，機器⼈能預設儲存該⼈員的名稱、性別、年齡等資料
⑤ ⾃訂變數：選擇您已在此專案新增的變數
⑥ 變數資訊：右側視窗會即時顯⽰⽬前游標指向變數的詳細資訊

變數操作規則

執⾏操作時，輸入「{{」來宣告變數，進⾏賦值或運算。根據變數所屬的資料型別，有不同的操作規則：

String 變數類別

可以賦值。

(1) 變數為字串（String），可直接與其他字串或 String 類型的變數拼接
(2) 可選擇「該模組可提供的值」來存入變數

Number 變數類別

可以運算。

(1) 變數為數字（Number），可做加/減/乘/除/取餘數運算（+, -, *, /, %）
(2) 變數必須⽤雙⼤括號「{{」和「}}」括起來
(3) 運算式只能包含數字（可以有⼩數點）、運算符號（+, -, *, /, %）、空格、括號 ( )、包含變數的雙⼤括號，例如：{{變數名稱}}
(4) 運算式中可以包含圓括號 ( )，且左右括號必須成對出現
(5) 數字不能緊鄰右括號後⽅，也不能緊鄰左括號前⽅
(6) 數字不能以⼩數點結尾，且⼩數點不能為數字的開頭
(7) 運算式的開頭不能是⼩數點、運算符號（負號除外）
(8) 運算式的結尾不能是運算符號
(9) Number 範圍限制：-9007199254740991 ~ 9007199254740991

TTS 欄位宣告變數

所有模組的開場語/ 結尾語/ 機器⼈語⾳（TTS，Text to Speech）等欄位，都能宣告您已新增的變數，讓機器⼈唸出該變數存入的值。

於⽂字欄位，輸入 {{ 或點擊欄位右下⾓ fx 即可宣告變數。

變數資料回收

您在多個模組加入/ 宣告變數後，除了能創造更⽣動的機器⼈互動，還能讓機器⼈幫您精準記錄變數資料，並上傳到指定位置。

變數資料上傳到哪裡

可指定上傳到「女媧伺服器」或「其他伺服器」。關於如何設定，詳⾒：變數結果儲存位置。

變數資料如何上傳、何時上傳

當流程中已有模組加入變數，就能在後⾯的流程插入變數結果上傳模組，來⾃訂「要上傳資料的變數」與「上傳時機」。

變數資料集

上傳到女媧伺服器的變數資料，將⾃動顯⽰在該專案的「變數資料集」。

① 所有資料：即時顯⽰專案最新的變數資料及所有歷史變數資料，此表單不可重新命名或刪除
② 檢視畫⾯：篩選並⾃訂資料檢視範圍，可新增多個檢視畫⾯、重新命名或刪除
③ 新增檢視畫⾯：從「① 所有資料」選擇想要查看的內容，新增⼀個檢視畫⾯⼦表單
④ 篩選：透過時區、觸發時間、裝置、關鍵字來篩選檢視資料。可同時加入多個篩選條件。預設選擇您登入時的所在時區，若專案有部署⾄所在地跨時區的多個裝置，請留意時區的切換
⑤ 關鍵字篩選：輸入資料的關鍵字，來篩選檢視範圍
⑥ 變數資料：服務流程中的變數使⽤記錄資料。除了「觸發時間」與「裝置名稱」，根據專案流程中「有加入變數的模組」被執⾏的順序，依序顯⽰其變數結果
⑦ 匯出：全選/選擇部分資料來匯出。⽀援下載格式：.csv, .txt , .xlsx
⑧ 編輯｜所有資料：對「所有資料」表單，進⾏設定
⑨ 設定顯⽰欄位：設定要顯示的欄位。
⑩ 設定顯⽰數量：設定⼀次顯⽰的資料數量，可選擇 10 筆、25 筆、50 筆、100 筆
⑪ 匯出所有資料：匯出「所有資料」表單的全部內容
⑫ 編輯｜檢視畫⾯：對⼀個「檢視畫⾯」表單，進⾏設定
⑬ 重新命名（檢視畫⾯）：編輯當下瀏覽的「檢視畫⾯」表單名稱。檢視畫⾯的名稱不可重複
⑭ 匯出檢視畫⾯：匯出當下瀏覽的「檢視畫⾯」表單的全部內容
⑮ 刪除檢視畫⾯：刪除當下瀏覽的「檢視畫⾯」表單。該表單裡的資料，仍可在「① 所有資料」或其他檢視畫⾯中被找到

設定顯⽰欄位

「所有資料」和「檢視畫⾯」表單，都能設定欲顯⽰的欄位。

① 搜尋變數名稱：輸入變數名稱關鍵字來搜尋。
② 可供選擇的欄位：列出當下設定表單的所有欄位。勾選欲檢視的內容，未勾選的內容則會隱藏
③ 已選擇的欄位：被勾選的內容將顯⽰於此
④ 移除：點叉叉取消選擇。該欄位將從「③ 已選擇的欄位」移除，仍可於左側重新勾選
⑤ 拖曳：長按上下拖曳，調整該欄位在表單中的顯⽰順序（由上到下，對應表單由左到右的順序）

← 上一篇：服務數據

前往閱讀：資源管理與專案協作

変数