# 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 |

## 方法 1: Felo Skill をインストールする

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

インストールされるのは Skill のみで、Pi のモデルプロバイダーは変更されません。Pi のセッションを新規に開始し、`feloapi` Skill を使うよう指示してください。たとえば「feloapi skill を使って今日の AI ニュースを Web 検索し、要約してください」。

## 方法 2: 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 とモデル設定ファイルはそのディレクトリ配下に置かれます。

## 動作確認

```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 のセッションを新規に開始してください。Skills は起動時に検出されます。 |
| Skill から Felo を呼び出すときに認証に失敗する | キーを作成して `feloapi auth login` を実行してください（または `FELO_API_KEY` を export します）。 |
| Felo モデルが応答しない | 上記の手動プロバイダー設定を確認してください。Base URL とキーが一致している必要があります。 |

## 関連リンク

- [FeloAPI CLI ガイド](https://openapi.felo.ai/ja/docs/cli.md)
- [モデルと料金](https://openapi.felo.ai/ja/docs/guides/models-and-pricing.md)
- [その他の AI ツール](https://openapi.felo.ai/ja/docs/agent-clients/other-tools.md)