AI 工具设置
Pi
为 Pi 安装 Felo Skill;也可以把 Felo 配成 Pi 的模型 provider。
使用本指南为 Pi 安装 Felo Skill。Pi 保留自己的模型配置;Skill 可以配合你当前使用的任何模型工作,你也可以选择把 Felo 添加为 provider。
开始之前
- 一个 Felo API key:创建一个。
- 如果要使用 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 读取 provider 配置。把 Felo 添加为 OpenAI-compatible provider:
{
"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 时认证失败 | 新建一个 key,运行 feloapi auth login(或导出 FELO_API_KEY)。 |
| Felo 模型没有响应 | 检查上面的手动 provider 字段;Base URL 和 key 必须一致。 |