AI 工具設定
Pi
為 Pi 安裝 Felo Skill;也可以把 Felo 設成 Pi 的模型 provider。
使用本指南為 Pi 安裝 Felo Skill。Pi 保留自己的模型設定;Skill 可以搭配你目前使用的任何模型運作,你也可以選擇將 Felo 新增為供應商。
開始之前
- 一組 Felo API 金鑰:建立一組。
- 如果要使用 FeloAPI CLI,需要 Node.js 22 或更新版本。
- 已安裝 Pi。
本指南會設定什麼
| 項目 | 值 |
|---|---|
| 模型供應商 | 保持不變(沿用你現有的 Pi 模型) |
| Felo Skill 位置 | ~/.pi/agent/skills |
| 可選 Felo 模型所用協定 | OpenAI-compatible |
方式一:安裝 Felo Skill
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 供應商:
{
"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 檔案都會放在該目錄下。
驗證
feloapi doctor --agent pi報告中 pi 顯示 ok: true,就代表 Skill 狀態正常。
切回/移除 Felo
目前模型供應商沒有被更動,因此無需切回。如需移除 Skill:
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 和金鑰必須一致。 |