Настройка API кода зоопарка

Используйте настройки Zoo Code, совместимые с OpenAI, чтобы добавить TokenHub, а затем протестируйте задачу безопасного кодирования с помощью собственных инструментов.

Что такое Зоокод?

Zoo Code — это набор ИИ-кодирования для VS Code с настраиваемыми поставщиками, моделями, режимами и инструментами агентов.

В этой настройке Zoo Code используются элементы управления поставщика, совместимые с OpenAI. Модель должна возвращать собственные вызовы инструментов в стиле OpenAI для работы агента Zoo Code; обычного текстового чата недостаточно. Рабочие процессы агента Zoo Code требуют, чтобы модели возвращали структурированные вызовы инструментов в стиле OpenAI, а не инструкции инструментов, написанные в виде обычного текста помощника. Настройте корень API и точный идентификатор модели, сохраняйте консервативный контроль утверждения и проверяйте анализ только для чтения перед тестированием редактирования файлов или выполнения терминала.

Официальное руководство Zoo Code для первого поставщика описывает последовательность действий на экране приветствия: откройте Zoo Code на панели действий кода VS, выберите поставщика, введите ключ, выберите модель и завершите инициализацию. TokenHub не является официальной предустановкой, поэтому в этом руководстве используются текущие поля OpenAI Compatible без заявления о сторонней интеграции TokenHub.

Начните с экрана приветствия при первом запуске.

  1. Щелкните значок Zoo Code на панели активности VS Code.
  2. Выберите поставщика LLM на экране приветствия.
  3. Выберите OpenAI Compatible, а не вариант, требующий официальной учетной записи OpenAI.
  4. Заполните поля ниже значениями TokenHub и завершите инициализацию.

Запуск с механизма после первоначальной настройки

  1. Откройте боковую панель Zoo Code.
  2. Нажмите на шестеренку, чтобы открыть Settings.
  3. Выберите OpenAI Compatible из API Provider.
  4. Введите:
    • Base URL: https://us-api.tokenhub.com/v1
    • API Key: ваш TokenHub API ключ
    • Model ID: полный идентификатор из каталога моделей TokenHub
    • Context Window Size: устанавливает это только после подтверждения спецификации модели.
  5. Сохраните, а затем подтвердите, что нижний колонтитул задачи действительно использует этот профиль поставщика.

Текущий поставщик Zoo Code, совместимый с OpenAI, вызывает завершение чата. База URL должна остановиться на /v1; не вводите полный путь /chat/completions.

Проверьте поведение агента Zoo Code.

  1. Создайте задачу и спросите: «Объясните текущий файл, не изменяя его».
  2. Подтвердите /v1/chat/completions и идентификатор модели профиля в журналах TokenHub.
  3. Запросите одно небольшое редактирование файла, чтобы убедиться, что модель возвращает структурированный вызов инструмента.

В руководстве Zoo Code по выбору модели особое внимание уделяется следованию инструкциям, соблюдению формата и сохранению контекста на всех этапах работы с инструментом. Если модель отвечает на обычные вопросы, но не может редактировать файл, переключитесь на более мощную модель вызова инструментов вместо многократного изменения базы URL.

Устранение неполадок с фактическими полями поставщика

  • 404: подтвердите, что Base URL заканчивается на /v1 и еще не включает /chat/completions.
  • 401: вставьте ключ API еще раз и убедитесь, что текущая задача выбрала профиль TokenHub.
  • Ошибка модели: Model ID должен быть полным идентификатором, принятым TokenHub.
  • Чат работает, а инструменты — нет: модель может не подходить для агентской системы Zoo Code.
  • Сохраненные изменения используют старого поставщика: создайте новую задачу и еще раз проверьте поставщика/модель, указанную в ее нижнем колонтитуле.

Официальные ссылки

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы о поставщике API Zoo Code

Какого провайдера выбрать в Zoo Code?

Выберите «Совместимость с OpenAI», затем введите базовый URL-адрес TokenHub, ключ API и точный идентификатор модели.

Что, если модель может общаться в чате, но не может редактировать файлы?

Используйте модель, которая поддерживает вызовы собственных инструментов, совместимых с OpenAI, и убедитесь, что поставщик возвращает структурированные вызовы инструментов.

Должен ли базовый URL-адрес включать /chat/completions?

Нет. Введите корень API TokenHub, заканчивающийся на /v1, если только текущий пользовательский интерфейс Zoo Code явно не запрашивает другое значение.

Как безопасно протестировать Zoo Code?

Начните с тестового репозитория с объяснением, доступным только для чтения, подтвердите журнал запросов и только затем подтвердите запись файлов или команды терминала.

Почему метки настроек Zoo Code отличаются от данных в этом руководстве?

Версии расширения могут переименовывать элементы управления. Найдите поля поставщика, совместимого с OpenAI, базового URL-адреса, ключа API и идентификатора модели в текущем официальном пользовательском интерфейсе.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。