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 — так проще отслеживать расход).
- Консоль: https://aicentos.com
- Создание ключа: https://aicentos.com/keys
- Пополнение при нехватке баланса: https://aicentos.com/wallet
Также убедитесь, что VS Code и расширение GitHub Copilot Chat на вашей машине обновлены до версии с поддержкой кастомных эндпоинтов; в более старых версиях BYOK есть только для встроенных вендоров, без универсального пункта «кастомный эндпоинт».
Конфигурация для заполнения
| Поле | Значение |
|---|---|
| Provider | Custom Endpoint (в старых версиях — OpenAI Compatible) |
| Base URL | https://aicentos.com/v1 |
| Тип API | Chat Completions (соответствует https://aicentos.com/v1/chat/completions) |
| API Key | ключ, созданный в консоли |
| Model ID | имя модели из «витрины моделей» в консоли |
| Tool Calling | true (обязательно включить для работы в режиме 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.