Zoo コード API のセットアップ

Zoo Code の公式の最初のプロバイダー チュートリアルでは、ようこそ画面のフローについて説明しています。VS Code アクティビティ バーから Zoo Code を開き、プロバイダーを選択し、キーを入力し、モデルを選択し、初期化を終了します。 TokenHub は公式のプリセットではないため、このガイドでは、ファーストパーティの TokenHub 統合を主張せずに、現在の OpenAI Compatible フィールドを使用します。

初回起動時にようこそ画面から開始する

1. VS Code アクティビティ バーの Zoo Code アイコンをクリックします。
2. ようこそ画面で LLM プロバイダーを選択します。
3. 公式 OpenAI アカウントを必要とするオプションではなく、OpenAI Compatible を選択してください。
4. 以下のフィールドに TokenHub 値を入力し、初期化を終了します。

初期設定後、ギアからスタート

1. Zoo Code サイドバーを開きます。
2. 歯車をクリックして Settings を開きます。
3. API Provider から OpenAI Compatible を選択します。
4. 次のように入力します。
   • Base URL: https://us-api.tokenhub.com/v1
   • API Key: あなたの TokenHub API キー
   • Model ID: TokenHub モデル カタログの完全な ID
   • Context Window Size: は機種仕様を確認してから設定してください
5. 保存して、タスク フッターが実際にこのプロバイダー プロファイルを使用していることを確認します。

Zoo Code の現在の OpenAI 互換プロバイダーは、Chat Completions を呼び出します。ベース URL は /v1 で停止する必要があります。完全な /chat/completions パスを入力しないでください。

Zoo Code エージェントの動作を確認する

1. タスクを作成し、「現在のファイルを変更せずに説明してください」と尋ねます。
2. TokenHub ログで /v1/chat/completions とプロファイルのモデル ID を確認します。
3. 1 つの小さなファイル編集を要求して、モデルが構造化ツール呼び出しを返すことを確認します。

Zoo Code のモデル選択ガイダンスでは、ツール ステップ全体での指示の遵守、形式の遵守、コンテキストの保持が強調されています。モデルが通常の質問には答えてもファイルを編集できない場合は、ベース URL を繰り返し変更するのではなく、より強力なツール呼び出しモデルに切り替えてください。

実際のプロバイダーフィールドのトラブルシューティングを行う

• 404: Base URL が /v1 で終了し、まだ /chat/completions を含んでいないことを確認します。
• 401: API キーを再度貼り付け、現在のタスクで TokenHub プロファイルが選択されていることを確認します。
• モデル エラー: Model ID は、TokenHub によって受け入れられる完全な ID である必要があります。
• チャットは機能しますが、ツールは機能しません。モデルが Zoo Code のエージェント ハーネスに適合していない可能性があります。
• 保存された変更では古いプロバイダーが使用されています。新しいタスクを作成し、そのフッターに表示されているプロバイダー/モデルを再確認してください。

公式リファレンス

• Zoo Code: 最初のプロバイダーに接続
• Zoo Code OpenAI 互換フィールド レポート
• Zoo Code リポジトリ