# Prime Agent

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

Language: zh-TW

> 在 Prime Agent 裡接入 aicentos —— 目前只能走 API-key provider，端點欄位官方未公開

Prime Agent 是 Prime Intellect 開源的終端機編碼代理（Rust 實作，MIT 授權），定位是「可自我改進的 RLM harness」。它支援用 API Key 接入外部模型，但**自訂 Base URL 的欄位官方沒有公開文件**，所以下面分「已確認可用」和「需要自己驗證」兩段寫。

## 準備工作

先在控制台為 Prime Agent 建一個專用 Key（建議命名 `prime-agent`）。

```bash
curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh
```

Windows：

```powershell
irm https://app.primeintellect.ai/prime-agent/install.ps1 | iex
```

## 需要填寫的設定

| 欄位       | 值                                 |
| -------- | --------------------------------- |
| 認證方式     | 首次啟動 `/login`，選 API-key provider  |
| API Key  | 控制台建立的 Key                        |
| Base URL | `https://aicentos.com/v1`（欄位名待確認） |
| 模型       | 控制台「模型廣場」中的模型名                    |

## 設定步驟

第一次啟動執行 `/login`，選擇用 API Key 而不是訂閱的 provider。這一步是官方文件明確寫了的路徑。

它已知的設定檔是 `models.json`，官方只公開了模型覆寫的寫法：

```json
{
  "providers": {
    "你的provider": {
      "modelOverrides": {
        "你的模型名": { "contextWindow": 128000 }
      }
    }
  }
}
```

`modelOverrides` 只改模型參數，**不是端點定義**。要換端點，需要在 `/login` 選到的 provider 裡找到端點欄位——官方儲存庫 README 沒有給出欄位名，建議先看啟動後產生的設定檔裡有哪些鍵，再照著填，不要憑猜。

## 測試

```bash
prime-agent
```

在工作階段裡發一句提示詞。若返回驗證錯誤，說明 provider 沒選對；若能返回但模型名不對，說明端點和模型是分開設定的，回去檢查 `models.json`。

## 注意事項

* **它不是安全沙箱**，以你的使用者權限執行模型產生的 Python 和命令，別在有生產憑證的機器上跑陌生任務。
* 預設帶遙測，`PRIME_AGENT_TELEMETRY=0` 可關閉。
* 企業網路需要自訂 CA 時用 `NODE_EXTRA_CA_CERTS`。
* 端點欄位官方未公開，屬於「需要自己摸索」的狀態。如果摸不通，改用欄位明確的 [Oh My Pi](https://docs.aicentos.com/zh-TW/clients/oh-my-pi) 或 [Gajae Code](https://docs.aicentos.com/zh-TW/clients/gajae-code)。

## 相關連結

* [prime-agent 儲存庫](https://github.com/PrimeIntellect-ai/prime-agent)