1. 快速上手
Perxona 後台能做什麼？
後台就是您的控制中心，您可以：
- 管理 AI avatar
- 設定角色與聲音
- 上傳文件
- 查看使用狀況
- 管理帳單與聯繫客服
如何建立 AI avatar？
從 AI avatar 頁面開始，有兩種方式：
- 對話式打造 — 點選「打造你的 AI avatar」卡片，透過引導式對話描述角色與目標、挑選 1–4 種支援語言，並可選擇附加知識（上傳最多 10 個檔案，或擷取最多 30 個網頁）。確認後系統會自動生成角色設定與一份入門故事板。
- 使用模板快速上手 — 從模板列表挑一張卡片，在「選擇模板」對話框中預覽後按「套用」，即可獲得一組可自由編輯的現成 avatar 與故事板。
2. 故事板編輯
面板要怎麼新增與連接？
故事板是由一連串面板組成的，每個面板代表對話的一個階段。
- 新增：從左側的面板側欄，把「空白面板」拖曳到畫布上。
- 連接：在面板之間拉線，決定對話可以怎麼流動。
- 未連接的面板會顯示「未啟用」，並提示「此面板連接至其他面板後將自動啟用」— 也就是說，沒接上線的面板不會生效。
- 點選面板即可在右側編輯它的目標與範圍與指令；面板上的小標記會顯示掛了幾個函數、知識庫檔案、媒體與問卷。
面板該怎麼切分、目標怎麼寫，完整方法請見故事板手冊。
「全域設定」面板是什麼？
每個故事板的入口面板會顯示為全域設定。這裡放的是整個故事板共用的指令，以及「用戶端顯示內容」下的所有設定：免責聲明、建議提問、後續提問與隱私權彈窗開關。在這裡設定的內容會套用到整段對話，而不是單一面板。
動作怎麼運作？橘色驚嘆號是什麼意思？
從動作片段側欄把動作組拖曳到面板上。每組動作都有「觸發時機」設定：
- 運作狀態 — 在 avatar 的特定狀態播放：閒置中、回應中、正在聆聽、讀取中。
- 意圖：來自提示語 — 用一小段提示語描述何時該播放，由 LLM 判斷。
- 匹配：指定語句 — 當指定語句被匹配到時播放。
動作上的橘色驚嘆號表示：「此動作片段中的部分動作不適用於所選的 AI avatar」。原因是動作的骨架與目前的 avatar 模型不相容，這些動作會在對話時被系統自動過濾、不會播放；其餘動作與實際發布都不受影響，不需要另外編輯動作組。
知識庫和媒體怎麼加進故事板？如何解除連結？
從知識庫或媒體側欄把檔案拖曳到面板上即可。
- 知識庫：已連結的檔案會以圓形標籤顯示在面板編輯器的「知識庫（n）」區塊。要解除連結，點檔案上的減號（−）按鈕即可 — 檔案仍保留在檔案庫，只是移除連結。整個故事板共用的知識庫則在故事板設定的「全域知識庫」分頁管理。
- 媒體：拖入媒體檔後會出現「意圖描述」欄位 — 用一小段文字（最多 64 字元）告訴 avatar 什麼時候該展示這個檔案。若留空，avatar 就沒有展示它的依據。
- 媒體全域設定（媒體區塊的齒輪圖示）：開啟「僅顯示最相關媒體項目」後，若有多個媒體符合意圖，系統僅會採用最相關的一個，此設定套用至整個故事板。
如何加入函數（工具）？
打開函數側欄，按「+ 函數」建立，再拖曳到面板上。函數呼叫的是外部 API 端點；對話框沒有型別可選。外部 API 端點呼叫的是您在「管理 → 整合 → 外部服務」註冊的主機。編輯函數時，變更會自動套用至所有使用此函數的面板。Schema 撰寫技巧請見工具手冊。
如何切換故事板？故事板設定裡有什麼？
在故事板工具列上，點故事板名稱可直接改名，點箭頭圖示則打開切換選單（可搜尋、排序，「+」可建立空白故事板）。每個項目的「⋮」選單提供設定、複製與刪除（目前使用中的故事板無法刪除）。
設定包含：故事板名稱、描述、圖示與封面顏色、選擇語言模型（LLM）、聊天模式（自由聊天或精準聊天）、AI avatar 啟動模式（由 AI avatar 或用戶主動啟動對話）與 greeting prompt（打招呼提示語，最多 1,000 字元），以及面板切換策略（透過目標或透過流程引導面板切換）。
3. Avatar 編輯與發布
Avatar 編輯器可以調整什麼？
把左側切換到 Avatar 模式，側欄有三個分頁：
- 角色 — avatar 模型、名稱、個性描述，以及聲音設定：挑選 1–4 種支援語言、為每種語言選一個聲音，並指定主要語言。
- 空間 — 背景場景。
- 主題 — widget 的外觀與行為：輸入模式（文字輸入或語音輸入）、拍攝角度與鏡頭視野、淺色/深色模式、對話框顏色、對話縮圖與尺寸、載入畫面。
預覽模式下拉選單可切換全螢幕、對話按鈕、內建三種顯示模式。
文字模式與語音模式有什麼差別？
在 Avatar 編輯器的主題分頁，用「輸入模式」設定預設模式（文字輸入或語音輸入），差別在於訪客打開 widget 時看到什麼：
- 文字輸入 — 顯示對話輸入框與建議提問，訪客用打字互動。這是預設值。
- 語音輸入 — 顯示按住說話的圓形按鈕與即時字幕，訪客用說的互動。
兩種模式訪客都可以隨時自行切換（語音畫面有回到鍵盤的按鈕，文字畫面有麥克風按鈕）。每則訊息都會記錄輸入方式，在對話紀錄中標示為「文字輸入」或「語音輸入」。
如何發布、分享與取消發布？
- 發布：讓訪客可以連到您的 avatar。若更新了「主題」相關設定，請重新發布（並更新網站上的嵌入程式碼）才會生效。
- 分享對話框分兩區：嵌入程式碼卡片 —— 點入後設定嵌入（若啟用行動部署，會出現網頁嵌入程式碼與行動部署兩個分頁）—— 以及分享區，可產生 live 連結與 QR Code 並分享到社群（產生連結會自動發布 avatar；更改 link key 後舊連結即失效）。
- 取消發布：點發布按鈕旁的「⋯」選單，選「取消發布」。取消發布後，此 AI avatar 將不會再出現在您的網站上。
4. 知識庫
檔案格式與容量限制是什麼？
- 支援格式：DOC / DOCX / CSV / TXT / PDF。
- 單次最多可上傳 20 個檔案。
- 儲存容量由知識庫與媒體共用，額度依方案而定（例如 Free 為 5 MB、Core 為 50 MB，企業方案可客製）。可在「訂閱」的「使用限制」分頁查看用量。
- 網站資料擷取時，每個擷取到的頁面都算一個檔案，會計入儲存容量。
檔案狀態代表什麼？各狀態下可以做什麼？
| 狀態 | 意義 | 可執行的動作 |
|---|---|---|
| 處理中… | 檔案正在建立索引 | 請稍候 — 完成前不會顯示操作按鈕 |
| 閒置 | 已就緒，尚未被任何故事板使用 | 編輯、下載、刪除 |
| 使用中 | 已連結至一或多個故事板 | 編輯、下載 — 無法刪除 |
| 錯誤 | 上傳或處理失敗 | 刪除後重新上傳 |
要刪除「使用中」的檔案，請先到各故事板解除連結（點狀態可查看「連結至」哪些故事板），再進行刪除。
可以為檔案加上描述嗎？
可以 — 上傳時或之後透過「編輯描述」加入（知識庫檔案最多 200 個字詞；系統以空白切分計算，因此中文幾乎不會觸及此上限）。描述是給自己看的備註，不會用在 avatar 檢索文件時；它的用途是讓你在檔案列表中更容易找到這個檔案。
5. 媒體
媒體的限制與規則是什麼？
- 支援格式：JPG / PNG / MP4 / PDF。
- 單次最多上傳 20 個項目；儲存容量與知識庫共用（同一個方案額度）。
- 狀態機制與知識庫相同；被故事板使用中的項目必須先解除連結才能刪除。
- 同樣支援描述欄位，有助於系統將媒體與對話內容匹配。
6. 對話紀錄
各欄位代表什麼？
| 欄位 | 意義 |
|---|---|
| 工作階段ID | 一次 widget 對話階段 |
| 裝置 | 訪客的裝置識別碼 |
| 客戶ID | 可指派的客戶編號（可直接在欄位中選擇） |
| Avatar 名稱 | 負責這段對話的 avatar |
| 最後更新 | 最近活動時間（可排序） |
| 對話次數 | 這段對話的訊息數 |
| 對話 | 訪客最近一則訊息 |
點「紀錄」按鈕可開啟完整對話內容；每則訊息會標示「文字輸入」或「語音輸入」。
搜尋邏輯是什麼？
- 文字搜尋框比對的是訊息內容 — 也就是訪客與 avatar 實際說過的話。
- 要以 avatar 篩選，請使用 AI avatar 下拉篩選器。篩選是以 avatar 本身（內部 ID）為準，因此結果會包含該 avatar 的所有對話紀錄 — 包括改名之前的紀錄；列表顯示的一律是 avatar 目前的名稱。
- 日期區間與裝置篩選可同時搭配使用。
可以下載原始資料嗎？
可以。按「匯出 CSV」並選擇日期區間（單次匯出最長 30 天），檔案準備完成後會自動下載（zip 壓縮的 CSV）。欄位包含：工作階段 ID、客戶 ID、agent ID 與名稱、發話者、輸入方式、訊息內容、附件與時間。
7. 個人資料與帳號
如何調整後台語言？
點右上角個人頭像 → 我的個人資料 → 設定分頁 → 預設語言偏好。提供英文、繁體中文與日文。
如何重設我的密碼？
登入後台後，您可以點擊右上角的個人頭像，選擇「我的個人資料」，並點選「重設密碼」即可進行修改。
如果我忘了密碼怎麼辦？
您可以在後台登入頁面點選「忘記密碼」，系統將引導您透過電子郵件驗證並完成密碼重設。
帳號無法登入怎麼辦？
請先檢查您的帳號密碼與網路連線是否正確。若仍無法登入，請聯繫客服團隊，我們會協助您解決。
8. 管理頁面 — 一般
「顯示名稱」和「工作空間 ID」有什麼不同？
- 顯示名稱 — 顯示在後台頁首與邀請郵件中的名稱，隨時可以修改，不影響任何網址。
- 工作空間 ID — 用在公開 live 連結網址中的識別碼（
…/{區域}/{工作空間 ID}/…）。它在開通工作區時設定一次，之後即無法更改 — 否則既有的 live 連結都會失效。
閒置時間設定是什麼？
在「管理 → 一般」中有兩個設定：
- 會話閒置時間（5–60 分鐘，預設 5）：訪客在對話中閒置超過此時間，系統會自動關閉該次會話。
- 故事板閒置時間（10–30 分鐘，預設 10）：編輯者閒置超過此時間會跳出確認對話框；若未回應，編輯權限會釋出，讓其他成員可以接手。
展示頁是什麼？
展示頁是一個托管頁面，會列出您已發布的 AI avatar。在「一般 → 功能開關 → 展示頁」開啟後，即可複製連結，並按「編輯」來挑選您欲展示的 AI avatar。只有已產生 live 連結的 avatar 才能展示；若重新開關此功能，請重新發布 AI avatar 以更新列表。
管理頁面的 Behavior AI 是什麼？可以關掉嗎？影響範圍是什麼？
Behavior AI 是一套多元的預訓練動作風格庫，讓 avatar 能依每句回應的情緒語氣挑選合適的動作。開關位於「一般 → 功能開關」。
- 開啟 — 動作建議會同時考量動作描述與 avatar 的個性（進階模式）。
- 關閉 — 動作仍會播放，但只依各動作組設定的觸發條件（基本模式）。
關閉它只影響動作的挑選方式 — 不會改變 avatar 回答的文字內容。
9. 管理頁面 — 訂閱
各方案有什麼差異？
- Free — 1 個管理席次、1 個已發布的 AI avatar、每月 20 credits、5 MB 文件與媒體容量、可分享 live 連結（不含網站嵌入）。
- Core — 14 天免費試用，之後每月 $25（年繳 $250）：每月 150 credits、50 MB 文件與媒體容量、可將 widget 部署到自己的網站。
- Enterprise — 客製 credits、容量、席次與導入服務，請按「與我們聊聊」聯絡銷售團隊。
1 credit 約等於 6 秒的對話時間；credits 每個計費週期重新計算。
免費試用會扣款嗎？
不會。試用期間完全免費，只有在試用結束後才會開始收費，您也可以隨時提前取消。
如何查看付款與購買紀錄？如何取得收據？
「管理 → 訂閱」有三個分頁：使用限制（席次、發布名額、知識庫用量與 credits）、付款（綁定的信用卡）、購買紀錄（發票）。取得收據的步驟：
- 到您的電子郵件收件匣查看購買後自動寄送的收據
- 在郵件中點擊 [View Order]
- 選擇 [Generate Receipt]
- 補充或更新帳單資訊後即可下載收據
如何取消訂閱？
在「當前方案」卡片上打開齒輪選單 → 「停止訂閱」。確認取消後，您的訂閱仍可使用至本期帳單週期結束日；期限前也可以隨時恢復訂閱。
如何加購 credits？怎麼查看使用量？
加購 credits 採每月「額度」制、依實際用量計費：在「使用限制」分頁的 Credits 列按「調整額度」，設定每月預算（每 credit 約 $0.095，上限為方案額度的 10 倍）。同一個分頁隨時可查看 credits、容量與席次的已用／可用數量。
10. 管理頁面 — 團隊
怎麼邀請同事加入工作區？
您可以在後台的「團隊」與「成員」區域，輸入同事的電子郵件邀請團隊成員。單次邀請最多可輸入 10 個 email；若席次已滿，系統會先提示您升級方案。新成員預設為 Operator 角色。
如何辨別成員狀態？
- 有效 — 成員已接受邀請，可正常登入。
- 待處理 — 已寄出邀請，尚未接受。
- 無效 — 邀請已過期或寄送失敗；可按「重新寄送郵件」。
成員有名額限制嗎？
有 — 使用者名額（席次）是方案的一部分（例如 Free 與 Core 各為 1 席，企業方案可增加）。「使用限制」分頁會顯示已用／可用席次。
角色與權限怎麼設定？
內建角色：Owner（完整控制權，每個工作區僅一位、不可轉派）、Admin（完整管理權）與 Operator（日常建置者：可編輯工作區中未在分享設定裡被限制的任何項目，但只能刪除自己建立的 AI avatar、故事板與媒體資產）。要調整成員角色，在「成員」分頁的角色下拉選單直接指派即可。
您也可以在「角色」分頁建立自訂角色：輸入角色名稱（最多 30 字元），逐項勾選「查看／編輯／刪除」權限（一般、整合管理、安全性管理、帳單資訊、知識、對話紀錄），並設定「可編輯範圍」— 所有 AI avatar 與故事板，或僅限成員自己的項目。
11. 管理頁面 — 整合
如何把 widget 部署到我的網站？
嵌入程式碼在每個 avatar 的「分享」對話框 → 「嵌入程式碼」卡片：
- 先在「部署存取控制」加入您網站的網域（行動 App 則填應用 ID（Bundle ID））— 這一步會建立部署金鑰。
- 複製三段程式碼：載入 Perxona SDK、放置
<sv-agent>元件，或直接使用完整範例頁。
「管理 → 整合 → 組件部署」列出工作區內所有已部署的金鑰。每個 avatar 最多可建立 3 把金鑰；刪除網域時金鑰也會一併刪除。
誰可以設定外部服務與 API 金鑰串接？
為確保資料安全，外部服務與 API 金鑰的設定僅限具有 Admin 或 Owner 權限的使用者，以及該 storyboard 的創建者。
外部服務、API 金鑰、數據規範分別是做什麼的？
- 外部服務 — 註冊故事板函數可以呼叫的 API 主機（端點＋Bearer Token／API Key／免驗證）。
- API 金鑰 — 組織層級的金鑰，供您的後端呼叫 Perxona 的資料 API（對話、訊息、客戶資料），以
X-Inbound-Key標頭傳送。請勿暴露在瀏覽器程式碼中；金鑰一旦撤銷即無法恢復。 - 數據規範 — 以 OpenAPI 標準格式描述您匯入 Perxona 的客戶資料結構，avatar 可在故事板中將其作為變數引用。
12. 隱私、資料與條款
AI avatar 會記得回訪的訪客嗎？
會，但有一個重要前提。你的角色可以跨對話記住事情，但僅限於你的網站有辨識身分的訪客：嵌入的程式碼必須帶上 customer ID（customerRefId）。若是匿名訪客則不會記住任何事，每次對話都是全新開始。
另外兩點值得知道：
- 學到的內容是在對話閒置結束後才寫入，而非對話進行中 —— 所以會在下一次對話才看得到效果，不是當下這次。
- 沒有開關可以關閉，avatar 層級與工作區設定都沒有。
這與對話紀錄是兩回事：對話紀錄不論有無識別身分都會保存每一次工作階段（見第 6 節）。
系統會保存我的對話紀錄嗎？
會。為了讓 AI avatar 更好理解您的使用情境並提供個人化服務，系統會保存您的對話紀錄。您也可以依需求調整資料保存時間與方式。
我的對話資料是如何儲存的？
所有對話資料都會加密並安全保存，您也可以在組織設定中自行管理資料儲存方式。
服務條款與隱私權政策在哪裡？
後台每個登入頁面底部都有連結：平台服務條款與隱私權政策。針對您網站上的 widget 使用者，可在「全域設定 → 用戶端顯示內容」啟用各故事板的免責聲明與隱私權彈窗。
SDK 文件在哪裡？
側欄的「SDK 文件」會開啟開發者文件入口（docs.perxona.ai），涵蓋 widget 屬性、session token 與資料 API。