microsoft/azure-skills / azure-aigateway

azure-aigateway

Установки: 551,722
Автор: microsoft/azure-skills
Источник: github.com/microsoft/azure-skills

Настраивает Azure API Management как AI-шлюз для управления моделями, MCP-инструментами и агентами. Включает семантическое кэширование, лимиты токенов, контроль безопасности, балансировку нагрузки и мониторинг. Помогает централизованно управлять доступом к AI-сервисам и снижать расходы.

Установить скилл

npx skills add https://github.com/microsoft/azure-skills --skill azure-aigateway

Аудит безопасности

Gen Agent Trust Hub

pass

This skill provides a secure framework for configuring Azure API Management as an AI Gateway. It emphasizes industry-standard security practices, including the use of Managed Identities for authentication and the implementation of AI-specific safety policies to govern model interactions. All resources and dependencies are sourced from verified Microsoft repositories.

Audited: 4/22/2026, 10:00:58 PM

Socket

pass

No alerts

Audited: 4/22/2026, 10:02:11 PM

Snyk

warn

Risk: MEDIUM · 1 issue

Audited: 4/22/2026, 10:00:43 PM

ZeroLeaks

pass

Score: 93/100 · 2 sections analyzed

Audited: 4/15/2026, 10:00:33 PM

Промпт скилла

Azure AI Gateway

Configure Azure API Management (APIM) as an AI Gateway for governing AI models, MCP tools, and agents.

To deploy APIM, use the azure-prepare skill. See APIM deployment guide.

When to Use This Skill

Category	Triggers
Model Governance	"semantic caching", "token limits", "load balance AI", "track token usage"
Tool Governance	"rate limit MCP", "protect my tools", "configure my tool", "convert API to MCP"
Agent Governance	"content safety", "jailbreak detection", "filter harmful content"
Configuration	"add Azure OpenAI backend", "configure my model", "add AI Foundry model"
Testing	"test AI gateway", "call OpenAI through gateway"

Quick Reference

Policy	Purpose	Details
`azure-openai-token-limit`	Cost control	Model Policies
`azure-openai-semantic-cache-lookup/store`	60-80% cost savings	Model Policies
`azure-openai-emit-token-metric`	Observability	Model Policies
`llm-content-safety`	Safety & compliance	Agent Policies
`rate-limit-by-key`	MCP/tool protection	Tool Policies

Get Gateway Details

# Get gateway URL
az apim show --name <apim-name> --resource-group <rg> --query "gatewayUrl" -o tsv

# List backends (AI models)
az apim backend list --service-name <apim-name> --resource-group <rg> \
  --query "[].{id:name, url:url}" -o table

# Get subscription key
az apim subscription keys list \
  --service-name <apim-name> --resource-group <rg> --subscription-id <sub-id>

Test AI Endpoint

GATEWAY_URL=$(az apim show --name <apim-name> --resource-group <rg> --query "gatewayUrl" -o tsv)

curl -X POST "${GATEWAY_URL}/openai/deployments/<deployment>/chat/completions?api-version=2024-02-01" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: <key>" \
  -d '{"messages": [{"role": "user", "content": "Hello"}], "max_tokens": 100}'

Common Tasks

Add AI Backend

See references/patterns.md for full steps.

# Discover AI resources
az cognitiveservices account list --query "[?kind=='OpenAI']" -o table

# Create backend
az apim backend create --service-name <apim> --resource-group <rg> \
  --backend-id openai-backend --protocol http --url "https://<aoai>.openai.azure.com/openai"

# Grant access (managed identity)
az role assignment create --assignee <apim-principal-id> \
  --role "Cognitive Services User" --scope <aoai-resource-id>

Apply AI Governance Policy

Recommended policy order in <inbound>:

Authentication - Managed identity to backend
Semantic Cache Lookup - Check cache before calling AI
Token Limits - Cost control
Content Safety - Filter harmful content
Backend Selection - Load balancing
Metrics - Token usage tracking

See references/policies.md for complete example.

Troubleshooting

Issue	Solution
Token limit 429	Increase `tokens-per-minute` or add load balancing
No cache hits	Lower `score-threshold` to 0.7
Content false positives	Increase category thresholds (5-6)
Backend auth 401	Grant APIM "Cognitive Services User" role

See references/troubleshooting.md for details.

References

Detailed Policies - Full policy examples
Configuration Patterns - Step-by-step patterns
Troubleshooting - Common issues
AI-Gateway Samples
GenAI Gateway Docs

SDK Quick References

