模型配置
模型配置
概述
Model Management（設定 → Global settings → Model Management）決定 Agent 可以使用哪些 LLM。頁面頂部的單選按鈕可切換兩種 Model Service 模式：
| 模式 | 金鑰由誰提供 | 適用場景 |
|---|---|---|
| Enterprise Key（預設） | 你的組織。模型由空間管理員統一管理，按組織積分計費 | 大多數企業使用者——無需任何配置 |
| Owner Key | 你自己。使用你自己的 API Key 和模型配置 | 個人金鑰、私有端點、組織未開通的供應商 |
Enterprise Key
Enterprise Key 模式下，頁面按供應商（如 OpenAI、Claude、Gemini）分組列出組織提供的 Available Models。每一行顯示：
| 列 | 說明 |
|---|---|
| 模型名 + 版本 ID | 顯示名稱及底層模型版本 |
| Input | 支援的輸入類型，以圖示表示：文字、圖片、文件、音訊、影片 |
| Output | 支援的輸出類型 |
此處不可編輯，列表跟隨組織配置。這些模型消耗的積分計入組織的月度配額（見設定 → Usage）。
Owner Key
把 Model Service 切換為 Owner Key 即可使用自己的 API Key。頁面分為左側供應商列表和右側該供應商的配置。
支援的供應商
OpenAI、Anthropic、Gemini、Grok、OpenRouter、DeepSeek、Moonshot、Qwen、Zhipu、MiniMax、Volcengine、StepFun 等。列表中每個供應商都有一個啟用開關。
配置項
| 專案 | 說明 |
|---|---|
| API Base URL | API 端點。已預填供應商預設地址；使用代理或相容的第三方端點時可修改 |
| API Key | 該供應商的金鑰（本地加密儲存，介面中隱藏顯示） |
| LLM Protocol | OpenAI Completions / OpenAI Responses / Anthropic Claude——端點使用的請求格式 |
| Coding Plan（部分供應商） | 開啟後使用供應商的編碼套餐專用端點 |
| Test Connection | 校驗 URL + Key；供應商標籤從 Unverified 變為已驗證 |
| Available Models | 該供應商暴露的模型，每個帶輸入 / 輸出能力圖示；+ Add Model 可手動新增模型版本 ID |
如何配置一個供應商
- 設定 → Model Management → 選擇 Owner Key
- 在左側列表點選供應商（如 Anthropic）
- 填寫 API Key（使用相容服務時同時修改 API Base URL）
- 選擇與端點匹配的 LLM Protocol
- 點選 Test Connection
- 開啟該供應商的開關——其模型即出現在輸入框下方的模型選擇器中
注意：Owner Key 憑證僅儲存在本地，不會上傳雲端。切勿把 API Key 分享給他人或提交到程式碼倉庫。
切換模型
當前模型顯示在 New task 頁輸入框下方，點選即可切換；下一條訊息使用新模型，已有對話歷史不受影響。
定時任務可以跟隨全域性模型，也可以固定使用某個模型（見 定時任務）。
模型能力
每個模型行上的輸入 / 輸出圖示表示該模型接受的內容：
| 能力 | 圖示含義 | 影響 |
|---|---|---|
| 文字 | 文件行圖示 | 始終支援 |
| 圖片 | 圖片圖示 | 圖片附件是否傳給模型 |
| 文件 | 檔案圖示 | PDF / Office 附件是否傳給模型 |
| 音訊 / 影片 | 音符 / 攝像機圖示 | 音訊或影片附件是否傳給模型 |
如果附件類型當前模型不支援，請切換到支援的模型。
上下文視窗與任務限制
可用上下文取決於模型視窗和 Task Control 設定（設定 → Task Control）：
| 設定 | 預設 | 說明 |
|---|---|---|
| Context Compaction Threshold | 128K | 上下文超過該 Token 數時自動摘要；取該值與模型視窗中的較小者 |
| Max Token Budget | 0（不限） | 累計輸入 Token 超過該值時停止任務 |
| Full Context Rounds | 3 | 保留最近 N 輪的完整工具呼叫 / 結果細節，更早的輪次只保留文字 |
| Max Loop Count | 100 | 單次執行的最大 Agent 輪次 |
| Max Error Count | 100 | 連續工具錯誤達到該次數後停止 |
完整模型列表請參考 支援的模型列表。
模型選擇建議
| 使用場景 | 建議 | 原因 |
|---|---|---|
| 日常對話、輕量任務 | 快速、低成本的模型 | 響應快、積分消耗低 |
| 複雜推理、長文件分析 | 視窗大、支援文件輸入的旗艦模型 | 推理強、可直接讀文件 |
| 程式碼開發與除錯 | 旗艦或程式碼專長模型 | 程式碼理解能力 |
| 需要圖片 / 影片理解 | Input 圖示包含圖片 / 影片的模型 | 多模態輸入 |
| 成本敏感 | 較小的模型 | 積分消耗最低 |
提示：拿不準時就用模型選擇器裡的組織預設模型——那是管理員按綜合表現選定的。
常見問題
API Key 無效（Owner Key）
- 確認 Key 複製正確（注意首尾空格）
- 確認 Key 屬於所選供應商，且 LLM Protocol 匹配
- 確認 Key 未過期或被吊銷；再次點選 Test Connection
請求超時
- 檢查網路連線
- 使用自訂 Base URL 時，確認地址可達
- 部分模型在高負載時響應較慢，可稍後重試
模型選擇器裡找不到某個模型
- Enterprise Key：請管理員為組織開通
- Owner Key：確認供應商開關已開啟；若未列出，用 + Add Model 新增