本資料夾裡的其他指南，各自聚焦在一件你會製作的東西：一段對話流程、一個角色、它的知識、它的圖片與檔案。
這份指南則是把視野拉遠。它是整個環境的地圖：所有東西放在哪裡、如何把夥伴拉進團隊，還有——最實用的——為什麼有些按鈕有時候會是灰色的，以及該怎麼處理。
1. 一切都存在你的工作空間裡
你的工作空間是你自己的私人空間。有兩件事永遠成立：
- 它只屬於你。你建立的一切——角色、對話流程、上傳的檔案、分享連結、聊天紀錄——都收在你的工作空間裡，工作空間以外的任何人都看不到。任何東西都不會在不同工作空間之間外洩。
- 一位領導者，加上你的團隊。每個工作空間都有一位擁有者（基本上就是老闆），以及你想要的任意數量的夥伴，每個人都有一個角色，決定他們可以動哪些東西。
所以每當你想「我可以做這個嗎？」時，答案幾乎總是歸結到三件事：我的角色允許嗎？（第 3 節）、我的方案允許嗎？（第 4 節），以及我真的按了「發布」嗎？（第 5 節）。
2. 後台快速地圖
後台左側那排選單就是你的方向盤。它清楚地分成兩組—— 你建造的東西，以及讓工作空間運作的東西：
| 選單區域 | 用途 | 了解更多 |
|---|---|---|
| AI avatar（你的角色） | 製作並打扮你的角色——它的外觀、個性、聲音——然後發布 | 角色指南 |
| Storyboards（對話流程） | 一個場景接一個場景地規劃對話如何進行 | 對話流程指南 |
| 知識庫（知識庫） | 上傳你的角色可以閱讀並據以回答的文件——就像它書架上的書 | 知識指南 |
| 媒體（媒體） | 上傳你的角色可以拿出來展示的圖片、影片與 PDF | 媒體指南 |
| 團隊 | 邀請夥伴並指派角色給他們 | 第 3 節 |
| 訂閱（訂閱） | 你的方案、你已使用的量，以及帳單 | 第 4 節 |
| 整合（整合） | 你的分享連結與嵌入設定（嵌入＝把聊天直接放到你自己的網頁上，而不只是發出一條連結） | 第 5 節 |
| 設定（設定） | 整個工作空間範圍的選項 | 第 6 節 |
前四項（Agents → Storyboards → Knowledge → Media）是你的製作循環。本指南其餘部分涵蓋工作空間運作那一面——也就是決定你的製作循環被允許做什麼、能走到哪裡的那些環節。
3. 你的團隊——誰能做什麼
你的工作空間是一個團隊空間。每個人都是一位成員，擁有一個角色，而角色決定他們能做什麼。
用白話說明各個角色
| 角色 | 他們能做什麼 |
|---|---|
| Owner（擁有者） | 所有事情。唯一全權負責的人。無法被移除，也無法離開——交棒的唯一方式是進行正式的擁有權轉移。 |
| Admin（管理員） | 幾乎也是所有事情——全面掌管工作空間及其設定。 |
| Operator（操作員） | 日常的建置者：製作與編輯角色、對話流程、檔案與知識；執行聊天。但只能刪除自己建立的角色、對話流程與媒體。新夥伴都從這裡開始。 |
| Reseller（經銷商） | 給合作夥伴的、以檢視為主的角色。（不佔用付費席位。） |
小型團隊只需要其中兩種：Owner 掌控全局，Operator 負責建造。就這樣。
把個別項目分享給特定的人
多數時候，只要角色合適，任何人都能在工作空間裡處理任何東西。但有些項目——對話流程、角色與媒體資產——也可以鎖定給特定的人（知識庫檔案不行：它們一律與整個工作空間共用）。預設情況下它們對你整個團隊開放，但你可以把某項標記為「只有這些人能動它」。
邀請與管理夥伴
- 你可以移除某人、變更他們的角色，或讓他們離開——但有幾道符合常理的防護措施：你不能移除擁有者或你自己，而且擁有者這個角色只能透過那項正式的擁有權轉移來變動。
- 席位數量受你的方案限制。每位夥伴會佔用一個席位。如果你的席位滿了，再邀請一位就會被擋下，直到你升級為止（Reseller 不計入）。下一節會詳談。
4. 你的方案——你被允許做什麼
這一節能解答多數「為什麼我不能這樣做？」的時刻。你的方案附帶一組限制，而 Perxona 會在你嘗試動作的當下檢查它們——所以你會收到一則清楚的「你已達到上限」訊息，而不是某件事悄悄失敗。
三項限制（以及每一項究竟擋住什麼）
| 限制 | 它限制什麼 | 你會撞到什麼 |
|---|---|---|
| 團隊席位 | 工作空間裡能有多少人 | 無法邀請另一位夥伴 |
| 上線角色 | 你能擁有多少個已發布的角色 | 無法發布另一個角色 |
| 儲存空間 | 你上傳的知識＋媒體的總大小 | 無法上傳更多檔案 |
有幾件事值得知道：
- 發布一個全新的角色會用掉一個「上線角色」名額——重新發布同一個則不會。對一個已經上線的角色做調整，然後再次按下「發布」，你想按幾次都行；那是免費的。只有新的已發布角色才會佔用一個新名額。
- 用一個大小相近的檔案替換另一個檔案，通常即使在儲存空間幾乎滿了時也能成功，因為 Perxona 檢查的是替換後的大小，而不是替換前加替換後的大小。
聊天額度（每月會補充的那項）
除了那三項限制之外，執行聊天還會悄悄地從每月的額度池中扣用（可以把它想成手機方案裡的分鐘數——聊天時間和幕後工作都會耗用額度）。在後台預覽、試玩你的角色同樣會耗用額度——那和訪客在你網站上聊天一樣，是一次真正的對話。當你用完時，新的聊天會暫停，直到下個月補充，這時連後台的預覽都會開不起來——除非你的方案包含可繼續使用的隨用隨付安排。若你的方案另有約定，則以窗口說明的為主。
免費 vs. 付費，用日常的話來說
你所用的方案會改變完全相同的角色被允許做什麼：
| 免費方案 | 付費方案 | |
|---|---|---|
| 夥伴 | 只有你 | 幾位 |
| 上線（已發布）角色 | 1 | 一樣是 1 |
| 上傳空間 | 小（幾 MB） | 大約大 10 倍 |
| 嵌入到你自己的網站 | 可以 | 可以 |
| 每月聊天額度 | 一點點 | 較多 |
5. 分享——把你的角色帶到世界上
整合 區域就是你的角色不再只是後台裡的一個東西、而成為真實的人可以與之聊天的對象之處——在網頁上、在 App 裡，到處都行。
這裡的主角是分享金鑰（你會看到它們被稱為部署金鑰）。一把分享金鑰就像一張後台通行證，讓你的角色出現在某個特定的地方。
- 一把分享金鑰屬於你的整個工作空間，而你把它附掛到它應該放行的角色上。每個角色每種去處一把金鑰——網站一把、App 一把。
- 每把金鑰都綁定到一個特定的地方：
- 一把網站金鑰只在你指定的一個網站位址上有效（每個位址一把金鑰——你不能用萬用字元來涵蓋許多位址）。
- 還有給 App 用的金鑰，以及給更進階設定用的金鑰——多數建置者不會需要那些。
有兩件事要記住：
- 只有已發布的角色才能真正透過金鑰被連到。如果你分享了一條連結卻是空白的，請檢查你是否按了「發布」。
Connect API 金鑰（給開發者）
上面的分享金鑰是把角色放到某個頁面上。Connect API 金鑰則是另一回事：它讓你自己的應用程式或伺服器能與 Perxona 連線，而不必把帳號密碼寫進伺服器設定。你可以在整合 → Connect API 金鑰找到它們。各金鑰的權限、選擇性的網域限制與有效期限都是獨立設定，也可以單獨撤銷，不影響其他整合。
按下建立金鑰時，你要決定：
- 金鑰類型——Publishable key（可安全公開部署於網頁、行動與桌面應用程式及公開原始碼）或 Secret key（僅限您自有的後端服務——切勿置於用戶端或公開原始碼中）。類型於建立時決定且無法變更；如需調整，請撤銷後重新建立。
- 網域限制——設定後僅接受來自指定網域的請求，金鑰縱使外流也無法於他處使用。請填純網域名稱，例如
example.com或*.example.com（不要包含http://、連接埠或路徑）。這項同樣於建立時決定。Publishable 金鑰部署到用戶端後就能被檢視，所以請指定正式服務網域——沒有設定的話，任何取得金鑰的人都能從任意來源發出請求，產生的用量費用會計入你的組織。 - 有效期限——選一個有效期，或選永不過期（之後不再使用時，請記得自己手動撤銷）。
兩種類型各自可以做什麼：
| 權限 | Publishable | Secret |
|---|---|---|
| 讀取 Avatar、Motion 與 Scene | ✓ | ✓ |
| 讀取語音 | ✓ | ✓ |
| 生成 Avatar 演出腳本 | ✓ | ✓ |
| 生成語音合成憑證 | ✓ | ✓ |
| 上傳 VRM 模型 | — | ✓ |
| 與 Chatbot 對話 | — | ✓ |
| 管理 Chatbot | — | ✓ |
| View credit usage | — | ✓ |
你的應用程式要把金鑰放在 X-Connect-Key 標頭中送出。用金鑰發出的請求，會以建立該金鑰的人的身分執行，所以如果那個人被移出工作空間或停用，金鑰也會跟著失效。
6. 工作空間設定——以及那些你無法自己變更的東西
設定 區域有幾項整個工作空間範圍的選項。另外，對話紀錄達到保留期限後會被自動清除 —— 預設為最後一次活動起 365 天，逾期的紀錄是永久刪除，不是封存。
有一整層是刻意由 Perxona 團隊在管理
有些你可能會以為應該有開關的「智慧」行為，其實是由 Perxona 團隊替你管理的，而不是由你管理。你通常看得到它們，但在你這一側它們是唯讀的：
- 記憶——你的角色記得回訪的客戶，就像你常去那家店的咖啡師記得你都點什麼。它一直是開著的，但僅對你的網站有辨識身分的人生效：嵌入時必須帶上 customer ID。匿名訪客永遠不會被記住。
- 那些阻擋不安全或私密內容的安全規則。
不過，你確實能選擇由哪個 AI 大腦（模型）來驅動每個角色——你在故事板 設定的「選擇語言模型」中，從你的工作空間允許的清單挑選。所以這一項並不是完全與你無關。
7. 「為什麼我不能……？」——疑難排解表
把這張表放在手邊。十次裡有九次，一個變灰的按鈕都能追溯到以下其中一項：
| 「我不能……」 | 最可能的原因 | 該怎麼做 |
|---|---|---|
| ……發布另一個角色 | 你已達到上線角色上限 | 取消發布一個你沒在用的，或升級 |
| ……邀請一位夥伴 | 你已達到團隊席位上限 | 空出一個席位，或升級 |
| ……上傳一個檔案 | 你的儲存空間用完了 | 刪除你不需要的檔案，或升級 |
| ……再開始聊天，或在後台預覽 | 你已用完這個月的聊天額度 | 等待每月補充，或升級／加上隨用隨付 |
| ……開啟或編輯某個對話流程／角色 | 你的角色不允許，或它被鎖定給特定的人 | 請擁有者或管理員給你存取權限 |
| ……找到記憶或安全規則的開關 | 你這一側沒有這個開關 —— 記憶一直開著，安全規則一律套用 | 記憶：確認你的嵌入程式碼有帶 customer ID；安全規則不需要你做任何事 |
| ……選擇我的角色用哪個 AI 大腦 | 你在 故事板 上設定這個——你從工作空間允許的 AI 大腦中挑選 | 打開該角色的 storyboard，從清單裡挑一個模型 |
| ……看到我的編輯上線 | 多數變更都需要重新發布 | 再次按下發布 |
8. 整份指南濃縮在一頁
- 一切都存在你的私人工作空間裡——你的角色、流程、知識、檔案與分享連結都只屬於你，其他人看不到。
- 後台＝一個建造面（Agents · Storyboards · Knowledge · Media）＋一個工作空間面 （Members · Subscription · Integration · Settings）。
- 誰：一位Owner 加上帶有角色的夥伴——Operator 建造，Owner／Admin 管理事務。個別的流程與角色可以被鎖定給特定的人。
- 你被允許什麼：你的方案設定三項限制——團隊席位、上線角色、儲存空間——在你動作的當下檢查，並給出清楚訊息。免費方案＝儲存空間小、1 個角色、只有你；網站嵌入免費方案也能用。聊天額度每月補充，後台預覽同樣會耗用。
- 分享：整合 區域存放你的分享金鑰；只有已發布的角色能被連到。最輕鬆的途徑是角色本身的 Share 按鈕——請參閱角色指南。
- 幕後：記憶一直是開著的（需要你的網站傳 customer ID），安全規則一律套用——兩者都不是你撥動的開關。（不過你確實會在 storyboard 上挑選 AI 大腦。）你其他的開關則位於角色及其對話流程上。
- 當某個按鈕卡住時，幾乎總是你的角色、某項方案限制，或忘了發布—— 先檢查這三項。