Content Safety: Python | TypeScript
API Management: Python | .NET

Все файлы скилла

references/auth-best-practices.md
references/patterns.md
references/policies.md
references/sdk/azure-ai-contentsafety-py.md
references/sdk/azure-ai-contentsafety-ts.md
references/sdk/azure-mgmt-apimanagement-dotnet.md
references/sdk/azure-mgmt-apimanagement-py.md
references/troubleshooting.md
SKILL.md

Другие скиллы автора

azure-diagnostics

554,288 установок

microsoft/azure-skills

Скилл для системной диагностики и устранения проблем Azure в продакшене: от App Service, Functions и AKS до виртуальных машин и очередей сообщений. Использует AppLens, Azure Monitor и проверку ресурсов, чтобы быстро находить первопричины сбоев, анализировать логи и предлагать шаги по восстановлению.

azure-prepare

553,704 установок

microsoft/azure-skills

Скилл готовит проекты к развёртыванию в Azure: анализирует кодовую базу, выбирает подходящий сценарий (Bicep, Terraform или AZD) и создаёт всю необходимую инфраструктуру — план развёртывания, конфигурационные файлы и Dockerfile. Автоматизирует подготовительный этап, чтобы последующая валидация и деплой прошли без ошибок.

azure-ai

553,621 установок

microsoft/azure-skills

Скилл для работы с сервисами Azure AI: поиск (включая векторный и гибридный), распознавание и синтез речи, транскрибация, OCR и документы. Помогает быстро выполнять задачи через MCP-инструменты или подсказывает нужные SDK-примеры для Python, TypeScript и .NET. Ускоряет интеграцию с Azure AI Search, Speech, OpenAI и Document Intelligence.

azure-deploy

553,594 установок

microsoft/azure-skills

Навык автоматизирует развертывание уже подготовленных приложений в Azure с помощью azd, terraform и az deployment. Он проверяет готовность плана, выполняет деплой, обрабатывает ошибки и подтверждает успешный запуск, возвращая ссылки на ресурсы. Полезен для надежного и повторяемого деплоя без ручных шагов.

azure-validate

553,079 установок

microsoft/azure-skills

Проверяет готовность Azure-окружения к развертыванию: конфигурацию, Bicep/Terraform-шаблоны, роли RBAC и разрешения managed identity. Позволяет выявить проблемы до деплоя, сэкономить время и избежать сбоев.

azure-storage

552,529 установок

microsoft/azure-skills

Скилл для работы с Azure Storage: управление блоб-хранилищем, файловыми ресурсами, очередями и таблицами. Помогает выбирать уровни доступа (hot/cool/cold/archive) и варианты избыточности, а также выполнять операции через CLI или MCP. Полезен для загрузки, скачивания и перечисления объектов в облаке Azure.

entra-app-registration

552,269 установок

microsoft/azure-skills

Скилл помогает регистрировать приложения в Microsoft Entra ID, настраивать OAuth 2.0 и подключать MSAL для аутентификации пользователей и сервисов. Охватывает создание app registration, настройку API-разрешений, клиентских секретов и сертификатов, а также лучшие практики безопасности. Удобен для быстрой настройки аутентификации в веб-, мобильных и фоновых приложениях.

appinsights-instrumentation

552,016 установок

microsoft/azure-skills

Скилл предоставляет руководство по инструментированию веб-приложений с помощью Azure Application Insights: описывает паттерны телеметрии, настройку SDK и конфигурацию. Помогает разработчикам добавлять мониторинг в приложения, а также разграничивает случаи, когда следует использовать azure-prepare для внесения изменений в проект.

azure-resource-lookup

551,937 установок

microsoft/azure-skills

Находит и перечисляет ресурсы Azure любого типа по подпискам и группам ресурсов через Azure Resource Graph. Помогает отвечать на вопросы «что у меня есть», искать ресурсы по тегам, обнаруживать осиротевшие диски и неиспользуемые IP-адреса. Используется, когда нет выделенного MCP-инструмента для нужного типа ресурсов.

azure-resource-visualizer

551,932 установок

microsoft/azure-skills

Анализирует группы ресурсов Azure и создает подробные диаграммы архитектуры в формате Mermaid. Помогает визуализировать взаимосвязи между ресурсами, группировать их по слоям и документировать инфраструктуру. Полезен для понимания структуры облачных решений и создания наглядной документации.

azure-compliance

551,896 установок

microsoft/azure-skills

