# Warp

來源: https://docs.aicentos.com/zh-TW/clients/warp

Language: zh-TW

> 在 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/`