GitHub Copilot

Подключите Chat GitHub Copilot, агенты VS Code и интерфейс командной строки Copilot к Model Gate с помощью BYOK и пользовательской конечной точки, совместимой с OpenAI.

GitHub Copilot через модельные ворота

Поддержка GitHub Copilot и кода Visual Studio. Принесите свой ключ (BYOK) модели. Model Gate можно использовать в качестве пользовательской конечной точки, совместимой с OpenAI, для чата Copilot и рабочих процессов агентов.

Для VS Code рекомендуемой настройкой является Пользовательская конечная точка провайдер с API ответов. Используйте завершение чата только в том случае, если выбранная модель или рабочий процесс специально требуют этого семейства API.

Обязательные значения

API key: mg_live_...
Responses endpoint: https://api.model-gate.com/v1/responses
Chat Completions endpoint: https://api.model-gate.com/v1/chat/completions
Base URL for Copilot CLI: https://api.model-gate.com/v1

Создайте специальный ключ API в Панель управления моделью ворот. Для интеграции группы или рабочей станции предпочтительнее использовать отдельный ключ вместо повторного использования несвязанного производственного ключа, чтобы можно было легко контролировать ограничения, историю запросов, ротацию и отзыв.

Перед настройкой Copilot перечислите включенные в настоящее время модели:

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

Используйте включенный канонический идентификатор модели или псевдоним, управляемый администратором, возвращаемый этой конечной точкой.

VS Code: рекомендуется настройка пользовательской конечной точки.

Текущие версии VS Code предоставляют модели BYOK в редакторе языковых моделей.

1. Откройте палитру команд. 2. Бежать Чат: управление языковыми моделями. 3. Выберите Добавить модели. 4. Выберите Пользовательская конечная точка. 5. Используйте имя группы, например Model Gate. 6. Введите ключ API Model Gate, когда VS Code запрашивает учетные данные поставщика. 7. Выберите Ответы в качестве типа API, если выбранная модель поддерживает API ответов. 8. Настройте модель с явной конечной точкой Model Gate и сохраните сгенерированный chatLanguageModels.json. 9. Выберите модель Model Gate в списке моделей Chat.

Не используйте устаревший github.copilot.chat.customOAIModels настройка новой конфигурации. Текущий поставщик настраиваемых конечных точек поддерживает конечные точки в стиле ответов, завершения чата и сообщений и является предпочтительным путем настройки VS Code.

Конфигурация рекомендуемых ответов

Сгенерированный chatLanguageModels.json можно использовать такую конфигурацию:

[
  {
    "name": "Model Gate",
    "vendor": "customendpoint",
    "apiKey": "${input:modelGateApiKey}",
    "apiType": "responses",
    "models": [
      {
        "id": "gpt-5.4",
        "name": "GPT-5.4 through Model Gate",
        "url": "https://api.model-gate.com/v1/responses",
        "toolCalling": true
      }
    ]
  }
]

Заменять gpt-5.4 с включенной моделью или псевдонимом Model Gate.

VS Code обычно отправляет ключ API как:

Authorization: Bearer mg_live_...

это правильная форма аутентификации для OpenAI-совместимого API Model Gate.

Резервное завершение чата

Если выбранный рабочий процесс требует завершения чата, настройте модель следующим образом:

[
  {
    "name": "Model Gate",
    "vendor": "customendpoint",
    "apiKey": "${input:modelGateApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "MODEL_ID",
        "name": "MODEL_ID through Model Gate",
        "url": "https://api.model-gate.com/v1/chat/completions",
        "toolCalling": true
      }
    ]
  }
]

Предпочитайте явный полный URL-адрес конечной точки. Это позволяет избежать двусмысленности, если VS Code изменит поведение вывода URL-пути.

