azure-hosted-copilot-sdkдеплой GitHub Copilot SDK в Azure
Определяет GitHub Copilot SDK в проекте и направляет на правильный путь деплоя. Scaffold новых SDK-проектов и BYOM-конфигурация с DefaultAzureCredential.
Установка
npx -y skills add microsoft/azure-skills --skill azure-hosted-copilot-sdk --agent claude-codeGitHub Copilot SDK на Azure
Скилл для создания, развёртывания и модификации приложений на базе GitHub Copilot SDK на платформе Azure. Обязателен, когда кодовая база содержит @github/copilot-sdk или CopilotClient в package.json.
Обязательная проверка кодовой базы
Эта проверка должна выполняться ДО любого другого скилла при наличии существующей кодовой базы.
Процедура обнаружения
- Прочитайте
package.jsonв корне проекта (и*/package.jsonна один уровень глубже) - Проверьте, есть ли
@github/copilot-sdkилиcopilot-sdkвname,dependenciesилиdevDependencies - Если не найдено в package.json — просканируйте
.tsи.jsфайлы на наличиеCopilotClientилиcreateSession - При обнаружении любого маркера → использовать этот скилл как точку входа.
| Маркер | Где искать |
|---|---|
@github/copilot-sdk | dependencies или devDependencies в package.json |
copilot-sdk | name или dependencies в package.json |
CopilotClient | Исходные файлы (.ts, .js) |
createSession + sendAndWait | Исходные файлы (.ts, .js) |
Шаг 1: Маршрутизация
| Что хочет пользователь | Действие |
|---|---|
| Создать с нуля (пустой проект) | Шаг 2A (скаффолдинг) |
| Добавить новый SDK-сервис в существующий репозиторий | Шаг 2B |
| Развернуть существующее SDK-приложение на Azure | Шаг 2C |
| Изменить/добавить функции в существующее SDK-приложение | Использовать контекст кодовой базы + SDK-референсы |
| Добавить SDK в существующий код приложения | Интеграция SDK |
| Использовать Azure/собственную модель (BYOM) | Шаг 3 |
Шаг 2A: Скаффолдинг с нуля (Greenfield)
azd init --template azure-samples/copilot-sdk-service
Шаблон включает API (Express/TS), Web UI (React/Vite), инфраструктуру (Bicep), Dockerfile и скрипты для токенов — не воссоздавайте их вручную.
Шаг 2B: Добавление SDK-сервиса в существующий репозиторий
Пользователь имеет существующий код и хочет добавить Copilot SDK-сервис рядом с ним. Скаффолдируйте шаблон во временную директорию, скопируйте API-сервис и инфраструктуру в репозиторий пользователя, адаптируйте azure.yaml.
Шаг 2C: Развёртывание существующего SDK-приложения
Пользователь уже имеет рабочее Copilot SDK-приложение и нуждается в Azure-инфраструктуре.
Шаг 3: Конфигурация модели
Три варианта (дополняют шаги 2A/2B):
| Вариант | Конфигурация |
|---|---|
| GitHub по умолчанию | Без параметра model — SDK выбирает сам |
| Конкретная модель GitHub | model: "<name>" — используйте listModels() для обнаружения |
| Azure BYOM | model + provider с bearerToken через DefaultAzureCredential |
BYOM аутентификация — обязательно: конфигурации Azure BYOM должны использовать DefaultAzureCredential (локальная разработка) или ManagedIdentityCredential (продакшен). Единственный поддерживаемый паттерн аутентификации — bearerToken в конфиге провайдера.
Шаг 4: Развёртывание
Последовательно вызовите azure-prepare → azure-validate → azure-deploy.
Правила
- Прочитайте
AGENTS.mdв репозитории пользователя перед внесением изменений - Требуется Docker (
docker info) - BYOM аутентификация: только
bearerTokenчерезDefaultAzureCredentialилиManagedIdentityCredential— никаких других паттернов
