# モデルとプロバイダー

## 概要

Neotaskは幅広いAIモデルプロバイダーをサポートしています。Anthropic、OpenAI、GoogleのクラウドホストモデルやOllamaやvLLM経由のローカルモデルを使用したり、OpenAI互換のAPIエンドポイントに接続することができます。

## サポートされているプロバイダー

### クラウドプロバイダー

| プロバイダー | モデル | 認証 |
|----------|--------|------|
| **Anthropic** | Claude Opus 4.6、Claude Sonnet 4.1、Claude Haiku 4.5 | APIキーまたはセットアップトークン |
| **OpenAI** | GPT-5.2、GPT-5.1、GPT-4 Turbo、GPT-4 | APIキー |
| **Google（Gemini）** | Gemini 3 Pro、Gemini 2 Flash、Gemini 1 Pro | APIキーまたはOAuth |
| **Together AI** | 様々なオープンウェイトモデル（Llama、Mixtralなど） | APIキー |
| **Moonshot（Kimi）** | Moonshot v1（32K、128Kコンテキスト） | APIキー |
| **OpenRouter** | 複数のプロバイダーから100以上のモデル | APIキー |
| **DeepSeek** | DeepSeek Chat、DeepSeek Coder | APIキー |
| **OpenCode Zen** | Claudeバリアント、カスタムチューンモデル | APIキー |

### ローカルモデルプロバイダー

| プロバイダー | 説明 |
|----------|-------------|
| **Ollama** | ローカルでオープンウェイトモデルを実行（Llama、Mistralなど） |
| **vLLM** | 高スループットのローカル推論サーバー |
| **LiteLLM** | 100以上のプロバイダー向けの統合プロキシ |

### カスタムプロバイダー

ベースURLとAPIキーを指定することで、OpenAI互換またはAnthropic互換の任意のAPIに接続できます。セルフホスト型推論サーバー、エンタープライズプロキシエンドポイント、サードパーティモデルAPIで動作します。

## モデル設定

### プライマリモデル
すべてのエージェントのデフォルトモデルを設定します。各エージェントは独自のプライマリモデルでこれを上書きできます。

### フォールバックチェーン
優先順位付きのフォールバックモデルリストを設定します。プライマリモデルが失敗した場合（レート制限、ダウンタイム、認証エラー）、Neotaskはチェーン内の次のモデルを自動的に試みます。

### 画像モデル
画像分析と生成のための個別のモデル設定。Claude Vision、GPT-4 Vision、DALL-E 3をサポートします。

### モデルエイリアス
長いモデル名のショートカットを作成します。例えば、`fast`を`anthropic/claude-haiku-4-5`にエイリアスして素早く参照できます。

### エージェントごとの上書き
各エージェントはグローバルデフォルトとは独立した独自のモデル設定を持てます。

### モデル許可リスト
エージェントが使用できるモデルを制限します。コスト管理やコンプライアンスに有効です。

## APIキー管理

### キーソース（優先順）
1. ライブオーバーライドキー（最高優先度）
2. カンマ区切りキーリスト（ローテーション）
3. プライマリキー
4. 番号付きキー（key_1、key_2など）

### 自動キーローテーション
レート制限に達した場合、Neotaskは次の利用可能なキーに自動的にローテーションします。レート制限以外の失敗はローテーションなしで即座にエラーを返します。

### プロバイダーごとの設定
各プロバイダーは独自のAPIキーセット、認証プロファイル、モデル固有の設定を持てます。

## プロバイダー認証方法

| 方法 | 説明 |
|--------|-------------|
| **APIキー** | 標準のベアラートークン認証 |
| **セットアップトークン** | インタラクティブな認証フロー（Anthropic） |
| **OAuth** | リフレッシュトークンによる委任認証（Google、GitHub Copilot） |
| **トークンペースト** | 専門的なプロバイダー向けの手動トークン入力 |

## モデル選択の優先順位

エージェントがLLM呼び出しを行う必要がある場合、モデルは次の順序で選択されます：

1. エージェントごとの上書き（設定されている場合）
2. グローバルデフォルトモデル
3. モデル許可リスト（設定されている場合、オプションを制限）
4. 最初の利用可能なモデル（フォールバック）

## プロバイダー固有のツール制限

特定のモデルやプロバイダーに対して利用可能なツールを制限できます。例えば、信頼度の低いモデルをファイル操作のみに制限し、Claudeには全ツールアクセスを与えることができます。