Что такое Зоокод?
Zoo Code — это набор ИИ-кодирования для VS Code с настраиваемыми поставщиками, моделями, режимами и инструментами агентов.
В этой настройке Zoo Code используются элементы управления поставщика, совместимые с OpenAI. Модель должна возвращать собственные вызовы инструментов в стиле OpenAI для работы агента Zoo Code; обычного текстового чата недостаточно. Рабочие процессы агента Zoo Code требуют, чтобы модели возвращали структурированные вызовы инструментов в стиле OpenAI, а не инструкции инструментов, написанные в виде обычного текста помощника. Настройте корень API и точный идентификатор модели, сохраняйте консервативный контроль утверждения и проверяйте анализ только для чтения перед тестированием редактирования файлов или выполнения терминала.
Официальное руководство Zoo Code для первого поставщика описывает последовательность действий на экране приветствия: откройте Zoo Code на панели действий кода VS, выберите поставщика, введите ключ, выберите модель и завершите инициализацию. TokenHub не является официальной предустановкой, поэтому в этом руководстве используются текущие поля OpenAI Compatible без заявления о сторонней интеграции TokenHub.
Начните с экрана приветствия при первом запуске.
- Щелкните значок Zoo Code на панели активности VS Code.
- Выберите поставщика LLM на экране приветствия.
- Выберите OpenAI Compatible, а не вариант, требующий официальной учетной записи OpenAI.
- Заполните поля ниже значениями TokenHub и завершите инициализацию.
Запуск с механизма после первоначальной настройки
- Откройте боковую панель Zoo Code.
- Нажмите на шестеренку, чтобы открыть Settings.
- Выберите OpenAI Compatible из API Provider.
- Введите:
- Base URL:
https://us-api.tokenhub.com/v1 - API Key: ваш TokenHub API ключ
- Model ID: полный идентификатор из каталога моделей TokenHub
- Context Window Size: устанавливает это только после подтверждения спецификации модели.
- Base URL:
- Сохраните, а затем подтвердите, что нижний колонтитул задачи действительно использует этот профиль поставщика.
Текущий поставщик Zoo Code, совместимый с OpenAI, вызывает завершение чата. База URL должна остановиться на /v1; не вводите полный путь /chat/completions.
Проверьте поведение агента Zoo Code.
- Создайте задачу и спросите: «Объясните текущий файл, не изменяя его».
- Подтвердите
/v1/chat/completionsи идентификатор модели профиля в журналах TokenHub. - Запросите одно небольшое редактирование файла, чтобы убедиться, что модель возвращает структурированный вызов инструмента.
В руководстве Zoo Code по выбору модели особое внимание уделяется следованию инструкциям, соблюдению формата и сохранению контекста на всех этапах работы с инструментом. Если модель отвечает на обычные вопросы, но не может редактировать файл, переключитесь на более мощную модель вызова инструментов вместо многократного изменения базы URL.
Устранение неполадок с фактическими полями поставщика
- 404: подтвердите, что Base URL заканчивается на
/v1и еще не включает/chat/completions. - 401: вставьте ключ API еще раз и убедитесь, что текущая задача выбрала профиль TokenHub.
- Ошибка модели: Model ID должен быть полным идентификатором, принятым TokenHub.
- Чат работает, а инструменты — нет: модель может не подходить для агентской системы Zoo Code.
- Сохраненные изменения используют старого поставщика: создайте новую задачу и еще раз проверьте поставщика/модель, указанную в ее нижнем колонтитуле.
Официальные ссылки
- Zoo Code: подключите своего первого провайдера
- [Zoo Code Полевые отчеты, совместимые с OpenAI] (https://github.com/Zoo-Code-Org/Zoo-Code/issues?q=%22OpenAI+Compatible%22)
- Репозиторий Zoo Code
Как выбрать модель
Часто задаваемые вопросы о поставщике 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。