azure-deploy skill include apim and azure-aigateway updates based on recommended patterns by annaji-msft · Pull Request #604 · microsoft/GitHub-Copilot-for-Azure

annaji-msft · 2026-01-28T21:32:52Z

Refocused the azure-aigateway skill on AI-specific capabilities (models, MCP tools, agents) and moved APIM deployment to azure-deploy. The skill now follows the "golden path" philosophy with clear, focused responsibilities.

note Azure MCP does not support APIM

Changes

azure-aigateway skill

- Simplified SKILL.md from 365 lines to ~130 lines with progressive disclosure
- AI-focused triggers: "configure my model", "configure my tool", "add Azure OpenAI backend", "add AI Foundry model"
- New architecture diagram showing Users/Agents → AI Gateway (Secure • Observe • Control) → Backend services
- Created references/:
  - policies.md - Detailed AI governance policies (token limits, semantic caching, content safety)
  - patterns.md - Step-by-step configuration patterns (add AI backend, load balancing, content safety setup)
  - troubleshooting.md - Common issues and solutions

azure-deploy skill

- Added APIM to description and trigger phrases ("deploy APIM", "create API Management")
- Added APIM detection in the application detection workflow
- Created reference/apim.md - Comprehensive APIM deployment guide with Basicv2 SKU (5-10 min deploy)

Testing

- [ ]  Verify azure-aigateway triggers work for AI configuration scenarios
- [ ]  Verify azure-deploy triggers work for APIM deployment
- [ ]  Test reference file links resolve correctly

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…P conversion - Add trigger 'Add my model behind gateway' with Pattern 8 for AI Foundry model discovery - Add triggers for OpenAPI/Swagger import with Pattern 9 - Add triggers for MCP conversion with Pattern 10 - Pattern 8: Query AI Foundry models via az cognitiveservices account list-models and deploy behind gateway - Pattern 9: Import API from OpenAPI spec (URL or local file) with supported formats table - Pattern 10: Convert existing API operations to MCP server with operation selection

- Simplified SKILL.md to ~130 lines with references to detailed docs - Focus on AI models, MCP tools, and agents governance - Added references/policies.md, patterns.md, troubleshooting.md - Updated azure-deploy to include APIM deployment - Added azure-deploy/reference/apim.md for APIM guide - Updated triggers: 'configure my model', 'add Azure OpenAI backend' - Architecture diagram shows Users/Agents -> Gateway -> Backends

Copilot

Pull request overview

Refocuses the azure-aigateway skill on AI-specific APIM configuration (models/tools/agents) while moving APIM deployment guidance and triggers into azure-deploy, aligning responsibilities with recommended “golden path” patterns.

Changes:

Added an APIM deployment reference and updated azure-deploy triggers and detection guidance to cover APIM/API gateway scenarios.
Simplified azure-aigateway skill documentation and introduced focused AI gateway references (policies, patterns, troubleshooting).
Added detailed AI governance and troubleshooting documentation for APIM-as-AI-Gateway scenarios.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
plugin/skills/azure-deploy/reference/apim.md	New comprehensive APIM deployment guide for API Gateway / AI Gateway use cases.
plugin/skills/azure-deploy/SKILL.md	Extends skill description and detection guidance to include APIM deployment and routing to azure-aigateway for AI configuration.
plugin/skills/azure-aigateway/SKILL.md	Rewritten, shorter skill doc focused on AI governance/config/testing, with references to detailed docs.
plugin/skills/azure-aigateway/references/policies.md	New policy reference patterns for semantic caching, token limits, content safety, metrics, etc.
plugin/skills/azure-aigateway/references/patterns.md	New step-by-step configuration patterns and cross-linking to deployment guidance.
plugin/skills/azure-aigateway/references/troubleshooting.md	New troubleshooting guide for common APIM AI gateway issues.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

plugin/skills/azure-aigateway/references/patterns.md

plugin/skills/azure-aigateway/references/policies.md

