Warp
在 Warp 中接入 aicentos —— 透過自訂推理端點驅動 Warp Agent
最後更新於:
Warp 是終端機形態的 Agent 開發環境。它支援 Custom inference endpoint:只要對方實現了 OpenAI Chat Completions 介面,就能把 Warp Agent 的模型呼叫轉過去。把端點指向 aicentos,即可用自己帳號下的模型驅動 Warp 的 Agent。
準備工作
- 把 Warp 更新到包含自訂推理端點的版本(舊版只有 BYOK,不能改 Base URL)。
- 在 aicentos 控制台建立一個專用 Key(建議命名
warp-terminal)。 - 確認要用的模型支援 工具呼叫(function calling),Warp Agent 依賴它來讀寫檔案、執行命令。
需要填寫的設定
| 欄位 | 值 |
|---|---|
| Endpoint name | aicentos(自訂,用於在模型選擇器裡標識) |
| Endpoint URL | https://aicentos.com/v1 |
| API Key | 控制台建立的 Key |
| Model name | 控制台「模型廣場」中的模型 ID |
| Model alias | 可選,模型選擇器裡顯示的名字 |
設定步驟
- 開啟 Warp 設定,搜尋
inference endpoint,或進入 Settings → AI。 - 在 Custom inference 區域點擊 Add custom model / Add destination。
- 在彈出視窗中填寫 Endpoint name、Endpoint URL(
https://aicentos.com/v1)、API Key。 - 在 Model name 處填入模型 ID,點 Add model 新增更多;可另填 alias 方便識別。
- 儲存後,自訂模型會出現在 Warp 的模型選擇器中,標識為你的端點名稱。
測試
在 Warp 裡選中剛新增的模型,發一句簡單提問(例如「列出當前目錄的檔案並解釋專案結構」)確認能正常回應。自訂端點模型會顯示在 agent 模式、工具列與 ambient agent 的選擇器裡。
注意事項
- Endpoint URL 填 OpenAI 相容根路徑(能拼出
/v1/chat/completions),不要寫成完整的/v1/chat/completions。 - 端點必須能從公網存取:Warp 的請求經它的伺服器端轉發,
localhost、內網位址會被拒絕。aicentos.com是公網 HTTPS 位址,可直接使用。 - API Key 與端點資訊存在本地裝置的安全儲存中,Warp 伺服器端只在請求時即時使用、不做留存。
- 走自訂端點的請求不消耗 Warp 的 AI credits,費用由 aicentos 側按用量計費;但 Business / Enterprise 方案下本地區 Agent 執行仍會消耗平台 credits。
- 若報
400 invalid model format,說明你的閘道要求provider/model_id形式;以控制台給出的模型 ID 為準,必要時按該格式補前綴。 - 自訂端點目前無法單獨宣告上下文視窗,超長對話可能被提前壓縮。
- 官方文件:
https://docs.warp.dev/agent-platform/inference/custom-inference-endpoint/