Проводит аудит безопасности и соответствия Azure: оценивает ресурсы по лучшим практикам, находит неверно настроенные и потерянные ресурсы, а также проверяет ключи, секреты и сертификаты Key Vault на истечение срока действия. Помогает выявлять критические риски и планировать их устранение.

azure-kusto

551,647 установок

microsoft/azure-skills

Помогает работать с Azure Data Explorer (Kusto): выполнять KQL-запросы, исследовать схему таблиц, анализировать логи, телеметрию и временные ряды. Полезен для поиска аномалий, агре

azure-messaging

541,378 установок

microsoft/azure-skills

Навык для диагностики и устранения неполадок в Azure Messaging SDK (Event Hubs, Service Bus). Помогает решать проблемы с подключением, аутентификацией, обработкой сообщений и конфигурацией. Использует инструменты MCP для проверки состояния ресурсов, поиска документации и анализа ошибок.

azure-compute

495,407 установок

microsoft/azure-skills

Помогает подбирать, сравнивать и создавать виртуальные машины и масштабируемые наборы в Azure, а также оценивать их стоимость. Разбирается в сценариях резервирования мощности, автомасштабирования и управления машинами, направляя запрос к нужному рабочему процессу.

azure-rbac

486,709 установок

microsoft/azure-skills

Помогает подобрать роль Azure RBAC с минимальными правами для идентичности, сгенерировать команды CLI и код Bicep для её назначения. Также подскажет, какие разрешения нужны, чтобы выдать доступ другому пользователю или сервису.

azure-cloud-migrate

485,404 установок

microsoft/azure-skills

Помогает оценить и перенести существующие облачные нагрузки в Azure: конвертирует код и конфигурацию, формирует отчёт о миграции. Поддерживает переезд AWS Lambda, Elastic Beanstalk, Heroku, Google App Engine, Kubernetes, Cloud Run и Spring Boot в Azure Functions, App Service и Container Apps.

azure-hosted-copilot-sdk

438,545 установок

microsoft/azure-skills

Скилл автоматизирует сборку, развертывание и доработку приложений на GitHub Copilot SDK в Azure: определяет наличие SDK в коде, создаёт инфраструктуру, настраивает модели (включая BYOM) и запускает деплой. Полезен, когда нужно быстро подготовить или модифицировать Copilot-приложение без ручной настройки Azure.

azure-quotas

421,637 установок

microsoft/azure-skills

Помогает проверять и управлять квотами Azure: лимитами ресурсов, текущим использованием и доступной ёмкостью в регионах. Позволяет планировать развёртывание, сравнивать регионы по доступности квот, запрашивать увеличение лимитов и избегать ошибок превышения. Использует Azure CLI для точных данных.

azure-upgrade

413,773 установок

microsoft/azure-skills

Навык для оценки и автоматизации обновления Azure-ресурсов: планов, SKU, тарифов, а также модернизации Azure SDK в коде. Поддерживает сценарии: обновление Azure Functions (Consumption→Flex), миграцию App Service на Container Apps, обновление Java SDK (com.microsoft.azure→com.azure) и миграцию Azure Cache

azure-enterprise-infra-planner

388,208 установок

microsoft/azure-skills

Навык проектирует корпоративную инфраструктуру Azure: сети, безопасность, identity, мультирегиональные сценарии. Генерирует код Bicep или Terraform, проверяет его на соответствие лучшим практикам и безопасность, затем разворачивает с подтверждением. Помогает архитекторам и инженерам быстро создавать надёжные облачные решения.

azure-kubernetes

381,128 установок

microsoft/azure-skills

Навык помогает планировать и создавать кластеры Azure Kubernetes Service (AKS): выбирать SKU, проектировать сеть, настраивать безопасность, наблюдаемость, обновления и оптимизацию затрат. Различает решения Day-0 (сеть, API-сервер) и Day-1 (автомасштабирование, VPA, Spot-пулы), предоставляет чек-листы и сценарии для глубокой настройки.

azure-cost

356,363 установок

microsoft/azure-skills

Навык для управления затратами в Azure: позволяет запрашивать исторические данные о расходах, прогнозировать будущие затраты и получать рекомендации по оптимизации. Помогает анализировать затраты по подпискам, группам ресурсов и другим областям, а также выявлять возможности для сокращения расходов.

airunway-aks-setup

300,339 установок

microsoft/azure-skills

Скилл помогает развернуть AI Runway на кластере AKS: проверяет готовность кластера, устанавливает контроллер, выбирает провайдера инференса и запускает модель. Пошагово проводит от начальной настройки до первого развертывания, с проверкой статуса на каждом этапе.