# Kilo

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

Language: zh-TW

> 在 Kilo 中透過自訂 OpenAI 相容 Provider 接入 aicentos

Kilo 支援自訂 Provider，可以把對話與 Agent 請求指向任意 OpenAI 相容端點。只需在設定裡新增一個 Custom Provider，填入 aicentos 的 Base URL 和 Key 即可。

## 準備工作

先在控制台「API Key」頁面為 Kilo 建立一個專用 Key（建議命名 `kilo`）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

## 需要填寫的設定

| 欄位                | 值                                    |
| ----------------- | ------------------------------------ |
| Provider ID / 名稱  | 自訂，例如 `aicentos`                     |
| API 類型            | OpenAI Compatible (Chat Completions) |
| Base URL          | `https://aicentos.com/v1`            |
| API Key           | 控制台建立的 Key                           |
| Model ID          | 控制台「模型廣場」中的模型名稱                      |
| Context Window    | 按所選模型填寫                              |
| Max Output Tokens | 按所選模型填寫                              |

## 設定步驟

* 開啟 Kilo 的設定面板（齒輪圖示）。
* 進入 **Providers**，拉到清單最底部，選擇 **Custom provider**（自訂 Provider）。
* Provider ID 和 Display name 隨意填，例如 `aicentos`。
* API 類型選擇 **OpenAI Compatible (Chat Completions)**。
* Base URL 填入 `https://aicentos.com/v1`。
* 填入在控制台建立的 API Key。
* 手動新增 Model ID，填寫控制台中的模型名稱。
* 儲存後，在模型選擇器中選中該 Provider 下的模型。

## 測試

儲存設定後新建一個任務，先用一句簡單提示詞輕量測試，確認能正常回傳內容再正式使用 Agent 模式。

## 注意事項

* 如果閘道不提供 `/v1/models` 清單介面，自動探測模型會失敗，手動填寫 Model ID 即可。
* Base URL 只填到 `https://aicentos.com/v1`，不要補成完整的 `/v1/chat/completions`。
* 自訂模型建議顯式設定 Context Window 與 Max Output Tokens；缺失會讓上下文長度按 0 處理，導致自動壓縮失效、對話無限增長。
* 官方文件：[https://kilo.ai/docs/ai-providers/openai-compatible](https://kilo.ai/docs/ai-providers/openai-compatible)
* 更多說明見文件站：[https://docs.aicentos.com](https://docs.aicentos.com)