# Pi

為 Pi 安裝 Felo Skill；也可以把 Felo 設成 Pi 的模型 provider。

使用本指南為 Pi 安裝 Felo Skill。Pi 保留自己的模型設定；Skill 可以搭配你目前使用的任何模型運作，你也可以選擇將 Felo 新增為供應商。

## 開始之前

- 一組 Felo API 金鑰：[建立一組](https://openapi.felo.ai/console/api-keys)。
- 如果要使用 FeloAPI CLI，需要 [Node.js 22 或更新版本](https://nodejs.org/en/download)。
- 已安裝 Pi。

## 本指南會設定什麼

| 項目 | 值 |
| --- | --- |
| 模型供應商 | 保持不變（沿用你現有的 Pi 模型） |
| Felo Skill 位置 | `~/.pi/agent/skills` |
| 可選 Felo 模型所用協定 | OpenAI-compatible |

## 方式一：安裝 Felo Skill

```bash
npm install -g feloapi-cli@latest
feloapi setup --agent pi --skills-only --yes
```

這裡只會安裝 Skill，不會修改 Pi 的模型供應商。開一個新的 Pi 工作階段，然後請它使用 `feloapi` Skill，例如：「用 feloapi skill 搜尋今天的 AI 新聞並總結一下。」

## 方式二：使用 Felo 模型（手動，可選）

Pi 會從 `~/.pi/agent/models.json` 讀取供應商設定。將 Felo 新增為 OpenAI-compatible 供應商：

```json
{
  "providers": {
    "feloapi": {
      "name": "Felo API",
      "baseUrl": "https://openapi.felo.ai/api/v1",
      "api": "openai-completions",
      "apiKey": "$FELO_API_KEY",
      "models": [
        { "id": "MODEL_ID", "name": "Felo model", "contextWindow": 128000, "maxTokens": 8192, "input": ["text"] }
      ]
    }
  }
}
```

在環境變數中設定 `FELO_API_KEY`，然後用 `pi --provider feloapi --model MODEL_ID` 啟動 Pi。如果設定了 `PI_CODING_AGENT_DIR`，Skill 和 models 檔案都會放在該目錄下。

## 驗證

```bash
feloapi doctor --agent pi
```

報告中 `pi` 顯示 `ok: true`，就代表 Skill 狀態正常。

## 切回／移除 Felo

目前模型供應商沒有被更動，因此無需切回。如需移除 Skill：

```bash
feloapi disconnect pi --yes
```

## 疑難排解

| 問題 | 處理方式 |
| --- | --- |
| `feloapi: command not found` | 重新開啟終端機再試；或執行 `npm install -g feloapi-cli@latest` 重新安裝。 |
| Skill 沒有被使用 | 開一個新的 Pi 工作階段；Skill 只在啟動時才會被辨識。 |
| Skill 呼叫 Felo 時驗證失敗 | 建立新的金鑰，執行 `feloapi auth login`（或匯出 `FELO_API_KEY`）。 |
| Felo 模型沒有回應 | 檢查上方的手動供應商欄位；Base URL 和金鑰必須一致。 |

## 相關

- [FeloAPI CLI 指南](https://openapi.felo.ai/zh-TW/docs/cli.md)
- [模型與價格](https://openapi.felo.ai/zh-TW/docs/guides/models-and-pricing.md)
- [其他 AI 工具](https://openapi.felo.ai/zh-TW/docs/agent-clients/other-tools.md)