plugin/skills/azure-aigateway/references/troubleshooting.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

plugin/skills/azure-aigateway/references/troubleshooting.md

plugin/skills/azure-aigateway/references/policies.md

kvenkatrajan

Heads up there's a major refactor of the deploy skill at - #609. Please coordinate with @wbreza on how this should be applied for deploy

kvenkatrajan · 2026-01-29T13:21:31Z

plugin/skills/azure-deploy/reference/apim.md

+
+---
+
+## Prerequisites and Validation


Thanks for validating prerequisites

kvenkatrajan · 2026-01-29T13:22:30Z

plugin/skills/azure-aigateway/SKILL.md

 name: azure-aigateway
-description: Bootstrap and configure Azure API Management as an AI Gateway for securing, observing, and controlling AI models, tools (MCP Servers), and agents. Use this skill when setting up a gateway for models or tools, rate limiting model/tool requests, adding semantic caching, content safety, or load balancing to AI endpoints.
+description: >-
+  Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents.


I like that you have trigger phrases - seeing these being picked up more reliably
Is there room for compaction of the description?

we should try running sensei on it and see how it goes

kvenkatrajan · 2026-01-29T14:45:47Z

plugin/skills/azure-aigateway/SKILL.md

-    }
-  }
-}
+## Architecture


Do we need the architecture diagram here? Want to be conscious of tokens being utilized

saikoumudi · 2026-02-10T18:41:50Z

plugin/skills/azure-deploy/reference/apim.md

@@ -0,0 +1,444 @@
+# Azure API Management Deployment Guide


This PR needs a refresh. I think azure-prepare is a better place for this apim.md file based on the new file structure we have.

JasonYeMSFT · 2026-02-12T22:18:29Z

@annaji-msft Do you still plan to merge the changes?

annaji-msft and others added 7 commits January 27, 2026 12:38

Add azure-aigateway skill for AI Gateway bootstrap and configuration

5d74907

Simplify lab references with hyperlinks

ecde054

Update plugin/skills/azure-aigateway/SKILL.md

778806f

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update plugin/skills/azure-aigateway/SKILL.md

aa244ce

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge branch 'microsoft:main' into main

4daad0c

Copilot AI review requested due to automatic review settings January 28, 2026 21:32

Copilot started reviewing on behalf of annaji-msft January 28, 2026 21:33 View session

Copilot AI reviewed Jan 28, 2026

View reviewed changes

Update plugin/skills/azure-aigateway/references/patterns.md

5c938e3

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings January 28, 2026 21:36

annaji-msft and others added 2 commits January 28, 2026 13:37

Update plugin/skills/azure-aigateway/references/policies.md

70ef01a

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update plugin/skills/azure-aigateway/references/troubleshooting.md

26a13d9

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot started reviewing on behalf of annaji-msft January 28, 2026 21:37 View session

Update plugin/skills/azure-aigateway/references/policies.md

af6b978

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI reviewed Jan 28, 2026

View reviewed changes

plugin/skills/azure-aigateway/references/troubleshooting.md Show resolved Hide resolved

plugin/skills/azure-aigateway/references/policies.md Show resolved Hide resolved

plugin/skills/azure-aigateway/references/policies.md Show resolved Hide resolved

kvenkatrajan mentioned this pull request Jan 29, 2026

Updates azure-deploy skill #609

Merged

kvenkatrajan reviewed Jan 29, 2026

View reviewed changes

saikoumudi reviewed Feb 10, 2026

View reviewed changes

kvenkatrajan added the pending-owner-action label Feb 18, 2026

Comments

Conversation

annaji-msft commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kvenkatrajan left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kvenkatrajan Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

kvenkatrajan Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

saikoumudi Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

kvenkatrajan Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

saikoumudi Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

JasonYeMSFT commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

annaji-msft commented Jan 28, 2026 •

edited

Loading

kvenkatrajan left a comment •

edited

Loading