[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-microsoft-azure-aigateway":3,"mdc-k00ulx-key":43,"related-org-microsoft-azure-aigateway":1636,"related-repo-microsoft-azure-aigateway":1821},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":31,"repoUrl":32,"updatedAt":33,"license":34,"forks":35,"topics":36,"repo":38,"sourceUrl":41,"mdContent":42},"azure-aigateway","configure Azure API Management as an AI Gateway","Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailbreak detection, add Azure OpenAI backend, add AI Foundry model, test AI gateway, LLM policies, configure AI backend, token metrics, AI cost control, convert API to MCP, import OpenAPI to gateway.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"microsoft","Microsoft","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fmicrosoft.png",[12,16,19,22,25,28],{"name":13,"slug":14,"type":15},"Security","security","tag",{"name":17,"slug":18,"type":15},"Azure","azure",{"name":20,"slug":21,"type":15},"Governance","governance",{"name":23,"slug":24,"type":15},"AI Infrastructure","ai-infrastructure",{"name":26,"slug":27,"type":15},"API Development","api-development",{"name":29,"slug":30,"type":15},"Caching","caching",1324,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fazure-skills","2026-07-31T05:56:23.05242","MIT",220,[37],"agent-skills",{"repoUrl":32,"stars":31,"forks":35,"topics":39,"description":40},[37],"Official agent plugin providing skills and MCP server configurations for Azure scenarios.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fazure-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fazure-aigateway","---\nname: azure-aigateway\ndescription: \"Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailbreak detection, add Azure OpenAI backend, add AI Foundry model, test AI gateway, LLM policies, configure AI backend, token metrics, AI cost control, convert API to MCP, import OpenAPI to gateway.\"\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"3.2.1\"\ncompatibility: Requires Azure CLI (az) for configuration and testing\n---\n\n# Azure AI Gateway\n\nConfigure Azure API Management (APIM) as an AI Gateway for governing AI models, MCP tools, and agents.\n\n> **To deploy APIM**, use the **azure-prepare** skill. See [APIM deployment guide](https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-management\u002Fget-started-create-service-instance).\n\n## When to Use This Skill\n\n| Category | Triggers |\n|----------|----------|\n| **Model Governance** | \"semantic caching\", \"token limits\", \"load balance AI\", \"track token usage\" |\n| **Tool Governance** | \"rate limit MCP\", \"protect my tools\", \"configure my tool\", \"convert API to MCP\" |\n| **Agent Governance** | \"content safety\", \"jailbreak detection\", \"filter harmful content\" |\n| **Configuration** | \"add Azure OpenAI backend\", \"configure my model\", \"add AI Foundry model\" |\n| **Testing** | \"test AI gateway\", \"call OpenAI through gateway\" |\n\n---\n\n## Quick Reference\n\n| Policy | Purpose | Details |\n|--------|---------|---------|\n| `azure-openai-token-limit` | Cost control | [Model Policies](references\u002Fpolicies.md#token-rate-limiting) |\n| `azure-openai-semantic-cache-lookup\u002Fstore` | 60-80% cost savings | [Model Policies](references\u002Fpolicies.md#semantic-caching) |\n| `azure-openai-emit-token-metric` | Observability | [Model Policies](references\u002Fpolicies.md#token-metrics) |\n| `llm-content-safety` | Safety & compliance | [Agent Policies](references\u002Fpolicies.md#content-safety) |\n| `rate-limit-by-key` | MCP\u002Ftool protection | [Tool Policies](references\u002Fpolicies.md#request-rate-limiting) |\n\n---\n\n## Get Gateway Details\n\n```bash\n# Get gateway URL\naz apim show --name \u003Capim-name> --resource-group \u003Crg> --query \"gatewayUrl\" -o tsv\n\n# List backends (AI models)\naz apim backend list --service-name \u003Capim-name> --resource-group \u003Crg> \\\n  --query \"[].{id:name, url:url}\" -o table\n\n# Get subscription key\naz apim subscription keys list \\\n  --service-name \u003Capim-name> --resource-group \u003Crg> --subscription-id \u003Csub-id>\n```\n\n---\n\n## Test AI Endpoint\n\n```bash\nGATEWAY_URL=$(az apim show --name \u003Capim-name> --resource-group \u003Crg> --query \"gatewayUrl\" -o tsv)\n\ncurl -X POST \"${GATEWAY_URL}\u002Fopenai\u002Fdeployments\u002F\u003Cdeployment>\u002Fchat\u002Fcompletions?api-version=2024-02-01\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"Ocp-Apim-Subscription-Key: \u003Ckey>\" \\\n  -d '{\"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}], \"max_tokens\": 100}'\n```\n\n---\n\n## Common Tasks\n\n### Add AI Backend\n\nSee [references\u002Fpatterns.md](references\u002Fpatterns.md#pattern-1-add-ai-model-backend) for full steps.\n\n```bash\n# Discover AI resources\naz cognitiveservices account list --query \"[?kind=='OpenAI']\" -o table\n\n# Create backend\naz apim backend create --service-name \u003Capim> --resource-group \u003Crg> \\\n  --backend-id openai-backend --protocol http --url \"https:\u002F\u002F\u003Caoai>.openai.azure.com\u002Fopenai\"\n\n# Grant access (managed identity)\naz role assignment create --assignee \u003Capim-principal-id> \\\n  --role \"Cognitive Services User\" --scope \u003Caoai-resource-id>\n```\n\n### Apply AI Governance Policy\n\nRecommended policy order in `\u003Cinbound>`:\n\n1. **Authentication** - Managed identity to backend\n2. **Semantic Cache Lookup** - Check cache before calling AI\n3. **Token Limits** - Cost control\n4. **Content Safety** - Filter harmful content\n5. **Backend Selection** - Load balancing\n6. **Metrics** - Token usage tracking\n\nSee [references\u002Fpolicies.md](references\u002Fpolicies.md#combining-policies) for complete example.\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Token limit 429 | Increase `tokens-per-minute` or add load balancing |\n| No cache hits | Lower `score-threshold` to 0.7 |\n| Content false positives | Increase category thresholds (5-6) |\n| Backend auth 401 | Grant APIM \"Cognitive Services User\" role |\n\nSee [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md) for details.\n\n---\n\n## References\n\n- [**Detailed Policies**](references\u002Fpolicies.md) - Full policy examples\n- [**Configuration Patterns**](references\u002Fpatterns.md) - Step-by-step patterns\n- [**Troubleshooting**](references\u002Ftroubleshooting.md) - Common issues\n- [AI-Gateway Samples](https:\u002F\u002Fgithub.com\u002FAzure-Samples\u002FAI-Gateway)\n- [GenAI Gateway Docs](https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-management\u002Fgenai-gateway-capabilities)\n\n## SDK Quick References\n\n- **Content Safety**: [Python](references\u002Fsdk\u002Fazure-ai-contentsafety-py.md) | [TypeScript](references\u002Fsdk\u002Fazure-ai-contentsafety-ts.md)\n- **API Management**: [Python](references\u002Fsdk\u002Fazure-mgmt-apimanagement-py.md) | [.NET](references\u002Fsdk\u002Fazure-mgmt-apimanagement-dotnet.md)\n",{"data":44,"body":48},{"name":4,"description":6,"license":34,"metadata":45,"compatibility":47},{"author":9,"version":46},"3.2.1","Requires Azure CLI (az) for configuration and testing",{"type":49,"children":50},"root",[51,60,66,99,106,214,218,224,380,383,389,747,750,756,982,985,991,998,1011,1300,1306,1319,1384,1396,1399,1405,1495,1506,1509,1515,1577,1583,1630],{"type":52,"tag":53,"props":54,"children":56},"element","h1",{"id":55},"azure-ai-gateway",[57],{"type":58,"value":59},"text","Azure AI Gateway",{"type":52,"tag":61,"props":62,"children":63},"p",{},[64],{"type":58,"value":65},"Configure Azure API Management (APIM) as an AI Gateway for governing AI models, MCP tools, and agents.",{"type":52,"tag":67,"props":68,"children":69},"blockquote",{},[70],{"type":52,"tag":61,"props":71,"children":72},{},[73,79,81,86,88,97],{"type":52,"tag":74,"props":75,"children":76},"strong",{},[77],{"type":58,"value":78},"To deploy APIM",{"type":58,"value":80},", use the ",{"type":52,"tag":74,"props":82,"children":83},{},[84],{"type":58,"value":85},"azure-prepare",{"type":58,"value":87}," skill. See ",{"type":52,"tag":89,"props":90,"children":94},"a",{"href":91,"rel":92},"https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-management\u002Fget-started-create-service-instance",[93],"nofollow",[95],{"type":58,"value":96},"APIM deployment guide",{"type":58,"value":98},".",{"type":52,"tag":100,"props":101,"children":103},"h2",{"id":102},"when-to-use-this-skill",[104],{"type":58,"value":105},"When to Use This Skill",{"type":52,"tag":107,"props":108,"children":109},"table",{},[110,129],{"type":52,"tag":111,"props":112,"children":113},"thead",{},[114],{"type":52,"tag":115,"props":116,"children":117},"tr",{},[118,124],{"type":52,"tag":119,"props":120,"children":121},"th",{},[122],{"type":58,"value":123},"Category",{"type":52,"tag":119,"props":125,"children":126},{},[127],{"type":58,"value":128},"Triggers",{"type":52,"tag":130,"props":131,"children":132},"tbody",{},[133,150,166,182,198],{"type":52,"tag":115,"props":134,"children":135},{},[136,145],{"type":52,"tag":137,"props":138,"children":139},"td",{},[140],{"type":52,"tag":74,"props":141,"children":142},{},[143],{"type":58,"value":144},"Model Governance",{"type":52,"tag":137,"props":146,"children":147},{},[148],{"type":58,"value":149},"\"semantic caching\", \"token limits\", \"load balance AI\", \"track token usage\"",{"type":52,"tag":115,"props":151,"children":152},{},[153,161],{"type":52,"tag":137,"props":154,"children":155},{},[156],{"type":52,"tag":74,"props":157,"children":158},{},[159],{"type":58,"value":160},"Tool Governance",{"type":52,"tag":137,"props":162,"children":163},{},[164],{"type":58,"value":165},"\"rate limit MCP\", \"protect my tools\", \"configure my tool\", \"convert API to MCP\"",{"type":52,"tag":115,"props":167,"children":168},{},[169,177],{"type":52,"tag":137,"props":170,"children":171},{},[172],{"type":52,"tag":74,"props":173,"children":174},{},[175],{"type":58,"value":176},"Agent Governance",{"type":52,"tag":137,"props":178,"children":179},{},[180],{"type":58,"value":181},"\"content safety\", \"jailbreak detection\", \"filter harmful content\"",{"type":52,"tag":115,"props":183,"children":184},{},[185,193],{"type":52,"tag":137,"props":186,"children":187},{},[188],{"type":52,"tag":74,"props":189,"children":190},{},[191],{"type":58,"value":192},"Configuration",{"type":52,"tag":137,"props":194,"children":195},{},[196],{"type":58,"value":197},"\"add Azure OpenAI backend\", \"configure my model\", \"add AI Foundry model\"",{"type":52,"tag":115,"props":199,"children":200},{},[201,209],{"type":52,"tag":137,"props":202,"children":203},{},[204],{"type":52,"tag":74,"props":205,"children":206},{},[207],{"type":58,"value":208},"Testing",{"type":52,"tag":137,"props":210,"children":211},{},[212],{"type":58,"value":213},"\"test AI gateway\", \"call OpenAI through gateway\"",{"type":52,"tag":215,"props":216,"children":217},"hr",{},[],{"type":52,"tag":100,"props":219,"children":221},{"id":220},"quick-reference",[222],{"type":58,"value":223},"Quick Reference",{"type":52,"tag":107,"props":225,"children":226},{},[227,248],{"type":52,"tag":111,"props":228,"children":229},{},[230],{"type":52,"tag":115,"props":231,"children":232},{},[233,238,243],{"type":52,"tag":119,"props":234,"children":235},{},[236],{"type":58,"value":237},"Policy",{"type":52,"tag":119,"props":239,"children":240},{},[241],{"type":58,"value":242},"Purpose",{"type":52,"tag":119,"props":244,"children":245},{},[246],{"type":58,"value":247},"Details",{"type":52,"tag":130,"props":249,"children":250},{},[251,278,303,328,354],{"type":52,"tag":115,"props":252,"children":253},{},[254,264,269],{"type":52,"tag":137,"props":255,"children":256},{},[257],{"type":52,"tag":258,"props":259,"children":261},"code",{"className":260},[],[262],{"type":58,"value":263},"azure-openai-token-limit",{"type":52,"tag":137,"props":265,"children":266},{},[267],{"type":58,"value":268},"Cost control",{"type":52,"tag":137,"props":270,"children":271},{},[272],{"type":52,"tag":89,"props":273,"children":275},{"href":274},"references\u002Fpolicies.md#token-rate-limiting",[276],{"type":58,"value":277},"Model Policies",{"type":52,"tag":115,"props":279,"children":280},{},[281,290,295],{"type":52,"tag":137,"props":282,"children":283},{},[284],{"type":52,"tag":258,"props":285,"children":287},{"className":286},[],[288],{"type":58,"value":289},"azure-openai-semantic-cache-lookup\u002Fstore",{"type":52,"tag":137,"props":291,"children":292},{},[293],{"type":58,"value":294},"60-80% cost savings",{"type":52,"tag":137,"props":296,"children":297},{},[298],{"type":52,"tag":89,"props":299,"children":301},{"href":300},"references\u002Fpolicies.md#semantic-caching",[302],{"type":58,"value":277},{"type":52,"tag":115,"props":304,"children":305},{},[306,315,320],{"type":52,"tag":137,"props":307,"children":308},{},[309],{"type":52,"tag":258,"props":310,"children":312},{"className":311},[],[313],{"type":58,"value":314},"azure-openai-emit-token-metric",{"type":52,"tag":137,"props":316,"children":317},{},[318],{"type":58,"value":319},"Observability",{"type":52,"tag":137,"props":321,"children":322},{},[323],{"type":52,"tag":89,"props":324,"children":326},{"href":325},"references\u002Fpolicies.md#token-metrics",[327],{"type":58,"value":277},{"type":52,"tag":115,"props":329,"children":330},{},[331,340,345],{"type":52,"tag":137,"props":332,"children":333},{},[334],{"type":52,"tag":258,"props":335,"children":337},{"className":336},[],[338],{"type":58,"value":339},"llm-content-safety",{"type":52,"tag":137,"props":341,"children":342},{},[343],{"type":58,"value":344},"Safety & compliance",{"type":52,"tag":137,"props":346,"children":347},{},[348],{"type":52,"tag":89,"props":349,"children":351},{"href":350},"references\u002Fpolicies.md#content-safety",[352],{"type":58,"value":353},"Agent Policies",{"type":52,"tag":115,"props":355,"children":356},{},[357,366,371],{"type":52,"tag":137,"props":358,"children":359},{},[360],{"type":52,"tag":258,"props":361,"children":363},{"className":362},[],[364],{"type":58,"value":365},"rate-limit-by-key",{"type":52,"tag":137,"props":367,"children":368},{},[369],{"type":58,"value":370},"MCP\u002Ftool protection",{"type":52,"tag":137,"props":372,"children":373},{},[374],{"type":52,"tag":89,"props":375,"children":377},{"href":376},"references\u002Fpolicies.md#request-rate-limiting",[378],{"type":58,"value":379},"Tool Policies",{"type":52,"tag":215,"props":381,"children":382},{},[],{"type":52,"tag":100,"props":384,"children":386},{"id":385},"get-gateway-details",[387],{"type":58,"value":388},"Get Gateway Details",{"type":52,"tag":390,"props":391,"children":396},"pre",{"className":392,"code":393,"language":394,"meta":395,"style":395},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Get gateway URL\naz apim show --name \u003Capim-name> --resource-group \u003Crg> --query \"gatewayUrl\" -o tsv\n\n# List backends (AI models)\naz apim backend list --service-name \u003Capim-name> --resource-group \u003Crg> \\\n  --query \"[].{id:name, url:url}\" -o table\n\n# Get subscription key\naz apim subscription keys list \\\n  --service-name \u003Capim-name> --resource-group \u003Crg> --subscription-id \u003Csub-id>\n","bash","",[397],{"type":52,"tag":258,"props":398,"children":399},{"__ignoreMap":395},[400,412,513,523,532,600,631,639,648,678],{"type":52,"tag":401,"props":402,"children":405},"span",{"class":403,"line":404},"line",1,[406],{"type":52,"tag":401,"props":407,"children":409},{"style":408},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[410],{"type":58,"value":411},"# Get gateway URL\n",{"type":52,"tag":401,"props":413,"children":415},{"class":403,"line":414},2,[416,422,428,433,438,444,449,455,460,465,469,474,479,483,488,493,498,503,508],{"type":52,"tag":401,"props":417,"children":419},{"style":418},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[420],{"type":58,"value":421},"az",{"type":52,"tag":401,"props":423,"children":425},{"style":424},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[426],{"type":58,"value":427}," apim",{"type":52,"tag":401,"props":429,"children":430},{"style":424},[431],{"type":58,"value":432}," show",{"type":52,"tag":401,"props":434,"children":435},{"style":424},[436],{"type":58,"value":437}," --name",{"type":52,"tag":401,"props":439,"children":441},{"style":440},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[442],{"type":58,"value":443}," \u003C",{"type":52,"tag":401,"props":445,"children":446},{"style":424},[447],{"type":58,"value":448},"apim-nam",{"type":52,"tag":401,"props":450,"children":452},{"style":451},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[453],{"type":58,"value":454},"e",{"type":52,"tag":401,"props":456,"children":457},{"style":440},[458],{"type":58,"value":459},">",{"type":52,"tag":401,"props":461,"children":462},{"style":424},[463],{"type":58,"value":464}," --resource-group",{"type":52,"tag":401,"props":466,"children":467},{"style":440},[468],{"type":58,"value":443},{"type":52,"tag":401,"props":470,"children":471},{"style":424},[472],{"type":58,"value":473},"r",{"type":52,"tag":401,"props":475,"children":476},{"style":451},[477],{"type":58,"value":478},"g",{"type":52,"tag":401,"props":480,"children":481},{"style":440},[482],{"type":58,"value":459},{"type":52,"tag":401,"props":484,"children":485},{"style":424},[486],{"type":58,"value":487}," --query",{"type":52,"tag":401,"props":489,"children":490},{"style":440},[491],{"type":58,"value":492}," \"",{"type":52,"tag":401,"props":494,"children":495},{"style":424},[496],{"type":58,"value":497},"gatewayUrl",{"type":52,"tag":401,"props":499,"children":500},{"style":440},[501],{"type":58,"value":502},"\"",{"type":52,"tag":401,"props":504,"children":505},{"style":424},[506],{"type":58,"value":507}," -o",{"type":52,"tag":401,"props":509,"children":510},{"style":424},[511],{"type":58,"value":512}," tsv\n",{"type":52,"tag":401,"props":514,"children":516},{"class":403,"line":515},3,[517],{"type":52,"tag":401,"props":518,"children":520},{"emptyLinePlaceholder":519},true,[521],{"type":58,"value":522},"\n",{"type":52,"tag":401,"props":524,"children":526},{"class":403,"line":525},4,[527],{"type":52,"tag":401,"props":528,"children":529},{"style":408},[530],{"type":58,"value":531},"# List backends (AI models)\n",{"type":52,"tag":401,"props":533,"children":535},{"class":403,"line":534},5,[536,540,544,549,554,559,563,567,571,575,579,583,587,591,595],{"type":52,"tag":401,"props":537,"children":538},{"style":418},[539],{"type":58,"value":421},{"type":52,"tag":401,"props":541,"children":542},{"style":424},[543],{"type":58,"value":427},{"type":52,"tag":401,"props":545,"children":546},{"style":424},[547],{"type":58,"value":548}," backend",{"type":52,"tag":401,"props":550,"children":551},{"style":424},[552],{"type":58,"value":553}," list",{"type":52,"tag":401,"props":555,"children":556},{"style":424},[557],{"type":58,"value":558}," --service-name",{"type":52,"tag":401,"props":560,"children":561},{"style":440},[562],{"type":58,"value":443},{"type":52,"tag":401,"props":564,"children":565},{"style":424},[566],{"type":58,"value":448},{"type":52,"tag":401,"props":568,"children":569},{"style":451},[570],{"type":58,"value":454},{"type":52,"tag":401,"props":572,"children":573},{"style":440},[574],{"type":58,"value":459},{"type":52,"tag":401,"props":576,"children":577},{"style":424},[578],{"type":58,"value":464},{"type":52,"tag":401,"props":580,"children":581},{"style":440},[582],{"type":58,"value":443},{"type":52,"tag":401,"props":584,"children":585},{"style":424},[586],{"type":58,"value":473},{"type":52,"tag":401,"props":588,"children":589},{"style":451},[590],{"type":58,"value":478},{"type":52,"tag":401,"props":592,"children":593},{"style":440},[594],{"type":58,"value":459},{"type":52,"tag":401,"props":596,"children":597},{"style":451},[598],{"type":58,"value":599}," \\\n",{"type":52,"tag":401,"props":601,"children":603},{"class":403,"line":602},6,[604,609,613,618,622,626],{"type":52,"tag":401,"props":605,"children":606},{"style":424},[607],{"type":58,"value":608},"  --query",{"type":52,"tag":401,"props":610,"children":611},{"style":440},[612],{"type":58,"value":492},{"type":52,"tag":401,"props":614,"children":615},{"style":424},[616],{"type":58,"value":617},"[].{id:name, url:url}",{"type":52,"tag":401,"props":619,"children":620},{"style":440},[621],{"type":58,"value":502},{"type":52,"tag":401,"props":623,"children":624},{"style":424},[625],{"type":58,"value":507},{"type":52,"tag":401,"props":627,"children":628},{"style":424},[629],{"type":58,"value":630}," table\n",{"type":52,"tag":401,"props":632,"children":634},{"class":403,"line":633},7,[635],{"type":52,"tag":401,"props":636,"children":637},{"emptyLinePlaceholder":519},[638],{"type":58,"value":522},{"type":52,"tag":401,"props":640,"children":642},{"class":403,"line":641},8,[643],{"type":52,"tag":401,"props":644,"children":645},{"style":408},[646],{"type":58,"value":647},"# Get subscription key\n",{"type":52,"tag":401,"props":649,"children":651},{"class":403,"line":650},9,[652,656,660,665,670,674],{"type":52,"tag":401,"props":653,"children":654},{"style":418},[655],{"type":58,"value":421},{"type":52,"tag":401,"props":657,"children":658},{"style":424},[659],{"type":58,"value":427},{"type":52,"tag":401,"props":661,"children":662},{"style":424},[663],{"type":58,"value":664}," subscription",{"type":52,"tag":401,"props":666,"children":667},{"style":424},[668],{"type":58,"value":669}," keys",{"type":52,"tag":401,"props":671,"children":672},{"style":424},[673],{"type":58,"value":553},{"type":52,"tag":401,"props":675,"children":676},{"style":451},[677],{"type":58,"value":599},{"type":52,"tag":401,"props":679,"children":681},{"class":403,"line":680},10,[682,687,691,695,699,703,707,711,715,719,723,728,732,737,742],{"type":52,"tag":401,"props":683,"children":684},{"style":424},[685],{"type":58,"value":686},"  --service-name",{"type":52,"tag":401,"props":688,"children":689},{"style":440},[690],{"type":58,"value":443},{"type":52,"tag":401,"props":692,"children":693},{"style":424},[694],{"type":58,"value":448},{"type":52,"tag":401,"props":696,"children":697},{"style":451},[698],{"type":58,"value":454},{"type":52,"tag":401,"props":700,"children":701},{"style":440},[702],{"type":58,"value":459},{"type":52,"tag":401,"props":704,"children":705},{"style":424},[706],{"type":58,"value":464},{"type":52,"tag":401,"props":708,"children":709},{"style":440},[710],{"type":58,"value":443},{"type":52,"tag":401,"props":712,"children":713},{"style":424},[714],{"type":58,"value":473},{"type":52,"tag":401,"props":716,"children":717},{"style":451},[718],{"type":58,"value":478},{"type":52,"tag":401,"props":720,"children":721},{"style":440},[722],{"type":58,"value":459},{"type":52,"tag":401,"props":724,"children":725},{"style":424},[726],{"type":58,"value":727}," --subscription-id",{"type":52,"tag":401,"props":729,"children":730},{"style":440},[731],{"type":58,"value":443},{"type":52,"tag":401,"props":733,"children":734},{"style":424},[735],{"type":58,"value":736},"sub-i",{"type":52,"tag":401,"props":738,"children":739},{"style":451},[740],{"type":58,"value":741},"d",{"type":52,"tag":401,"props":743,"children":744},{"style":440},[745],{"type":58,"value":746},">\n",{"type":52,"tag":215,"props":748,"children":749},{},[],{"type":52,"tag":100,"props":751,"children":753},{"id":752},"test-ai-endpoint",[754],{"type":58,"value":755},"Test AI Endpoint",{"type":52,"tag":390,"props":757,"children":759},{"className":392,"code":758,"language":394,"meta":395,"style":395},"GATEWAY_URL=$(az apim show --name \u003Capim-name> --resource-group \u003Crg> --query \"gatewayUrl\" -o tsv)\n\ncurl -X POST \"${GATEWAY_URL}\u002Fopenai\u002Fdeployments\u002F\u003Cdeployment>\u002Fchat\u002Fcompletions?api-version=2024-02-01\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"Ocp-Apim-Subscription-Key: \u003Ckey>\" \\\n  -d '{\"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}], \"max_tokens\": 100}'\n",[760],{"type":52,"tag":258,"props":761,"children":762},{"__ignoreMap":395},[763,858,865,910,935,959],{"type":52,"tag":401,"props":764,"children":765},{"class":403,"line":404},[766,771,776,780,784,788,792,796,800,804,808,812,816,820,824,828,832,836,840,844,848,853],{"type":52,"tag":401,"props":767,"children":768},{"style":451},[769],{"type":58,"value":770},"GATEWAY_URL",{"type":52,"tag":401,"props":772,"children":773},{"style":440},[774],{"type":58,"value":775},"=$(",{"type":52,"tag":401,"props":777,"children":778},{"style":418},[779],{"type":58,"value":421},{"type":52,"tag":401,"props":781,"children":782},{"style":424},[783],{"type":58,"value":427},{"type":52,"tag":401,"props":785,"children":786},{"style":424},[787],{"type":58,"value":432},{"type":52,"tag":401,"props":789,"children":790},{"style":424},[791],{"type":58,"value":437},{"type":52,"tag":401,"props":793,"children":794},{"style":440},[795],{"type":58,"value":443},{"type":52,"tag":401,"props":797,"children":798},{"style":424},[799],{"type":58,"value":448},{"type":52,"tag":401,"props":801,"children":802},{"style":451},[803],{"type":58,"value":454},{"type":52,"tag":401,"props":805,"children":806},{"style":440},[807],{"type":58,"value":459},{"type":52,"tag":401,"props":809,"children":810},{"style":424},[811],{"type":58,"value":464},{"type":52,"tag":401,"props":813,"children":814},{"style":440},[815],{"type":58,"value":443},{"type":52,"tag":401,"props":817,"children":818},{"style":424},[819],{"type":58,"value":473},{"type":52,"tag":401,"props":821,"children":822},{"style":451},[823],{"type":58,"value":478},{"type":52,"tag":401,"props":825,"children":826},{"style":440},[827],{"type":58,"value":459},{"type":52,"tag":401,"props":829,"children":830},{"style":424},[831],{"type":58,"value":487},{"type":52,"tag":401,"props":833,"children":834},{"style":440},[835],{"type":58,"value":492},{"type":52,"tag":401,"props":837,"children":838},{"style":424},[839],{"type":58,"value":497},{"type":52,"tag":401,"props":841,"children":842},{"style":440},[843],{"type":58,"value":502},{"type":52,"tag":401,"props":845,"children":846},{"style":424},[847],{"type":58,"value":507},{"type":52,"tag":401,"props":849,"children":850},{"style":424},[851],{"type":58,"value":852}," tsv",{"type":52,"tag":401,"props":854,"children":855},{"style":440},[856],{"type":58,"value":857},")\n",{"type":52,"tag":401,"props":859,"children":860},{"class":403,"line":414},[861],{"type":52,"tag":401,"props":862,"children":863},{"emptyLinePlaceholder":519},[864],{"type":58,"value":522},{"type":52,"tag":401,"props":866,"children":867},{"class":403,"line":515},[868,873,878,883,888,892,897,902,906],{"type":52,"tag":401,"props":869,"children":870},{"style":418},[871],{"type":58,"value":872},"curl",{"type":52,"tag":401,"props":874,"children":875},{"style":424},[876],{"type":58,"value":877}," -X",{"type":52,"tag":401,"props":879,"children":880},{"style":424},[881],{"type":58,"value":882}," POST",{"type":52,"tag":401,"props":884,"children":885},{"style":440},[886],{"type":58,"value":887}," \"${",{"type":52,"tag":401,"props":889,"children":890},{"style":451},[891],{"type":58,"value":770},{"type":52,"tag":401,"props":893,"children":894},{"style":440},[895],{"type":58,"value":896},"}",{"type":52,"tag":401,"props":898,"children":899},{"style":424},[900],{"type":58,"value":901},"\u002Fopenai\u002Fdeployments\u002F\u003Cdeployment>\u002Fchat\u002Fcompletions?api-version=2024-02-01",{"type":52,"tag":401,"props":903,"children":904},{"style":440},[905],{"type":58,"value":502},{"type":52,"tag":401,"props":907,"children":908},{"style":451},[909],{"type":58,"value":599},{"type":52,"tag":401,"props":911,"children":912},{"class":403,"line":525},[913,918,922,927,931],{"type":52,"tag":401,"props":914,"children":915},{"style":424},[916],{"type":58,"value":917},"  -H",{"type":52,"tag":401,"props":919,"children":920},{"style":440},[921],{"type":58,"value":492},{"type":52,"tag":401,"props":923,"children":924},{"style":424},[925],{"type":58,"value":926},"Content-Type: application\u002Fjson",{"type":52,"tag":401,"props":928,"children":929},{"style":440},[930],{"type":58,"value":502},{"type":52,"tag":401,"props":932,"children":933},{"style":451},[934],{"type":58,"value":599},{"type":52,"tag":401,"props":936,"children":937},{"class":403,"line":534},[938,942,946,951,955],{"type":52,"tag":401,"props":939,"children":940},{"style":424},[941],{"type":58,"value":917},{"type":52,"tag":401,"props":943,"children":944},{"style":440},[945],{"type":58,"value":492},{"type":52,"tag":401,"props":947,"children":948},{"style":424},[949],{"type":58,"value":950},"Ocp-Apim-Subscription-Key: \u003Ckey>",{"type":52,"tag":401,"props":952,"children":953},{"style":440},[954],{"type":58,"value":502},{"type":52,"tag":401,"props":956,"children":957},{"style":451},[958],{"type":58,"value":599},{"type":52,"tag":401,"props":960,"children":961},{"class":403,"line":602},[962,967,972,977],{"type":52,"tag":401,"props":963,"children":964},{"style":424},[965],{"type":58,"value":966},"  -d",{"type":52,"tag":401,"props":968,"children":969},{"style":440},[970],{"type":58,"value":971}," '",{"type":52,"tag":401,"props":973,"children":974},{"style":424},[975],{"type":58,"value":976},"{\"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}], \"max_tokens\": 100}",{"type":52,"tag":401,"props":978,"children":979},{"style":440},[980],{"type":58,"value":981},"'\n",{"type":52,"tag":215,"props":983,"children":984},{},[],{"type":52,"tag":100,"props":986,"children":988},{"id":987},"common-tasks",[989],{"type":58,"value":990},"Common Tasks",{"type":52,"tag":992,"props":993,"children":995},"h3",{"id":994},"add-ai-backend",[996],{"type":58,"value":997},"Add AI Backend",{"type":52,"tag":61,"props":999,"children":1000},{},[1001,1003,1009],{"type":58,"value":1002},"See ",{"type":52,"tag":89,"props":1004,"children":1006},{"href":1005},"references\u002Fpatterns.md#pattern-1-add-ai-model-backend",[1007],{"type":58,"value":1008},"references\u002Fpatterns.md",{"type":58,"value":1010}," for full steps.",{"type":52,"tag":390,"props":1012,"children":1014},{"className":392,"code":1013,"language":394,"meta":395,"style":395},"# Discover AI resources\naz cognitiveservices account list --query \"[?kind=='OpenAI']\" -o table\n\n# Create backend\naz apim backend create --service-name \u003Capim> --resource-group \u003Crg> \\\n  --backend-id openai-backend --protocol http --url \"https:\u002F\u002F\u003Caoai>.openai.azure.com\u002Fopenai\"\n\n# Grant access (managed identity)\naz role assignment create --assignee \u003Capim-principal-id> \\\n  --role \"Cognitive Services User\" --scope \u003Caoai-resource-id>\n",[1015],{"type":52,"tag":258,"props":1016,"children":1017},{"__ignoreMap":395},[1018,1026,1072,1079,1087,1153,1195,1202,1210,1257],{"type":52,"tag":401,"props":1019,"children":1020},{"class":403,"line":404},[1021],{"type":52,"tag":401,"props":1022,"children":1023},{"style":408},[1024],{"type":58,"value":1025},"# Discover AI resources\n",{"type":52,"tag":401,"props":1027,"children":1028},{"class":403,"line":414},[1029,1033,1038,1043,1047,1051,1055,1060,1064,1068],{"type":52,"tag":401,"props":1030,"children":1031},{"style":418},[1032],{"type":58,"value":421},{"type":52,"tag":401,"props":1034,"children":1035},{"style":424},[1036],{"type":58,"value":1037}," cognitiveservices",{"type":52,"tag":401,"props":1039,"children":1040},{"style":424},[1041],{"type":58,"value":1042}," account",{"type":52,"tag":401,"props":1044,"children":1045},{"style":424},[1046],{"type":58,"value":553},{"type":52,"tag":401,"props":1048,"children":1049},{"style":424},[1050],{"type":58,"value":487},{"type":52,"tag":401,"props":1052,"children":1053},{"style":440},[1054],{"type":58,"value":492},{"type":52,"tag":401,"props":1056,"children":1057},{"style":424},[1058],{"type":58,"value":1059},"[?kind=='OpenAI']",{"type":52,"tag":401,"props":1061,"children":1062},{"style":440},[1063],{"type":58,"value":502},{"type":52,"tag":401,"props":1065,"children":1066},{"style":424},[1067],{"type":58,"value":507},{"type":52,"tag":401,"props":1069,"children":1070},{"style":424},[1071],{"type":58,"value":630},{"type":52,"tag":401,"props":1073,"children":1074},{"class":403,"line":515},[1075],{"type":52,"tag":401,"props":1076,"children":1077},{"emptyLinePlaceholder":519},[1078],{"type":58,"value":522},{"type":52,"tag":401,"props":1080,"children":1081},{"class":403,"line":525},[1082],{"type":52,"tag":401,"props":1083,"children":1084},{"style":408},[1085],{"type":58,"value":1086},"# Create backend\n",{"type":52,"tag":401,"props":1088,"children":1089},{"class":403,"line":534},[1090,1094,1098,1102,1107,1111,1115,1120,1125,1129,1133,1137,1141,1145,1149],{"type":52,"tag":401,"props":1091,"children":1092},{"style":418},[1093],{"type":58,"value":421},{"type":52,"tag":401,"props":1095,"children":1096},{"style":424},[1097],{"type":58,"value":427},{"type":52,"tag":401,"props":1099,"children":1100},{"style":424},[1101],{"type":58,"value":548},{"type":52,"tag":401,"props":1103,"children":1104},{"style":424},[1105],{"type":58,"value":1106}," create",{"type":52,"tag":401,"props":1108,"children":1109},{"style":424},[1110],{"type":58,"value":558},{"type":52,"tag":401,"props":1112,"children":1113},{"style":440},[1114],{"type":58,"value":443},{"type":52,"tag":401,"props":1116,"children":1117},{"style":424},[1118],{"type":58,"value":1119},"api",{"type":52,"tag":401,"props":1121,"children":1122},{"style":451},[1123],{"type":58,"value":1124},"m",{"type":52,"tag":401,"props":1126,"children":1127},{"style":440},[1128],{"type":58,"value":459},{"type":52,"tag":401,"props":1130,"children":1131},{"style":424},[1132],{"type":58,"value":464},{"type":52,"tag":401,"props":1134,"children":1135},{"style":440},[1136],{"type":58,"value":443},{"type":52,"tag":401,"props":1138,"children":1139},{"style":424},[1140],{"type":58,"value":473},{"type":52,"tag":401,"props":1142,"children":1143},{"style":451},[1144],{"type":58,"value":478},{"type":52,"tag":401,"props":1146,"children":1147},{"style":440},[1148],{"type":58,"value":459},{"type":52,"tag":401,"props":1150,"children":1151},{"style":451},[1152],{"type":58,"value":599},{"type":52,"tag":401,"props":1154,"children":1155},{"class":403,"line":602},[1156,1161,1166,1171,1176,1181,1185,1190],{"type":52,"tag":401,"props":1157,"children":1158},{"style":424},[1159],{"type":58,"value":1160},"  --backend-id",{"type":52,"tag":401,"props":1162,"children":1163},{"style":424},[1164],{"type":58,"value":1165}," openai-backend",{"type":52,"tag":401,"props":1167,"children":1168},{"style":424},[1169],{"type":58,"value":1170}," --protocol",{"type":52,"tag":401,"props":1172,"children":1173},{"style":424},[1174],{"type":58,"value":1175}," http",{"type":52,"tag":401,"props":1177,"children":1178},{"style":424},[1179],{"type":58,"value":1180}," --url",{"type":52,"tag":401,"props":1182,"children":1183},{"style":440},[1184],{"type":58,"value":492},{"type":52,"tag":401,"props":1186,"children":1187},{"style":424},[1188],{"type":58,"value":1189},"https:\u002F\u002F\u003Caoai>.openai.azure.com\u002Fopenai",{"type":52,"tag":401,"props":1191,"children":1192},{"style":440},[1193],{"type":58,"value":1194},"\"\n",{"type":52,"tag":401,"props":1196,"children":1197},{"class":403,"line":633},[1198],{"type":52,"tag":401,"props":1199,"children":1200},{"emptyLinePlaceholder":519},[1201],{"type":58,"value":522},{"type":52,"tag":401,"props":1203,"children":1204},{"class":403,"line":641},[1205],{"type":52,"tag":401,"props":1206,"children":1207},{"style":408},[1208],{"type":58,"value":1209},"# Grant access (managed identity)\n",{"type":52,"tag":401,"props":1211,"children":1212},{"class":403,"line":650},[1213,1217,1222,1227,1231,1236,1240,1245,1249,1253],{"type":52,"tag":401,"props":1214,"children":1215},{"style":418},[1216],{"type":58,"value":421},{"type":52,"tag":401,"props":1218,"children":1219},{"style":424},[1220],{"type":58,"value":1221}," role",{"type":52,"tag":401,"props":1223,"children":1224},{"style":424},[1225],{"type":58,"value":1226}," assignment",{"type":52,"tag":401,"props":1228,"children":1229},{"style":424},[1230],{"type":58,"value":1106},{"type":52,"tag":401,"props":1232,"children":1233},{"style":424},[1234],{"type":58,"value":1235}," --assignee",{"type":52,"tag":401,"props":1237,"children":1238},{"style":440},[1239],{"type":58,"value":443},{"type":52,"tag":401,"props":1241,"children":1242},{"style":424},[1243],{"type":58,"value":1244},"apim-principal-i",{"type":52,"tag":401,"props":1246,"children":1247},{"style":451},[1248],{"type":58,"value":741},{"type":52,"tag":401,"props":1250,"children":1251},{"style":440},[1252],{"type":58,"value":459},{"type":52,"tag":401,"props":1254,"children":1255},{"style":451},[1256],{"type":58,"value":599},{"type":52,"tag":401,"props":1258,"children":1259},{"class":403,"line":680},[1260,1265,1269,1274,1278,1283,1287,1292,1296],{"type":52,"tag":401,"props":1261,"children":1262},{"style":424},[1263],{"type":58,"value":1264},"  --role",{"type":52,"tag":401,"props":1266,"children":1267},{"style":440},[1268],{"type":58,"value":492},{"type":52,"tag":401,"props":1270,"children":1271},{"style":424},[1272],{"type":58,"value":1273},"Cognitive Services User",{"type":52,"tag":401,"props":1275,"children":1276},{"style":440},[1277],{"type":58,"value":502},{"type":52,"tag":401,"props":1279,"children":1280},{"style":424},[1281],{"type":58,"value":1282}," --scope",{"type":52,"tag":401,"props":1284,"children":1285},{"style":440},[1286],{"type":58,"value":443},{"type":52,"tag":401,"props":1288,"children":1289},{"style":424},[1290],{"type":58,"value":1291},"aoai-resource-i",{"type":52,"tag":401,"props":1293,"children":1294},{"style":451},[1295],{"type":58,"value":741},{"type":52,"tag":401,"props":1297,"children":1298},{"style":440},[1299],{"type":58,"value":746},{"type":52,"tag":992,"props":1301,"children":1303},{"id":1302},"apply-ai-governance-policy",[1304],{"type":58,"value":1305},"Apply AI Governance Policy",{"type":52,"tag":61,"props":1307,"children":1308},{},[1309,1311,1317],{"type":58,"value":1310},"Recommended policy order in ",{"type":52,"tag":258,"props":1312,"children":1314},{"className":1313},[],[1315],{"type":58,"value":1316},"\u003Cinbound>",{"type":58,"value":1318},":",{"type":52,"tag":1320,"props":1321,"children":1322},"ol",{},[1323,1334,1344,1354,1364,1374],{"type":52,"tag":1324,"props":1325,"children":1326},"li",{},[1327,1332],{"type":52,"tag":74,"props":1328,"children":1329},{},[1330],{"type":58,"value":1331},"Authentication",{"type":58,"value":1333}," - Managed identity to backend",{"type":52,"tag":1324,"props":1335,"children":1336},{},[1337,1342],{"type":52,"tag":74,"props":1338,"children":1339},{},[1340],{"type":58,"value":1341},"Semantic Cache Lookup",{"type":58,"value":1343}," - Check cache before calling AI",{"type":52,"tag":1324,"props":1345,"children":1346},{},[1347,1352],{"type":52,"tag":74,"props":1348,"children":1349},{},[1350],{"type":58,"value":1351},"Token Limits",{"type":58,"value":1353}," - Cost control",{"type":52,"tag":1324,"props":1355,"children":1356},{},[1357,1362],{"type":52,"tag":74,"props":1358,"children":1359},{},[1360],{"type":58,"value":1361},"Content Safety",{"type":58,"value":1363}," - Filter harmful content",{"type":52,"tag":1324,"props":1365,"children":1366},{},[1367,1372],{"type":52,"tag":74,"props":1368,"children":1369},{},[1370],{"type":58,"value":1371},"Backend Selection",{"type":58,"value":1373}," - Load balancing",{"type":52,"tag":1324,"props":1375,"children":1376},{},[1377,1382],{"type":52,"tag":74,"props":1378,"children":1379},{},[1380],{"type":58,"value":1381},"Metrics",{"type":58,"value":1383}," - Token usage tracking",{"type":52,"tag":61,"props":1385,"children":1386},{},[1387,1388,1394],{"type":58,"value":1002},{"type":52,"tag":89,"props":1389,"children":1391},{"href":1390},"references\u002Fpolicies.md#combining-policies",[1392],{"type":58,"value":1393},"references\u002Fpolicies.md",{"type":58,"value":1395}," for complete example.",{"type":52,"tag":215,"props":1397,"children":1398},{},[],{"type":52,"tag":100,"props":1400,"children":1402},{"id":1401},"troubleshooting",[1403],{"type":58,"value":1404},"Troubleshooting",{"type":52,"tag":107,"props":1406,"children":1407},{},[1408,1424],{"type":52,"tag":111,"props":1409,"children":1410},{},[1411],{"type":52,"tag":115,"props":1412,"children":1413},{},[1414,1419],{"type":52,"tag":119,"props":1415,"children":1416},{},[1417],{"type":58,"value":1418},"Issue",{"type":52,"tag":119,"props":1420,"children":1421},{},[1422],{"type":58,"value":1423},"Solution",{"type":52,"tag":130,"props":1425,"children":1426},{},[1427,1448,1469,1482],{"type":52,"tag":115,"props":1428,"children":1429},{},[1430,1435],{"type":52,"tag":137,"props":1431,"children":1432},{},[1433],{"type":58,"value":1434},"Token limit 429",{"type":52,"tag":137,"props":1436,"children":1437},{},[1438,1440,1446],{"type":58,"value":1439},"Increase ",{"type":52,"tag":258,"props":1441,"children":1443},{"className":1442},[],[1444],{"type":58,"value":1445},"tokens-per-minute",{"type":58,"value":1447}," or add load balancing",{"type":52,"tag":115,"props":1449,"children":1450},{},[1451,1456],{"type":52,"tag":137,"props":1452,"children":1453},{},[1454],{"type":58,"value":1455},"No cache hits",{"type":52,"tag":137,"props":1457,"children":1458},{},[1459,1461,1467],{"type":58,"value":1460},"Lower ",{"type":52,"tag":258,"props":1462,"children":1464},{"className":1463},[],[1465],{"type":58,"value":1466},"score-threshold",{"type":58,"value":1468}," to 0.7",{"type":52,"tag":115,"props":1470,"children":1471},{},[1472,1477],{"type":52,"tag":137,"props":1473,"children":1474},{},[1475],{"type":58,"value":1476},"Content false positives",{"type":52,"tag":137,"props":1478,"children":1479},{},[1480],{"type":58,"value":1481},"Increase category thresholds (5-6)",{"type":52,"tag":115,"props":1483,"children":1484},{},[1485,1490],{"type":52,"tag":137,"props":1486,"children":1487},{},[1488],{"type":58,"value":1489},"Backend auth 401",{"type":52,"tag":137,"props":1491,"children":1492},{},[1493],{"type":58,"value":1494},"Grant APIM \"Cognitive Services User\" role",{"type":52,"tag":61,"props":1496,"children":1497},{},[1498,1499,1504],{"type":58,"value":1002},{"type":52,"tag":89,"props":1500,"children":1502},{"href":1501},"references\u002Ftroubleshooting.md",[1503],{"type":58,"value":1501},{"type":58,"value":1505}," for details.",{"type":52,"tag":215,"props":1507,"children":1508},{},[],{"type":52,"tag":100,"props":1510,"children":1512},{"id":1511},"references",[1513],{"type":58,"value":1514},"References",{"type":52,"tag":1516,"props":1517,"children":1518},"ul",{},[1519,1532,1545,1557,1567],{"type":52,"tag":1324,"props":1520,"children":1521},{},[1522,1530],{"type":52,"tag":89,"props":1523,"children":1524},{"href":1393},[1525],{"type":52,"tag":74,"props":1526,"children":1527},{},[1528],{"type":58,"value":1529},"Detailed Policies",{"type":58,"value":1531}," - Full policy examples",{"type":52,"tag":1324,"props":1533,"children":1534},{},[1535,1543],{"type":52,"tag":89,"props":1536,"children":1537},{"href":1008},[1538],{"type":52,"tag":74,"props":1539,"children":1540},{},[1541],{"type":58,"value":1542},"Configuration Patterns",{"type":58,"value":1544}," - Step-by-step patterns",{"type":52,"tag":1324,"props":1546,"children":1547},{},[1548,1555],{"type":52,"tag":89,"props":1549,"children":1550},{"href":1501},[1551],{"type":52,"tag":74,"props":1552,"children":1553},{},[1554],{"type":58,"value":1404},{"type":58,"value":1556}," - Common issues",{"type":52,"tag":1324,"props":1558,"children":1559},{},[1560],{"type":52,"tag":89,"props":1561,"children":1564},{"href":1562,"rel":1563},"https:\u002F\u002Fgithub.com\u002FAzure-Samples\u002FAI-Gateway",[93],[1565],{"type":58,"value":1566},"AI-Gateway Samples",{"type":52,"tag":1324,"props":1568,"children":1569},{},[1570],{"type":52,"tag":89,"props":1571,"children":1574},{"href":1572,"rel":1573},"https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-management\u002Fgenai-gateway-capabilities",[93],[1575],{"type":58,"value":1576},"GenAI Gateway Docs",{"type":52,"tag":100,"props":1578,"children":1580},{"id":1579},"sdk-quick-references",[1581],{"type":58,"value":1582},"SDK Quick References",{"type":52,"tag":1516,"props":1584,"children":1585},{},[1586,1609],{"type":52,"tag":1324,"props":1587,"children":1588},{},[1589,1593,1595,1601,1603],{"type":52,"tag":74,"props":1590,"children":1591},{},[1592],{"type":58,"value":1361},{"type":58,"value":1594},": ",{"type":52,"tag":89,"props":1596,"children":1598},{"href":1597},"references\u002Fsdk\u002Fazure-ai-contentsafety-py.md",[1599],{"type":58,"value":1600},"Python",{"type":58,"value":1602}," | ",{"type":52,"tag":89,"props":1604,"children":1606},{"href":1605},"references\u002Fsdk\u002Fazure-ai-contentsafety-ts.md",[1607],{"type":58,"value":1608},"TypeScript",{"type":52,"tag":1324,"props":1610,"children":1611},{},[1612,1617,1618,1623,1624],{"type":52,"tag":74,"props":1613,"children":1614},{},[1615],{"type":58,"value":1616},"API Management",{"type":58,"value":1594},{"type":52,"tag":89,"props":1619,"children":1621},{"href":1620},"references\u002Fsdk\u002Fazure-mgmt-apimanagement-py.md",[1622],{"type":58,"value":1600},{"type":58,"value":1602},{"type":52,"tag":89,"props":1625,"children":1627},{"href":1626},"references\u002Fsdk\u002Fazure-mgmt-apimanagement-dotnet.md",[1628],{"type":58,"value":1629},".NET",{"type":52,"tag":1631,"props":1632,"children":1633},"style",{},[1634],{"type":58,"value":1635},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1637,"total":1820},[1638,1660,1678,1699,1710,1726,1737,1748,1763,1777,1796,1808],{"slug":1639,"name":1639,"fn":1640,"description":1641,"org":1642,"tags":1643,"stars":1657,"repoUrl":1658,"updatedAt":1659},"rushstack-best-practices","manage Rush monorepos with best practices","Provides best practices and guidance for working with Rush monorepos. Use when the user is working in a Rush-based repository, asks about Rush commands (install, update, build, rebuild), needs help with project selection, dependency management, build caching, subspace configuration, or troubleshooting Rush-specific issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1644,1647,1650,1651,1654],{"name":1645,"slug":1646,"type":15},"Engineering","engineering",{"name":1648,"slug":1649,"type":15},"Local Development","local-development",{"name":9,"slug":8,"type":15},{"name":1652,"slug":1653,"type":15},"Project Management","project-management",{"name":1655,"slug":1656,"type":15},"Rush","rush",6484,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Frushstack","2026-04-06T18:34:44.965032",{"slug":1661,"name":1661,"fn":1662,"description":1663,"org":1664,"tags":1665,"stars":1675,"repoUrl":1676,"updatedAt":1677},"azure-ai-agents-persistent-dotnet","build AI agents with Azure .NET SDK","Azure AI Agents Persistent SDK for .NET. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools. Use for agent CRUD, conversation threads, streaming responses, function calling, file search, and code interpreter. Triggers: \"PersistentAgentsClient\", \"persistent agents\", \"agent threads\", \"agent runs\", \"streaming agents\", \"function calling agents .NET\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1666,1668,1671,1672],{"name":1629,"slug":1667,"type":15},"net",{"name":1669,"slug":1670,"type":15},"Agents","agents",{"name":17,"slug":18,"type":15},{"name":1673,"slug":1674,"type":15},"LLM","llm",2804,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","2026-07-03T16:32:10.297433",{"slug":1679,"name":1679,"fn":1680,"description":1681,"org":1682,"tags":1683,"stars":1675,"repoUrl":1676,"updatedAt":1698},"azure-ai-anomalydetector-java","build anomaly detection applications with Java","Build anomaly detection applications with Azure AI Anomaly Detector SDK for Java. Use when implementing univariate\u002Fmultivariate anomaly detection, time-series analysis, or AI-powered monitoring.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1684,1687,1688,1691,1694,1695],{"name":1685,"slug":1686,"type":15},"Analytics","analytics",{"name":17,"slug":18,"type":15},{"name":1689,"slug":1690,"type":15},"Data Analysis","data-analysis",{"name":1692,"slug":1693,"type":15},"Java","java",{"name":9,"slug":8,"type":15},{"name":1696,"slug":1697,"type":15},"Monitoring","monitoring","2026-05-13T06:14:16.261754",{"slug":1700,"name":1700,"fn":1701,"description":1702,"org":1703,"tags":1704,"stars":1675,"repoUrl":1676,"updatedAt":1709},"azure-ai-contentsafety-java","build content moderation applications with Azure AI","Build content moderation applications with Azure AI Content Safety SDK for Java. Use when implementing text\u002Fimage analysis, blocklist management, or harm detection for hate, violence, sexual content, and self-harm.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1705,1706,1707,1708],{"name":23,"slug":24,"type":15},{"name":17,"slug":18,"type":15},{"name":1692,"slug":1693,"type":15},{"name":13,"slug":14,"type":15},"2026-07-07T06:53:31.293235",{"slug":1711,"name":1711,"fn":1712,"description":1713,"org":1714,"tags":1715,"stars":1675,"repoUrl":1676,"updatedAt":1725},"azure-ai-contentsafety-py","detect harmful content with Azure AI Content Safety","Azure AI Content Safety SDK for Python. Use for detecting harmful content in text and images with multi-severity classification.\nTriggers: \"azure-ai-contentsafety\", \"ContentSafetyClient\", \"content moderation\", \"harmful content\", \"text analysis\", \"image analysis\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1716,1717,1720,1721,1722,1724],{"name":17,"slug":18,"type":15},{"name":1718,"slug":1719,"type":15},"Compliance","compliance",{"name":1673,"slug":1674,"type":15},{"name":9,"slug":8,"type":15},{"name":1600,"slug":1723,"type":15},"python",{"name":13,"slug":14,"type":15},"2026-07-18T05:14:23.017504",{"slug":1727,"name":1727,"fn":1728,"description":1729,"org":1730,"tags":1731,"stars":1675,"repoUrl":1676,"updatedAt":1736},"azure-ai-language-conversations-py","implement conversational language understanding with Python","Implement Conversational Language Understanding (CLU) using the azure-ai-language-conversations Python SDK. Use when working with ConversationAnalysisClient to analyze conversation intent and entities, building NLP features, or integrating language understanding into applications.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1732,1733,1734,1735],{"name":1685,"slug":1686,"type":15},{"name":17,"slug":18,"type":15},{"name":1673,"slug":1674,"type":15},{"name":1600,"slug":1723,"type":15},"2026-07-31T05:54:29.068751",{"slug":1738,"name":1738,"fn":1739,"description":1740,"org":1741,"tags":1742,"stars":1675,"repoUrl":1676,"updatedAt":1747},"azure-ai-translation-text-py","translate text using Azure AI services","Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.\nTriggers: \"text translation\", \"translator\", \"translate text\", \"transliterate\", \"TextTranslationClient\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1743,1744,1745,1746],{"name":26,"slug":27,"type":15},{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1600,"slug":1723,"type":15},"2026-07-18T05:14:16.988376",{"slug":1749,"name":1749,"fn":1750,"description":1751,"org":1752,"tags":1753,"stars":1675,"repoUrl":1676,"updatedAt":1762},"azure-ai-vision-imageanalysis-py","analyze images with Azure AI Vision","Azure AI Vision Image Analysis SDK for captions, tags, objects, OCR, people detection, and smart cropping. Use for computer vision and image understanding tasks.\nTriggers: \"image analysis\", \"computer vision\", \"OCR\", \"object detection\", \"ImageAnalysisClient\", \"image caption\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1754,1755,1758,1761],{"name":17,"slug":18,"type":15},{"name":1756,"slug":1757,"type":15},"Computer Vision","computer-vision",{"name":1759,"slug":1760,"type":15},"Images","images",{"name":1600,"slug":1723,"type":15},"2026-07-18T05:14:18.007737",{"slug":1764,"name":1764,"fn":1765,"description":1766,"org":1767,"tags":1768,"stars":1675,"repoUrl":1676,"updatedAt":1776},"azure-appconfiguration-java","manage configuration with Azure App Configuration","Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots.\nTriggers: \"ConfigurationClient java\", \"app configuration java\", \"feature flag java\", \"configuration setting java\", \"azure config java\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1769,1770,1772,1775],{"name":17,"slug":18,"type":15},{"name":192,"slug":1771,"type":15},"configuration",{"name":1773,"slug":1774,"type":15},"Feature Flags","feature-flags",{"name":1692,"slug":1693,"type":15},"2026-07-03T16:32:01.278468",{"slug":1778,"name":1778,"fn":1779,"description":1780,"org":1781,"tags":1782,"stars":1675,"repoUrl":1676,"updatedAt":1795},"azure-cosmos-rust","build applications with Azure Cosmos DB","Azure Cosmos DB library for Rust (NoSQL API). Document CRUD, containers, and globally distributed data.\nTriggers: \"cosmos db rust\", \"CosmosClient rust\", \"document crud rust\", \"NoSQL rust\", \"partition key rust\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1783,1786,1789,1792],{"name":1784,"slug":1785,"type":15},"Cosmos DB","cosmos-db",{"name":1787,"slug":1788,"type":15},"Database","database",{"name":1790,"slug":1791,"type":15},"NoSQL","nosql",{"name":1793,"slug":1794,"type":15},"Rust","rust","2026-07-31T05:54:27.021432",{"slug":1797,"name":1797,"fn":1779,"description":1798,"org":1799,"tags":1800,"stars":1675,"repoUrl":1676,"updatedAt":1807},"azure-cosmos-ts","Azure Cosmos DB JavaScript\u002FTypeScript SDK (@azure\u002Fcosmos) for data plane operations. Use for CRUD operations on documents, queries, bulk operations, and container management. Triggers: \"Cosmos DB\", \"@azure\u002Fcosmos\", \"CosmosClient\", \"document CRUD\", \"NoSQL queries\", \"bulk operations\", \"partition key\", \"container.items\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1801,1802,1803,1804,1805],{"name":1784,"slug":1785,"type":15},{"name":1787,"slug":1788,"type":15},{"name":9,"slug":8,"type":15},{"name":1790,"slug":1791,"type":15},{"name":1608,"slug":1806,"type":15},"typescript","2026-07-03T16:31:19.368382",{"slug":1809,"name":1809,"fn":1810,"description":1811,"org":1812,"tags":1813,"stars":1675,"repoUrl":1676,"updatedAt":1819},"azure-data-tables-java","build table storage applications with Java","Build table storage applications with Azure Tables SDK for Java. Use when working with Azure Table Storage or Cosmos DB Table API for NoSQL key-value data, schemaless storage, or structured data at scale.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1814,1815,1816,1817,1818],{"name":17,"slug":18,"type":15},{"name":1784,"slug":1785,"type":15},{"name":1787,"slug":1788,"type":15},{"name":1692,"slug":1693,"type":15},{"name":1790,"slug":1791,"type":15},"2026-05-13T06:14:17.582229",267,{"items":1822,"total":1931},[1823,1841,1852,1871,1880,1897,1913],{"slug":1824,"name":1824,"fn":1825,"description":1826,"org":1827,"tags":1828,"stars":31,"repoUrl":32,"updatedAt":1840},"airunway-aks-setup","set up AI Runway on Azure Kubernetes Service","Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, controller install, GPU assessment, provider setup, and first deployment. WHEN: \"setup AI Runway\", \"onboard AKS cluster\", \"install AI Runway\", \"airunway setup\", \"deploy model to AKS\", \"GPU inference on AKS\", \"KAITO setup on AKS\", \"run LLM on AKS\", \"vLLM on AKS\", \"set up model serving on AKS\", \"AI Runway controller\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1829,1830,1831,1834,1837],{"name":23,"slug":24,"type":15},{"name":17,"slug":18,"type":15},{"name":1832,"slug":1833,"type":15},"Deployment","deployment",{"name":1835,"slug":1836,"type":15},"Kubernetes","kubernetes",{"name":1838,"slug":1839,"type":15},"Runway","runway","2026-07-31T05:56:13.054971",{"slug":1842,"name":1842,"fn":1843,"description":1844,"org":1845,"tags":1846,"stars":31,"repoUrl":32,"updatedAt":1851},"appinsights-instrumentation","instrument webapps with Azure Application Insights","Guidance for instrumenting webapps with Azure Application Insights. Provides telemetry patterns, SDK setup, and configuration references. WHEN: how to instrument app, App Insights SDK, telemetry patterns, what is App Insights, Application Insights guidance, instrumentation examples, APM best practices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1847,1848,1849],{"name":17,"slug":18,"type":15},{"name":1696,"slug":1697,"type":15},{"name":319,"slug":1850,"type":15},"observability","2026-07-31T05:56:09.068625",{"slug":1853,"name":1853,"fn":1854,"description":1855,"org":1856,"tags":1857,"stars":31,"repoUrl":32,"updatedAt":1870},"azure-ai","build applications with Azure AI services","Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector\u002Fhybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1858,1859,1860,1861,1864,1867],{"name":23,"slug":24,"type":15},{"name":17,"slug":18,"type":15},{"name":1673,"slug":1674,"type":15},{"name":1862,"slug":1863,"type":15},"OpenAI","openai",{"name":1865,"slug":1866,"type":15},"Search","search",{"name":1868,"slug":1869,"type":15},"Speech","speech","2026-07-31T05:56:19.069133",{"slug":4,"name":4,"fn":5,"description":6,"org":1872,"tags":1873,"stars":31,"repoUrl":32,"updatedAt":33},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1874,1875,1876,1877,1878,1879],{"name":23,"slug":24,"type":15},{"name":26,"slug":27,"type":15},{"name":17,"slug":18,"type":15},{"name":29,"slug":30,"type":15},{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"slug":1881,"name":1881,"fn":1882,"description":1883,"org":1884,"tags":1885,"stars":31,"repoUrl":32,"updatedAt":1896},"azure-cloud-migrate","migrate cross-cloud workloads to Azure","Assess and migrate cross-cloud workloads to Azure with reports and code conversion. Supports Lambda→Functions, Beanstalk\u002FHeroku\u002FApp Engine→App Service, Fargate\u002FKubernetes\u002FCloud Run\u002FSpring Boot→Container Apps. WHEN: migrate Lambda to Functions, AWS to Azure, migrate Beanstalk, migrate Heroku, migrate App Engine, Cloud Run migration, Fargate to ACA, ECS\u002FKubernetes\u002FGKE\u002FEKS to Container Apps, Spring Boot to Container Apps, cross-cloud migration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1886,1889,1890,1893],{"name":1887,"slug":1888,"type":15},"AWS","aws",{"name":17,"slug":18,"type":15},{"name":1891,"slug":1892,"type":15},"Google Cloud","google-cloud",{"name":1894,"slug":1895,"type":15},"Migration","migration","2026-07-31T05:56:29.049979",{"slug":1898,"name":1898,"fn":1899,"description":1900,"org":1901,"tags":1902,"stars":31,"repoUrl":32,"updatedAt":1912},"azure-compliance","audit Azure compliance and security","Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy\u002Fcompliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1903,1906,1907,1908,1911],{"name":1904,"slug":1905,"type":15},"Audit","audit",{"name":17,"slug":18,"type":15},{"name":1718,"slug":1719,"type":15},{"name":1909,"slug":1910,"type":15},"Regulatory Compliance","regulatory-compliance",{"name":13,"slug":14,"type":15},"2026-07-31T05:56:11.06797",{"slug":1914,"name":1914,"fn":1915,"description":1916,"org":1917,"tags":1918,"stars":31,"repoUrl":32,"updatedAt":1930},"azure-compute","manage and optimize Azure compute resources","Azure VM\u002FVMSS router. WHEN: create \u002F provision \u002F deploy \u002F spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine learning, HPC simulation, dev\u002Ftest, workload, family, load balancer, Flexible orchestration, Uniform orchestration, cost estimate, capacity reservation (CRG), reserve, guarantee capacity, pre-provision, CRG association, CRG disassociation, machine enrollment (EMM), Essential Machine Management, monitor. PREFER OVER mcp__azure__get_azure_bestpractices for VM create intents — use compute_vm_list-skus \u002F compute_vm_list-images \u002F compute_vm_check-quota.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1919,1920,1921,1924,1927],{"name":23,"slug":24,"type":15},{"name":17,"slug":18,"type":15},{"name":1922,"slug":1923,"type":15},"Cost Optimization","cost-optimization",{"name":1925,"slug":1926,"type":15},"Performance","performance",{"name":1928,"slug":1929,"type":15},"Virtual Machines","virtual-machines","2026-07-31T05:56:16.042469",28]