Skip to Content
aicentos

GitHub Copilot

Подключение OpenAI-совместимого эндпоинта aicentos в GitHub Copilot Chat через собственный ключ (BYOK)

Обновлено:

GitHub Copilot в VS Code предоставляет возможность BYOK (свой ключ): запросы диалога можно направить на кастомный OpenAI-совместимый эндпоинт. Достаточно указать в качестве эндпоинта aicentos и вписать ключ, созданный в консоли, — после этого модели, подключённые к aicentos, станут доступны в Copilot Chat / Agent.

Подготовка

Сначала создайте на странице «API Key» в консоли отдельный ключ для Copilot (рекомендуемые имена copilot-vscode или copilot-work — так проще отслеживать расход).

Также убедитесь, что VS Code и расширение GitHub Copilot Chat на вашей машине обновлены до версии с поддержкой кастомных эндпоинтов; в более старых версиях BYOK есть только для встроенных вендоров, без универсального пункта «кастомный эндпоинт».

Конфигурация для заполнения

ПолеЗначение
ProviderCustom Endpoint (в старых версиях — OpenAI Compatible)
Base URLhttps://aicentos.com/v1
Тип APIChat Completions (соответствует https://aicentos.com/v1/chat/completions)
API Keyключ, созданный в консоли
Model IDимя модели из «витрины моделей» в консоли
Tool Callingtrue (обязательно включить для работы в режиме Agent)

Шаги настройки

Вариант 1: графический интерфейс

  • Откройте панель Chat в VS Code.
  • Нажмите на селектор моделей над полем ввода и выберите Manage Language Models (в старых версиях — Manage Models...).
  • Нажмите Add Models и в списке провайдеров выберите Custom Endpoint (в старых версиях — OpenAI Compatible).
  • Введите имя группы и API Key.
  • В качестве типа API выберите Chat Completions.
  • Заполните данные модели по подсказкам: в id — имя модели из консоли, в url — https://aicentos.com/v1/chat/completions.
  • После сохранения вернитесь в Chat и выберите только что добавленную модель в выпадающем списке моделей.

Вариант 2: settings.json

Выполните в командной палитре Preferences: Open User Settings (JSON) и добавьте:

{
  "github.copilot.chat.customOAIModels": {
    "aicentos-gpt": {
      "name": "aicentos GPT",
      "url": "https://aicentos.com/v1/chat/completions",
      "toolCalling": true,
      "vision": false,
      "maxInputTokens": 128000,
      "maxOutputTokens": 16384
    }
  }
}

Ключ внешнего уровня объекта (например, aicentos-gpt) — это ID модели, который вы видите в селекторе моделей; он должен быть уникальным.

Справочник официальной документации: https://code.visualstudio.com/docs/copilot/customization/language-models

Проверка

После сохранения настроек создайте в Chat новый диалог и сначала сделайте лёгкий тест с простым промптом: если ответ приходит нормально, подключение работает — можно переходить к полноценному использованию режимов Agent / Edit.

Примечания

  • BYOK действует только на Chat / Agent / Edit и не распространяется на инлайн-автодополнение кода (Tab); семантический поиск, embedding и подобные возможности по-прежнему идут через собственные сервисы Copilot.
  • Чтобы модель была доступна в режиме Agent, она должна поддерживать tool calling, а toolCalling должно быть установлено в true; иначе модель не появится в селекторе моделей.
  • В поле url вписывается полный адрес https://aicentos.com/v1/chat/completions, а не только /v1.
  • github.copilot.chat.customOAIModels — устаревший вариант: новые версии используют chatLanguageModels.json в связке с customendpoint; ориентируйтесь на актуальный интерфейс вашей версии VS Code.
  • В GitHub Copilot Business / Enterprise администратор может отключить BYOK политиками.
  • Если модель не появилась сразу после добавления, перезапустите VS Code.
  • При ошибке проверяйте по порядку: нет ли в ключе лишних пробелов, совпадает ли имя модели с консолью, достаточно ли средств на счёте, правильно ли выбран тип API. При нехватке баланса пополните кошелёк на https://aicentos.com/wallet.