# GitHub Copilot

Источник: https://docs.aicentos.com/ru/clients/copilot

Language: ru

> Подключение 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)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение при нехватке баланса: [https://aicentos.com/wallet](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)** и добавьте:

```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](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](https://aicentos.com/wallet).