選模型之前，先問任務需要什麼：理解圖片、修改檔案、執行工具，還是整理文字。模型負責理解和產生內容，Agent 負責把這些能力接到工具與工作環境。 Codex、Claude Code 是 Agent 執行入口；模型需要在介面另外選擇。進一步的概念解釋見模型與 Agent。
- Agent.Space 模型使用可用方案或 Flex
- 自有模型 API把服務商連接到 Workspace
- Developer API在外部用戶端使用 Model API Key
圖中把兩條 Key 的方向分開：自有模型把外部服務接入 Workspace；Model API Key 把 Agent.Space 的模型服務提供給外部用戶端。相似的名字不代表相同憑證或相同帳單。
選擇可用的 Agent 與模型組合
在新對話裡選擇 Agent，再看模型選單提供哪些可用選項。能在目錄看到一個模型，不代表它能配合所有 Agent、接受所有附件。圖片輸入需要模型、Agent 和執行入口共同支援；不支援時介面會要求移除圖片或更換組合。
先用小任務檢查再投入長任務，例如：
請閱讀目前網頁檔案，列出三個最影響手機閱讀的問題。只分析，不修改；如果需要額外工具或材料，請先說明。
檢查回覆是否確實讀到了檔案、是否說明缺少的材料。要驗證圖片能力，就附一張相關截圖，要求指出截圖中一個可核對的細節。只收到流暢文字，不足以證明材料已被讀取。
既有 Session 的 Agent 類型不能隨意切換；需要換 Agent 時建立新對話，並說明目標、檔案路徑與已確認的決定。進階選項由目前 Agent 實際提供，不同 Agent 選單不一樣是正常的。具體迭代方法見把作品改好。
方案額度、Flex 和實際付款人
開啟「訂閱市場」查看目前方案、適用模型、剩餘額度和重設時間。多個時間視窗可以同時約束一個方案；某個視窗還有餘量，不代表所有視窗都可用。額度也不是固定的訊息條數，任務上下文、輸出和模型不同會改變消耗。
模型在適用方案內且額度可用時，優先使用方案；方案外或額度不足時，符合條件的呼叫可以使用 Flex 點數按量計費。Flex 頁面顯示餘額、來源和有效期；贈送點數與購買點數不一定具有相同用途，不能把餘額數字理解成永久有效或包含所有服務。
標準 Workspace 模型呼叫由 Workspace 擁有者的可用權益承擔，成員發起任務前應理解這個歸屬。本機 Agent 使用該電腦的登入與訂閱；接入自有模型則由外部服務商計費。獨享 Mac、對外 API 和模型呼叫也有各自的適用條件，不能由一個方案名稱推斷全包。
價格、模型範圍和供應情況會變化，以目前目錄與結算確認頁為準。比較方案時記錄這四項就夠了：我需要的模型、常用任務大小、可接受的重設等待、是否允許按量繼續。購買或變更前檢查生效日期和續費說明；停止續費與立即退款不是同一個動作。
把自己的模型接入 Workspace（BYOK）
這條路徑適合已持有外部模型服務商 API 位址與 Key 的擁有者。開啟「工作區設定」裡的「自有模型」，點「接入模型 API」。填寫服務名稱、介面位址和對應 Key，繼續選擇模型並儲存。
儲存前系統會逐個試跑，檢查模型能否呼叫工具，並在收到工具結果後繼續；介面或能力不匹配會顯示原因。只有偵測通過、適合目前 Agent 的模型才進入可選列表，按服務商分組顯示在前面。雲端電腦執行期間新增或修改後，按照頁面提示重新啟動才能使用新設定。
成功檢查分兩步：先確認模型偵測結果，再在新對話選中該服務商的模型完成一個小任務。成員可以使用這些模型，但不能讀取 Key；Key 加密儲存，不交給成員或 Agent。呼叫發給你填寫的服務商，由服務商向擁有者收費，不消耗 Agent.Space 方案額度或點數。
位址和 Key 必須屬於同一服務。不要把登入密碼或本機訂閱帳號當 API Key；也不要把 Key 貼到聊天訊息、公開網頁或專案檔案。模型沒出現時，先看相容性偵測和重新啟動提示，重複儲存無法修復不支援工具呼叫的介面。
用 Model API Key 連接外部用戶端
側邊欄「更多」中的「Model API Key」開啟 Developer API 頁面。這是從外部用戶端呼叫 Agent.Space 的入口，不是上面的 BYOK 表單，也不是用於讀寫 Workspace 檔案的萬用金鑰。
頁面會檢查使用資格：當期有效方案或點數訂閱，或者未過期的已購點數可以滿足資格；只有贈送點數不能解鎖 API。取得 API 資格與某次請求有足夠餘額、可用模型，是兩項檢查。 普通 Workspace 對話仍可依條件使用贈送點數。
按照「接入指南」選擇用戶端與可用模型，建立命名清楚的 Key，再複製頁面給出的完整設定到對應用戶端。例如名稱用 personal-laptop，另一個工具用獨立 Key，之後容易辨識用量和撤銷。位址、協定和模型識別碼以指南為準，不要從其他服務複製相似欄位混用。
Key 可設定花費上限及重設週期、允許模型和到期日期；限制作用於新請求。未選擇模型限制代表允許全部模型，日期留空代表不過期。查看或重新產生等敏感操作可能要求重新驗證身分。金鑰外洩時立即撤銷或重新產生，並更新用戶端設定。
完成一次小請求後，回到 API 頁面查看對應 Key 的請求紀錄和用量。用戶端有回覆，且這裡出現匹配紀錄，才說明它用了預期服務；用戶端也可能仍使用原來的設定。
用量異常時按照路徑排查
模型不可選，查 Agent 相容性、權益和模型狀態；任務因額度停止，查每個額度視窗與 Flex 有效餘額；API 被拒，另外查 API 資格、Key 是否到期、模型限制與花費上限。BYOK 失敗要查外部服務商的 Key、介面和帳單，本機任務失敗則查本機登入和訂閱。
求助時記錄發生時間、模型、Agent、所用路徑和錯誤文字。不要附完整金鑰。把「在哪裡執行、呼叫誰、由誰付款」說清楚，通常比反覆更換模型更快找到原因。