資源管理與協作
資源庫管理
不論您是上傳，或從其他女媧商務⼯具匯入檔案或資料，都將被彙整在「Roflow 資源庫」中。Roflow 資源庫協助您系統化、有效地分類管理所有資源，主要類別有：
- 媒體與⼯具
- ⼈員管理
- 辨識模型
- 對話模型
- 語音分流語料
- MQTT 伺服器
- 地圖管理
- API 管理
「媒體與⼯具」和「⼈員管理」開放給所有⽅案⽤⼾使⽤；其餘類別，則為 PLUS 進階功能。其中，「地圖管理」需搭配特定機型 Collibot 使用。
媒體與⼯具
管理圖片、影片、⾳檔、動作和女媧商務⼯具的檔案。
🤔 如何新增「女媧商務⼯具」檔案？
選擇「上傳檔案」或「從⼯具匯入」。
後者需開通這些⼯具的使⽤權（程式實驗室/內容編輯器/簡報⼯具/題⽬製造機）才能使⽤此功能
🤔 如何取代檔案？
若您在多個不同專案中使⽤某個檔案，可在資源庫透過「取代檔案」功能，⼀次統⼀更新。勾選欲更新的檔案，點擊⾴⾯左下⽅的「取代檔案」按鈕來上傳新檔案。
⼈員管理
新增、編輯⼈員資料，透過⼈臉辨識訓練，機器⼈將能對顧客作更精準的個⼈化服務。可在此管理、新增⼈員、訓練⼈臉辨識資料。
🤔 如何新增⼈員？
點擊⾴⾯右上⽅「＋新增」按鈕，選擇：
新增⼈員：新增單筆⼈員資料
批次新增：新增多筆⼈員資料；下載⼈員清單範例檔，編輯後上傳，須符合上傳規範
新增⼈員｜⼈員資料⾴
包含「基本資料」與「⼈臉辨識訓練照片」等資料，若有上傳⼈臉照片，儲存新增後系統將⾃動開始訓練。
- 基本資料
① 姓名：⼈員姓⽒、名字為必填
② 稱謂：必填
③ ⼈員頭照：頭照將顯⽰於⼈員清單，⽅便您識別⼈員。上傳的照片將⾃動裁切為圓形，建議尺⼨
最⼩ 300 X 300，限 jpg, jpeg, png 格式
④ 女媧通訊號碼：配合女媧「聯絡⼈系統」使⽤，請輸入 10 位數⼤寫字⺟+數字組合
⑤ 標籤：可新增⼀到多個標籤，⽅便識別、分類⼈員
- ⼈臉辨識訓練照片
非必填，視流程需求來訓練⼈臉辨識功能，系統訓練完成後，機器⼈便能⾼效率、精確地辨識⼈員。
建議上傳符合條件的三張照片，辨識效果最佳。
① 照片規格說明：符合規格，辨識效果最佳
② 新增照片：點擊上傳 1～3 張⼈臉照片；若已上傳，點擊照片範圍可重新選擇
③ ⼈員訓練狀態：新增時為「尚未訓練」，此狀態將隨訓練進度即時更新
⼈臉辨識訓練結果
只要有上傳或更新⼈臉照片資料，系統將⾃動開始訓練、每隔 30 秒⾃動刷新訓練結果。若您想查看即時訓練結果，可於「⼈員清單」⾴⾯右上⾓點擊「更新訓練結果」來檢視最新狀態。
地圖管理
管理不同場域的充電站與定位點，讓機器人依地圖導航移動、完成載物任務。需搭配特定機型 Collibot、與女媧地圖建制工具來使用。
🤔 如何新增地圖
當你透過地圖建制工具建立地圖後，將取得一組對應 ID，可在此下載該筆地圖。
① ＋新增：點擊開啟下載視窗
② 下載地圖：根據你有加入的裝置群組，選擇地圖來下載。請注意，需先於機器人端建立地圖並儲存，才能在此進行下載。
③ 編輯地圖：點擊欄位開啟地圖資料詳情頁，可設定地圖共用
🤔 如何更新地圖
若你在多個不同專案中使用某個地圖，可在資源庫透過「取代地圖」功能，一次統一更新。勾選欲更新的地圖，點擊頁面左下方的「取代地圖」按鈕來下載新地圖。
💡考量「多個不同專案皆使用同一張地圖」的可能情況，為提高使用者自主控管的彈性，即使於機器人端或「NUWA RMS Portal｜機器人管理系統｜地圖資源庫」已更新地圖，Roflow 資源庫中的地圖將不會自動同步更新，仍需手動更新，以自行決定何時欲更新哪些地圖。
辨識模型
管理您匯入的 Teachable Machine 辨識訓練檔。
*Teachable Machine 是由 Google 推出的開源⼯具，無需程式設計經驗，讓所有⼈可以透過電腦的視訊鏡頭來進⾏ AI 的物件訓練，能快速、輕鬆地創建機器學習模型。
🤔 如何新增「新增影像辨識模型」
- 於 Teachable Machine 訓練⾄少三個「class」
- 將模型訓練好以「Tensorflow Lite」 輸出，轉換為「Quantized」格式
- 模型名稱會直接取⽤檔名，若名稱重複將詢問是否要取代原有模型
🤔 如何取代檔案
若您在多個不同專案中使⽤某個檔案，可在資源庫透過「取代檔案」功能，⼀次統⼀更新。
假如要取代檔案，請勾選欲更新的檔案，點擊⾴⾯左下⽅的「取代檔案」按鈕來上傳新檔案。
⚠ 注意，取代檔案後，須⾄模組重新選擇對應的辨識物品。
對話模型
由 ChatGPT 判斷互動者的意圖，來引導合適的分流
1.需搭配有加購 AI Plugin 功能的機器人，方能使用
2.於資源庫建立您的模型，並在此模組取用
🤔 如何新增對話模型
點擊頁面右上方「＋新增」按鈕，選擇：
- 新增模型：新增單個對話模型
- 匯入模型：下載範例檔直接編輯並上傳 Excel，填寫說明詳見檔案內子頁面；一份範例檔，可填寫一組對話模型中的內容。
新增對話模型頁
① 模型名稱：填入模型名稱
② 分流選項：每個 Model 中可新增一到多個分流、每個分流有對應的描述文本
③ 選項名稱：簡述主題
④ 描述文本：詳述選項特性。請遵循 prompt 撰寫方式，敘述清晰、具體並明確，避免複雜或含糊的語意；不同選項的描述文本，內容應有足夠差異，以增加判斷的準確度
⑤ 共用設定：允許資源創建者在資源庫更改資源共享設定，「我自己」為必選
語音分流語料
匯入/ 匯出語音分流模組的預期答覆語料，高效重複運用。
🤔 如何新增語音分流語料
點擊頁面右上方「＋新增」按鈕，選擇
1. 新增單筆內容：點擊開啟 新增/編輯頁面
2. 匯入語料：下載範例檔直接編輯並上傳 Excel，填寫說明詳見檔案內子頁面；一份範例檔，可填寫一組語料中的分流答覆內容。
新增語音分流語料
① 語料名稱：填入語料名稱
② 預期答覆：每個語料中可新增一到多個分流答覆，而每個分流答覆可指定對應的機器人回應
③ 分流答覆名稱：可為每則分流答覆自訂名稱
④ 聆聽關鍵字：聽到與關鍵字完全相同的內容，機器人才會回應；設定多個聆聽關鍵字，可提高命中率
⑤ 回應表現：命中聆聽關鍵字之後，機器人的回應語音。在此可輸入變數，但變數的具體數值與定義將視匯入的專案而定
MQTT 伺服器
管理常⽤的伺服器名單，讓您能更輕鬆快速地完成 MQTT 模組設定。
除了預設的「女媧伺服器」，您也能新增其他第三⽅伺服器。
🤔 如何新增「第三⽅伺服器」？
點擊⾴⾯右上⽅「＋新增」按鈕，開啟伺服器資料⾴，填寫基本資料：
① 伺服器名稱：必填
② 伺服器位址：必填，可選擇是否加密（TLS）
③ 連接埠：必填
④ 帳號：非必填，輸入英⽂、數字或半形符號，勿使⽤單/雙引號與空格
⑤ 密碼：非必填，輸入英⽂、數字或半形符號，勿使⽤單/雙引號與空格
📔 關於女媧 MQTT 伺服器
女媧伺服器相關資料不可編輯或刪除，詳細資訊如下。
Name：Nuwa
Broker Address：public-mqtt.nuwarobotics.com
TCP Port：1883
TLS Port：8883
WebSocket Port：80
WebSocket Port over TLS：443
WebSocket URI：/mqtt
Topic Prefix：Username/, e.g. Username is kebbi, topic should be: kebbi/ YOUR_TOPIC_NAME
Message Retention：YES
Persistent Session：YES
Sign Up Requred：YES
API 管理
管理常用的 API 名單，讓您輕鬆快速地完成 API 模組設定。在專案中加入「API 模組」前，請先在此建立 API 資料，方能使用。
如何新增 API
點擊頁面右上方「＋新增」按鈕，開啟 API 資料頁，填寫基本資料：
① API 名稱：必填，API 名稱不可重複，上限 90 字元
② API 網址 (URL)：必填，可選擇請求方式為 POST/GET
若請求方式為 POST，需填寫：
③ Header：選填，可新增一至多個 KEY
若請求方式為 GET，需填寫：
③ Header：選填，可新增一至多個 KEY
④ Params：選填，可新增一至多個 KEY
⑤ Timeout：超過此設定時間視為呼叫超時，將停止呼叫 API。可設定時間範圍為 30~999 秒
⑥ API 描述：選填，可輸入備註內容，上限 200 字元
⑦ 共用設定：可將 API 共用給你所屬裝置群組的其他成員，讓他們在資源庫中也能檢視/編輯
資源共用設定
檔案上傳至資源庫後，預設僅您個人（我自己，即資源創建者）可見，您可透過共用設定，將該資源共享給您所在群組的其他成員。
可共用的資源
媒體與工具、辨識模型、語音分流語料、對話模型、MQTT 伺服器、地圖、API
其中，地圖於下載時會自動共享給「原始建圖時有設定共用、且下載者為成員」的群組範圍。因隱私與資安考量，暫不允許針對「人員」設定共用。
共用設定｜於資源清單設定
- 以對話模型為例：
① 資源建立者：可以根據資源的建立者篩選檢視內容
② 共用狀態：可以根據資源的共用狀態篩選檢視內容
③ 共用設定：您必須是資源的建立者/上傳者，才能進行共用設定。若要多選資源來設定共用，所有資源的「共用狀態」必須需相同（例如，皆為「不共用」或皆為「共用：僅檢視」等）
④ 共用成員：可共享給您有加入的裝置群組
⑤ 成員權限：若開啟編輯權限，其他共用成員將可重新上傳（取代）或刪除此資源，請留意，這將影響也有使用此資源的其他專案
共用設定｜個別資源設定
身為資源創建者（上傳者），除了在「資源清單」中選取資源設定共用，您也能在「個別資源的編輯/詳情頁面」中進行設定。以對話模型為例，開啟對話模型編輯頁後，可見「共用設定」欄位。
① 共用成員：可共享給您有加入的裝置群組
② 其他成員權限：開放共享給其他群組後，右上角將顯示開關按鈕，可設定是否允許共享成員編輯此資源。請留意，若開啟編輯權限，其他共用成員將可重新上傳（取代）或刪除此資源，這將影響也有使用此資源的其他專案
資源共用規範
由於專案中可能使用了多個來自不同成員創建的資源，需留意這些資源的共用權限設定，將對專案共用範圍產生影響或限制。
- 為維護資源創建者的檔案所有權，專案的共用範圍，不可超過「專案內使用的資源」之共用範圍。例如：若某資源的創建者僅加入 A、B 群組，而另一個資源的創建者僅加入 B、C 群組，則包含這些資源的專案在共享時，將不能超出 B 群組範圍。
- 資源若隨專案共享，被共享者於專案中即可編輯資源 (替換專案中的資源，例如重新選擇其他圖片)與派發專案；若被共享者要將專案中的某些資源，在資源庫中進行取代/刪除，則需由資源創建者另外開放資源的編輯權限。
- 資源隨專案共享後，資源創建者仍可在「資源庫」變更該資源的共用設定 (如：關閉共用或關閉編輯權限)；若關閉編輯權限，則專案的共享成員仍可編輯專案中的該資源，但不可在資源庫取代/刪除該資源，此將可確保有使用此資源的其他專案不受影響。
專案共享
若您使⽤ PLUS 團隊版⽅案（搭配 NuwaTeam 團隊帳號），將可使⽤共享功能，和他⼈分享專案。
⽅式有：
- 共⽤設定：⽀援相同團隊成員分享專案
- 下載專案：⽀援不同團隊之間分享專案
若您尚未升級為 NuwaTeam 團隊帳號、想進⼀步瞭解或試⽤，請造訪本說明⾴，或洽詢我們的銷售團隊：biz.service@nuwarobotics.com。
共⽤設定
在「我的專案」頁面，點擊專案右下⾓「…」按鈕，點擊「共用設定」；選擇開放檢視權的團隊群組或成員後，點擊儲存，即完成共用設定。
專案共用與編輯
共用權限，分為三種設定層級：
- 群組共用｜僅檢視：勾選共用群組的成員可檢視專案，但不可編輯，請參考編號 ①
- 群組共用｜可編輯：勾選共用群組後，於選單右側可開啟編輯權限，請參考編號 ②
- 個人共用｜可編輯成員：若只想允許部分成員(使用者)編輯，請先開啟「該成員所在群組」的檢視權，方能指定成員，請參考編號 ①。於共用狀態選單，選擇「新增可編輯成員」，即可輸入該成員 email 來新增，請參考編號 ③
共用狀態選單，主要功能有三：
- 顯示共用設定狀態：新增可檢視群組後，若皆無開啟編輯權限，即顯示狀態「編輯權：關閉」，請參考編號 ②
- 新增可編輯成員：針對部分指定成員開放編輯權限，請參考編號 ③
- 關閉所有編輯權：一鍵關閉所有群組/使用者的編輯權限，請參考編號 ④
為什麼不能設定專案共用？
- 專案的共用範圍，不可超過「專案中使用資源」的共用範圍設定。詳見章節資源共用規範
- 若某成員只有在群組 A 內，只共用專案給群組 B\C 的情況下，無法為該成員開放編輯權限
下載專案
在「我的專案」頁面，點擊專案右下⾓「…」按鈕，點擊「下載專案」。若此專案中包含隱私資料，為避免外洩的潛在安全風險，將給予提示；你可取消勾選，從下載專案中移除資料。可能的隱私資料類型：
- ⼈員資料（含⼈臉照片、女媧通訊號碼，基於隱私政策不可匯出）
- 對話訓練室專案（若您在 AI 對話模組使用了對話訓練室專案語料，不可匯出）
- MQTT 伺服器（含伺服器位址、帳號、密碼、topic）
- API（含 API 名稱, URL, Header, Params）
- 變數結果儲存位置（含伺服器名稱, 位址, 連接埠, Header）
- 密碼（密碼模組，含密碼資訊）
為什麼不能下載專案？
⾸先，請確認電腦 / 網⾴端的網路連線狀態是否不穩或斷線；若網路正常連線，請參考以下可能原因與建議（若有些模組內容未填完或資源檔遺失，仍可下載專案，或先排除問題再下載）。
PLUS 團隊版⽅案到期
由於下載 / 上傳專案的功能，僅限團隊版⽅案（搭配 NuwaTeam 團隊帳號）使⽤。
因此若您的⽅案到期、且未續購，則無法使⽤此功能。若要下載專案，請重新升級⽅案。
