モデル設定
通常会話は選択したプロバイダー/モデルを使います。順序付きフォールバックと別の画像、動画、音声経路を設定できます。このガイドはv0.1.107向けです。
設定方法を選ぶ
| 目的 | 操作方法 |
|---|---|
| プロバイダーとメイン | anyy setup model |
| 経路の表示・編集 | Dashboard → Models |
| フォールバック | anyy setup model fallbackかDashboard → Models |
| パスと認証参照状態 | anyy config |
| 現在会話の切替 | Chatモデル選択かTUI /model |
次から始めます。
anyy setup model
経路にはプロバイダー、対応エンドポイント/プロトコル、認証、そこで受け付ける正確なモデルIDが必要です。ウィザードは可能なら検出し、手動入力と書き込み前確認も提供します。DashboardのTest connectionは保存前/保存済み設定でカタログ接続とモデル掲載を検査し、会話生成は送りません。
保存後に新Chatを開き、意図した対象を選んでいるか確認し、「Readyと答えて」など短い依頼で実返信を確認します。この検査ではフォールバックを一時無効化し、後で元に戻します。有効のままなら、実際の生成元が対象でフォールバック未使用と確認してから動作と見なします。選択モデルと返信成功だけでも、カタログ、ログイン、設定状態だけでも、生成対象は確定できません。
対応プロトコル
現在の5会話系統はopenai-compatible、openai-responses、codex-responses、anthropic-messages、google-geminiです。共通動作は固定Pi v1.2.0に従います。
Azure OpenAI Responses、Bedrock Converse、Google Vertex、Mistral Conversations、pi-messagesの独立ネイティブ実装はありません。カタログ項目、ブランド、互換Base URLは別のネイティブAPI対応の証拠ではありません。全境界、型、再試行はプロバイダープロトコルとモデルインターフェースを参照してください。
ローカルプロバイダー
設定前にOllama/LM Studioを起動し、1モデル以上入れます。OllamaはOpenAIエンドポイントのopenai-compatibleと既定Base URL http://127.0.0.1:11434/v1を使います。/api/tagsはカタログ検出で別推論プロトコルではありません。Cloudはhttps://ollama.com/v1です。ローカル既定は認証なしで、保護先では対応APIキーを使えます。
旧api_mode: ollama、ollama.local.native、ollama.cloud.nativeは拒否します。再設定でOpenAIを選ぶか、openai-compatible、サービスの/v1 Base URL、ollama.local.openai/ollama.cloud.openaiへ明示移行します。黙って書き換えません。
互換エンドポイント
該当プロトコルを実装するサービスだけにOpenAI/Anthropic互換を使い、必要APIルートと正確IDを入力します。能力メタデータはモデルと合う必要があり、手動入力は未知モデルに画像、ツール、thinking能力を与えません。
要求に必要なプロンプト、文脈、添付、ツール結果を受け取る場合があります。プライバシー、保持、アカウント、料金を確認してください。
メインモデルと認証情報
設定後に確認します。
anyy config
anyy status
anyy configは非シークレット設定、パス、参照健全性を表示します。管理キーは<ProfileHome>/secrets/にモード0600で保存し、設定は参照を持ちます。env:MY_MODEL_KEYなどは常駐Gatewayがその変数を継承する場合だけ動きます。
Dashboard → Modelsはキーの入力、置換、消去と、選択エンドポイントのサブスクリプション操作を提供します。CodexはChatGPTのデバイスログイン、Claude Codeの選択は外部取得セットアップトークンを使い、汎用OAuthではありません。禁止カタログ選択は使えないままです。ログイン/検出成功でも全モデルやアカウントの動作は証明しません。
対応認証の再接続/切断は同じModels/setupを使います。プロンプト、履歴、スクリーンショット、報告にはシークレットを出しません。
フォールバック経路
メインが動いた後に設定します。
anyy setup model fallback
独立対象を優先順に追加します。Dashboardで各項目の有効状態、allow_reasoning_drop、allow_context_drop、max_attemptsを設定できます。検証は新会話でその対象を明示選択し、上の無効化/未使用確認を適用して短い依頼を送ります。カタログだけでは不十分です。
条件付きの可用性ルーティングで、分類したエラーと、ツール/メディア、推論履歴、コンテキストサイズの互換性を確認します。全モデル実行や回答統合はしません。小さい文脈を許可しても自動で収まるとは限りません。耐障害性には独立した宛先と認証を使います。
試行上限とSession自動再試行は別です。再試行、フォールバック、仮想ルーティングを参照してください。
現在セッションを変える
メイン保存は新セッションの既定を設定します。既存は対象とthinkingを保持する場合があります。Dashboard ChatかTUIで明示変更します。
/model
/provider
/effort
新しい会話には/newです。モデル/thinking変更はキャッシュ再利用を減らして費用を増やす場合があります。
Thinkingの既定値
名前付きレベルはoff、minimal、low、medium、high、xhigh、maxです。対応選択を表示し、モデルの対応付けへ収めます。offをサポートしないモデルは別レベルに解決される場合があります。非推論モデルはoffで選択画面がありません。
| 操作 | モデル範囲へ収める前の優先順 |
|---|---|
| 新セッション | モデル別 → 全体 → medium |
| モデル切替 | 対象モデル別 → 全体 → 現在セッションthinking → medium |
| メッセージありの分岐再開 | 保存分岐thinking。なければ全体 → medium |
| メッセージなしの分岐再開 | 初期モデル既定とモデル別 → 全体 → medium |
メッセージ再開では保存モデル/thinkingが後の設定より優先します。作業中は変えません。復元でモデル要求は送らず、未選択モデルの初期thinkingはoffです。
inference.levelは要求好みを保持し、読み取り専用inference.effective_levelは収めた結果を示します。全体プレビューはモデル別上書きなしのメインを使うため、新セッションと異なる場合があります。触っていないDashboard effortの保存では、派生値を好みとして書きません。
TUI /effortのEnterはセッションに適用し、保存モデルを保ちながら要求全体好みを保存します。Alt+SはSessionだけです。モデル別設定は書きません。YAMLと廃止設定はThinking設定と移行を参照してください。
Thinking履歴
OpenAI互換Chatは、カタログが推論対応としなくても、空でないネイティブreasoning_content、reasoning、reasoning_textを保持します。構造化reasoning_detailsは不透明履歴のままです。同対象の継続は一致ネイティブフィールドを復元し、対象変更はプロトコルの履歴変換規則に従います。隠れたthinkingを回答へコピーしたり、再生用の架空スイッチを作ったりしません。
補助経路
Dashboard → Modelsは画像理解、動画理解、画像生成、TTS、STTをまとめます。ネイティブ画像/動画には能力宣言モデル、summary_firstには専用経路が必要です。音声には独自のプロトコル/認証があり、テキストモデルだけで自動有効になりません。
製品の画像生成は対応OpenAI Responses経路です。Codemodeのmodels.generateImages()は別の型付き操作で、一方を設定しても他方は設定されません。画像生成と音声機能を参照してください。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| 認証エラー | アカウント、キー/ログイン、認証領域、常駐環境 |
| モデルがない | 検出更新か正確IDの入力 |
| ローカル接続拒否 | サーバー起動とAPIルート |
| フォールバックが効かない | 個別テスト、有効状態、順序、互換性 |
| 古いチャットがモデル保持 | 切替か/new |
| 費用/遅延が想定外 | モデル、thinking、再試行、試行数、メディア経路 |
画面操作はDashboard Modelsを参照してください。