FoloToy 角色設定技能

FoloToy 角色配置

安全地配置 FoloToy 角色，並在實體裝置上驗證結果。

在進行 API 呼叫前，請先閱讀 references/api-workflow.md。當使用者需要協助設計角色個性或開場白時，請閱讀 references/examples.md。

支援的任務

• 使用電話號碼與一次性簡訊驗證碼登入。
• 檢查已授權的裝置是否已完成配對。
• 使用序號 (SN) 與配對金鑰配對未配對的裝置。
• 讀取當前裝置、啟用的角色與可用的語音模型。
• 變更角色個性、開場白與語音。
• 回讀已儲存的角色設定，並引導進行實體裝置測試。

請勿使用此技能來解除裝置配對、清除記憶、重置網路、刪除帳戶、購買服務，或操控使用者未擁有或未經明確授權管理的裝置。

安全模型

機密資訊用於識別帳戶或實體裝置。請確保它們不會出現在提示詞、原始碼檔案、螢幕截圖、URL、持久化日誌或最終報告中。

1. 僅在需要每個值時，才要求提供電話號碼、簡訊驗證碼、序號 (SN) 與配對金鑰。
2. 請勿回顯完整的電話號碼、簡訊驗證碼、配對金鑰或存取令牌。
3. 僅在當前任務期間保留存取令牌。建議使用記憶體變數或受保護的臨時會話，並在任務完成後將其清除。
4. 當裝置歸屬不明確，或裝置已與其他帳戶配對時，應停止操作。
5. 在執行更新請求前，顯示易於理解的差異對比 (diff)，並獲得明確確認。
6. 僅變更經批准的欄位。保留當前的模型 ID 與所有其他必要欄位。
7. 儲存角色設定後，必須進行回讀。僅有成功的寫入回應不足以作為驗證。

工作流程

1. 確認地區與同意

詢問使用者帳戶使用的是中國大陸服務還是國際服務：

• 中國大陸：https://webapp.folotoy.cn
• 國際：https://webapp.folotoy.com

說明此工作流程將發送一封簡訊，並變更實體裝置的配置。確認使用者擁有該裝置或已獲得管理授權。

2. 登入

要求提供包含國碼的電話號碼。使用 API 參考文件中記錄的請求發送驗證碼。

暫停並要求使用者提供六位數驗證碼。請勿猜測、從其他來源取得驗證碼，或在使用者提供前繼續流程。

登入並僅在本次任務期間保留返回的 Bearer Token。如果驗證失敗，請檢查國碼與驗證碼是否過期。請勿重複發送簡訊。

3. 定位目標裝置

要求提供裝置序號 (SN) 並檢查其配對狀態。

• 如果已與當前帳戶配對，則繼續。
• 如果未配對，要求提供配對金鑰並在獲得確認後進行配對。
• 如果已與其他帳戶配對，則停止並說明當前擁有者必須透過支援的產品流程解除配對。

讀取帳戶下的裝置列表，並透過序號 (SN) 精確識別目標裝置。切勿僅因為裝置顯示名稱看起來熟悉就進行選擇。

4. 設計前先行讀取

讀取裝置詳細資訊、線上狀態、產品 ID、啟用的角色以及完整的當前角色物件。取得該產品可用的文字轉語音 (TTS) 模型，並將 ID 映射為可讀的語音名稱。

詢問目標受眾、使用場景、個性、語氣、回應長度、行為規則、安全邊界與語音偏好。如果使用者只有粗略想法，請提出精簡的草稿，而非阻止流程。

5. 預覽變更

顯示以下精簡的預覽：

裝置：[遮罩後的序號 (SN) 與顯示名稱]
角色：[名稱]

個性：     目前 -> 提議
開場白：   目前 -> 提議
語音：     目前名稱 -> 提議名稱

未變更：語音轉文字 (STT) 模型、大型語言模型 (LLM)、記憶、網路、配對狀態及其他所有欄位

詢問：將此變更套用至列出的 FoloToy 裝置？

僅在獲得明確確認後繼續。

6. 安全套用

從服務返回的完整角色物件開始。僅合併經批准的個性、開場白與語音 ID。保留現有必要的值，例如 speech_to_text_id、language_model_id 以及所有其他產品特定的欄位。

將完整合併後的物件發送至角色更新端點。當服務預期接收完整配置時，請勿發送猜測或最小化的負載。

7. 驗證與測試

再次讀取角色列表，並將返回的 custom_ability、start_text 與 text_to_speech_id 與已批准的提案進行比對。將語音 ID 映射回其可讀名稱。

檢查裝置是否為線上狀態。請使用者開始新的對話並測試：

1. 開場白。
2. 一個正常的角色內場景。
3. 一個安全性或不確定性的邊界場景。

如果儲存的配置正確但行為未改變，請在變更更多欄位前，驗證啟用的角色並開始全新的對話。

8. 報告與清理

報告角色名稱、最終開場白、最終語音名稱、回讀狀態、實體測試狀態，以及一個建議的下一個迭代方向。遮罩裝置識別資訊並清除臨時授權資料。

故障處理

• 未收到簡訊：檢查國碼，等待重新發送計時器，並避免重複發送。
• 401 或 403 錯誤：將會話視為已過期，並重新登入。請勿重複使用舊的令牌。
• 配對被拒絕：驗證序號 (SN) 與配對金鑰；如果裝置屬於其他帳戶，停止操作。
• 找不到語音路由：使用產品的模型端點並指定 mod_type=tts；請勿依賴舊的 /v1/voices 路由。
• 內容審查錯誤（例如 10500）：縮短並簡化角色個性或開場白。在新草稿獲得批准前，保持當前配置不變。
• 已儲存但聽不到：驗證啟用的角色、裝置線上狀態，以及是否為全新開始的對話。

完成標準

僅在滿足以下所有條件時，任務才算完成：

• 目標裝置已獲得授權並透過序號 (SN) 解析。
• 沒有任何機密資訊被嵌入或未經遮罩地顯示。
• 使用者已明確批准顯示的差異對比。
• 僅有經批准的欄位被變更。
• API 回讀內容與提案一致。
• 使用者已收到一份實體測試腳本，即使裝置暫時離線。