Настройка кода VS	Поле «Модель ворот»
`contextWindow`	`context_window` (то же значение, что и `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

Полезные модели в VS Code

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

Если вы используете Model Gate BYOK без модели Copilot, размещенной на GitHub, настройте:

chat.utilityModel
chat.utilitySmallModel

Выберите быструю и недорогую модель Model Gate для chat.utilitySmallModel. Обычно нет смысла платить за самую большую модель рассуждения для генерации сообщений о фиксации или другую легковесную служебную работу.

The chat.byokUtilityModelDefault Параметр также может контролировать, будет ли работа утилиты следовать выбранной модели главного агента BYOK, использовать модели GitHub Copilot или не иметь значений по умолчанию.

Интерфейс командной строки второго пилота

GitHub Copilot CLI поддерживает настраиваемые поставщики, совместимые с OpenAI, через переменные среды.

Линукс или МакОС

export COPILOT_PROVIDER_TYPE="openai"
export COPILOT_PROVIDER_BASE_URL="https://api.model-gate.com/v1"
export COPILOT_PROVIDER_API_KEY="mg_live_..."
export COPILOT_MODEL="MODEL_ID"

второй пилот ```

Windows PowerShell

$env:COPILOT_PROVIDER_TYPE = "openai"
$env:COPILOT_PROVIDER_BASE_URL = "https://api.model-gate.com/v1"
$env:COPILOT_PROVIDER_API_KEY = "mg_live_..."
$env:COPILOT_MODEL = "MODEL_ID"

второй пилот ```

Для Copilot CLI выбранная модель должна поддерживать вызов инструментов и потоковая передача. Используйте включенную модель или псевдоним Model Gate и протестируйте ее, прежде чем делать конфигурацию постоянной.

Не помещайте ключ API в историю оболочки, файл репозитория или зафиксированный файл. .env. По возможности используйте хранилище учетных данных вашей ОС, защищенную среду оболочки или инструменты управления секретами организации.

Второй пилотный проект «Бизнес и предприятие»

GitHub также поддерживает пользовательские модели организации/предприятия через BYOK. GitHub в настоящее время перечисляет Поставщики, совместимые с OpenAI в качестве поддерживаемой категории поставщиков пользовательских моделей. Эта возможность на уровне организации управляется политикой GitHub и может находиться в предварительной версии в зависимости от поверхности Copilot.

Для управляемой организации:

1. Включите GitHub модели на заказ / BYOK политика, необходимая для вашего плана Copilot. 2. Добавьте собственный OpenAI-совместимый поставщик/модель в настройках модели Copilot организации или предприятия. 3. Используйте специальный ключ API Model Gate с минимально необходимыми разрешениями и ограничениями Model Gate. 4. Используйте конечную точку Model Gate и идентификатор модели, к которому ваша учетная запись имеет доступ. 5. Проверьте модель в рабочих процессах Copilot Chat/агента, прежде чем широко раскрывать ее в средстве выбора модели организации.

GitHub может изменять пользовательский интерфейс пользовательской модели организации по мере развития этой функции. Следуйте текущему административному интерфейсу GitHub для получения точных меток полей, а не полагайтесь на снимки экрана из более старой версии.

Что BYOK делает и не заменяет

Модель Model Gate BYOK может обеспечивать чат VS Code, рабочие процессы агентов, инструменты и служебные задачи, если модель поддерживает необходимые возможности.

Это делает нет автоматически заменять каждую функцию GitHub Copilot. В зависимости от текущей версии VS Code/GitHub такие функции, как стандартное встроенное дополнение кода, семантический поиск, внедрения или другие службы, размещаемые на GitHub, по-прежнему могут требовать аутентификации GitHub, плана Copilot или инфраструктуры GitHub.

Поэтому используйте Model Gate BYOK, когда ваша цель — контролировать Путь модели чата/агента и его оплата, а не как предположение, что весь сетевой трафик GitHub Copilot направляется через Model Gate.

Проверьте Model Gate перед тестированием Copilot

Ответы

curl https://api.model-gate.com/v1/responses \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "Reply with exactly: Model Gate OK"
  }'

Завершения чата

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with exactly: Model Gate OK"}]
  }'

Если эти запросы завершаются неудачно, исправьте политику ключа API/модели/ворота модели перед отладкой Copilot.

Поиск неисправностей

Проблема	Разрешение
Модель не отображается в режиме агента	Убедитесь, что модель настроена с вызовом инструмента и что фактическая модель Model Gate поддерживает вызовы функций/инструментов. Перезапустите VS Code после изменения конфигурации провайдера.
`401 invalid_api_key`	Повторно введите или поверните специальный ключ Model Gate. Подтвердите отправку второго пилота `Authorization: Bearer ...`.
`404` или неправильная конечная точка	Для ответов используйте явный `https://api.model-gate.com/v1/responses`; для завершения чата используйте `/v1/chat/completions`.
Модель не найдена	Запрос `/v1/models` и используйте включенный канонический идентификатор или псевдоним.
Агент не может использовать инструменты	Выберите модель с проверенным вызовом инструмента/функции. Copilot CLI также требует потоковой передачи.
Прикрепление изображения игнорируется/отклоняется	Используйте модель с проверенными возможностями ввода изображений/видения и настройте `vision: true` только для этой модели.
Функции утилиты не работают при настройке только BYOK.	Настроить `chat.utilityModel` и `chat.utilitySmallModel` к доступным моделям BYOK.
Встроенные дополнения по-прежнему используют GitHub или требуют входа в систему.	Ожидается: BYOK в первую очередь контролирует трафик чата/агента/служебной модели, а не каждую функцию Copilot.
Запросы неожиданно дорогие	Используйте меньшую модель для служебной работы, уменьшите количество рассуждений, где это необходимо, и настройте ограничения расходов/RPM/параллелизма Model Gate.

Текущие ссылки на исходные данные

GitHub и VS Code могут изменять конфигурацию BYOK между выпусками. Для текущего поведения восходящего потока проверьте:

- https://code.visualstudio.com/docs/agent-customization/language-models - https://docs.github.com/en/copilot/concepts/models/bring-your-own-key - https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models - https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models