{"id":"073914b4-c998-4d10-ae0f-24fe16f1c77b","shortId":"nj7tYh","kind":"skill","title":"azure-sre-agent","tagline":"Expert knowledge for Azure Sre Agent development including troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when wiring SRE Agent to DevOps/Teams/ServiceNow, configuring tools/subagents, securing RBAC, querying KQ","description":"# Azure Sre Agent Skill\n\nThis skill provides expert guidance for Azure Sre Agent. Covers troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.\n\n## How to Use This Skill\n\n> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file\n\n> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| Troubleshooting | L34-L40 | Diagnosing and fixing SRE Agent deployment/operation issues, querying its telemetry and actions with KQL, and troubleshooting Java performance on AKS using the agent |\n| Decision Making | L41-L49 | Guidance on when to use deep investigations, choose Log Analytics vs App Insights, understand pricing and regions, and interpret incident value metrics for Azure SRE Agent decisions. |\n| Limits & Quotas | L50-L54 | Tracking Azure SRE Agent usage, AI Unit consumption, limits, and understanding how pricing, billing units, and quotas affect your workloads. |\n| Security | L55-L65 | Identity, auth, and RBAC for SRE Agent: managed identities, ADO and ServiceNow auth, roles, permissions, and subscription/resource access configuration. |\n| Configuration | L66-L77 | Configuring SRE Agent behavior: hooks and governance, custom tools/skills, specialized subagents, network/firewall settings, and enabling/using the Python/shell Code Interpreter via UI or REST API |\n| Integrations & Coding Patterns | L78-L92 | Integrating Azure SRE Agent with DevOps, GitHub, Teams, ServiceNow, PagerDuty, Kusto, observability tools, and custom HTTP/Python/MCP tools for automation and incident workflows |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Query Azure SRE Agent telemetry and actions with KQL | https://learn.microsoft.com/en-us/azure/sre-agent/audit-agent-actions |\n| Troubleshoot Azure SRE Agent deployment and operations | https://learn.microsoft.com/en-us/azure/sre-agent/faq-troubleshooting |\n| Diagnose Java performance issues on AKS with SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/troubleshoot-java-aks |\n\n### Decision Making\n| Topic | URL |\n|-------|-----|\n| Decide when to use deep investigation in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/deep-investigation |\n| Decide when to use Log Analytics and App Insights connectors in SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/log-analytics-app-insights |\n| Understand Azure SRE Agent pricing and cost drivers | https://learn.microsoft.com/en-us/azure/sre-agent/pricing-billing |\n| Select supported Azure regions for SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/supported-regions |\n| Analyze and interpret incident value metrics in SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/track-incident-value |\n\n### Limits & Quotas\n| Topic | URL |\n|-------|-----|\n| Monitor Azure SRE Agent usage and Azure AI Unit limits | https://learn.microsoft.com/en-us/azure/sre-agent/monitor-agent-usage |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Understand Azure SRE Agent identities and authentication | https://learn.microsoft.com/en-us/azure/sre-agent/agent-identity |\n| Configure managed identity access to ADO repos in SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/connect-ado-repo-managed-identity |\n| Configure secure ServiceNow authentication for Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/connect-servicenow |\n| Manage Azure SRE Agent permissions and resource access | https://learn.microsoft.com/en-us/azure/sre-agent/manage-permissions |\n| Configure Azure SRE Agent permissions and RBAC access | https://learn.microsoft.com/en-us/azure/sre-agent/permissions |\n| Understand subscription visibility and permissions in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/subscription-permission-visibility |\n| Configure Azure SRE Agent roles and permissions | https://learn.microsoft.com/en-us/azure/sre-agent/user-roles |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Configure agent hooks to control Azure SRE Agent behavior | https://learn.microsoft.com/en-us/azure/sre-agent/agent-hooks |\n| Use SRE Agent code interpreter for Python and shell | https://learn.microsoft.com/en-us/azure/sre-agent/code-interpreter |\n| Create and manage governance hooks in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/create-manage-hooks-ui |\n| Create custom skills with tools and files in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/create-skill |\n| Configure specialized subagents in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/create-subagent |\n| Configure network and firewall requirements for SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/network-requirements |\n| Configure agent hooks via REST API in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/tutorial-agent-hooks |\n| Enable and use Code Interpreter in Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/use-code-interpreter |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Connect Azure DevOps to Azure SRE Agent for code and work items | https://learn.microsoft.com/en-us/azure/sre-agent/ado-connector |\n| Connect Azure DevOps wikis as knowledge sources for SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/azure-devops-wiki-knowledge |\n| Connect Azure DevOps wiki as SRE Agent knowledge source | https://learn.microsoft.com/en-us/azure/sre-agent/connect-devops-wiki |\n| Configure PagerDuty integration for Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/connect-pagerduty |\n| Build and deploy a Python SLA calculator tool in SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/create-python-tool |\n| Configure cross-tenant Azure DevOps access for SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/cross-account-ado-oauth |\n| Integrate external observability tools with Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/diagnose-observability |\n| Integrate GitHub with Azure SRE Agent via OAuth or PAT | https://learn.microsoft.com/en-us/azure/sre-agent/github-connector |\n| Define Kusto tools to run deterministic KQL in SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/kusto-tools |\n| Integrate PagerDuty incidents with Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/pagerduty-incidents |\n| Create and configure Python tools for Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/python-code-execution |\n| Connect PagerDuty incidents to Azure SRE Agent | https://learn.microsoft.com/en-us/azure/sre-agent/set-up-pagerduty-indexing |","tags":["azure","sre","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions","azure-kubernetes-service"],"capabilities":["skill","source-microsoftdocs","skill-azure-sre-agent","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-sre-agent","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (7,615 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:59.851Z","embedding":null,"createdAt":"2026-04-18T22:00:14.347Z","updatedAt":"2026-05-18T18:53:59.851Z","lastSeenAt":"2026-05-18T18:53:59.851Z","tsv":"'/en-us/azure/sre-agent/ado-connector':691 '/en-us/azure/sre-agent/agent-hooks':587 '/en-us/azure/sre-agent/agent-identity':504 '/en-us/azure/sre-agent/audit-agent-actions':386 '/en-us/azure/sre-agent/azure-devops-wiki-knowledge':704 '/en-us/azure/sre-agent/code-interpreter':599 '/en-us/azure/sre-agent/connect-ado-repo-managed-identity':517 '/en-us/azure/sre-agent/connect-devops-wiki':716 '/en-us/azure/sre-agent/connect-pagerduty':726 '/en-us/azure/sre-agent/connect-servicenow':528 '/en-us/azure/sre-agent/create-manage-hooks-ui':611 '/en-us/azure/sre-agent/create-python-tool':740 '/en-us/azure/sre-agent/create-skill':625 '/en-us/azure/sre-agent/create-subagent':635 '/en-us/azure/sre-agent/cross-account-ado-oauth':753 '/en-us/azure/sre-agent/deep-investigation':425 '/en-us/azure/sre-agent/diagnose-observability':764 '/en-us/azure/sre-agent/faq-troubleshooting':396 '/en-us/azure/sre-agent/github-connector':777 '/en-us/azure/sre-agent/kusto-tools':790 '/en-us/azure/sre-agent/log-analytics-app-insights':441 '/en-us/azure/sre-agent/manage-permissions':539 '/en-us/azure/sre-agent/monitor-agent-usage':491 '/en-us/azure/sre-agent/network-requirements':646 '/en-us/azure/sre-agent/pagerduty-incidents':800 '/en-us/azure/sre-agent/permissions':550 '/en-us/azure/sre-agent/pricing-billing':452 '/en-us/azure/sre-agent/python-code-execution':812 '/en-us/azure/sre-agent/set-up-pagerduty-indexing':822 '/en-us/azure/sre-agent/subscription-permission-visibility':562 '/en-us/azure/sre-agent/supported-regions':462 '/en-us/azure/sre-agent/track-incident-value':474 '/en-us/azure/sre-agent/troubleshoot-java-aks':408 '/en-us/azure/sre-agent/tutorial-agent-hooks':659 '/en-us/azure/sre-agent/use-code-interpreter':671 '/en-us/azure/sre-agent/user-roles':572 '/microsoftdocs/mcp/blob/main/readme.md)':161 '3':132 'accept':200 'access':166,314,508,536,547,747 'action':224,381 'ado':306,510 'affect':290 'agent':4,10,28,39,49,81,125,184,198,217,235,266,276,303,322,353,378,390,405,422,438,445,459,471,482,498,514,525,532,543,559,566,577,583,590,608,622,632,643,648,656,668,683,701,711,723,737,750,761,770,787,797,809,819 'ai':278,486 'ak':232,402 'analyt':250,431 'analyz':463 'api':343,652 'app':252,433 'auth':298,309 'authent':501,521 'autom':368 'avail':151 'azur':2,8,37,47,264,274,351,376,388,420,443,455,480,485,496,523,530,541,557,564,581,606,620,630,654,666,678,681,693,706,721,745,759,768,795,807,817 'azure-sre-ag':1 'behavior':323,584 'bill':286 'build':727 'calcul':733 'capabl':73 'categori':84,92,108,204,206 'choos':248 'code':22,60,337,345,591,663,673,685 'combin':63 'configur':19,31,57,315,316,320,505,518,540,563,573,576,626,636,647,717,741,803 'connect':677,692,705,813 'connector':435 'consumpt':280 'content':68,170 'control':580 'cost':448 'cover':50 'creat':600,612,801 'cross':743 'cross-ten':742 'custom':327,364,613 'decid':413,426 'decis':14,52,236,267,409 'deep':246,417 'defin':778 'deploy':391,729 'deployment/operation':218 'descript':208 'determinist':783 'develop':11 'devop':355,679,694,707,746 'devops/teams/servicenow':30 'diagnos':213,397 'doc':176 'document':71,169 'driver':449 'e.g':96,112 'enabl':660 'enabling/using':334 'expert':5,44 'extern':755 'fallback':188 'fetch':72,168,177,190 'file':102,110,117,122,618 'firewal':639 'fix':215 'github':356,766 'github.com':160 'github.com/microsoftdocs/mcp/blob/main/readme.md)':159 'govern':326,603 'guid':158 'guidanc':45,241 'hook':324,578,604,649 'http/python/mcp':365 'ident':297,305,499,507 'import':79,123 'incid':260,370,466,793,815 'includ':12 'index':85,205 'insight':253,434 'instal':155,157 'integr':21,59,344,350,672,719,754,765,791 'interpret':259,338,465,592,664 'investig':247,418 'issu':219,400 'item':688 'java':229,398 'knowledg':6,697,712 'kq':36 'kql':226,383,784 'kusto':360,779 'l120':99 'l34':211 'l34-l40':210 'l35':98 'l35-l120':97 'l40':212 'l41':239 'l41-l49':238 'l49':240 'l50':271 'l50-l54':270 'l54':272 'l55':295 'l55-l65':294 'l65':296 'l66':318 'l66-l77':317 'l77':319 'l78':348 'l78-l92':347 'l92':349 'latest':140 'learn':183,197 'learn-agent-skil':182,196 'learn.microsoft.com':385,395,407,424,440,451,461,473,490,503,516,527,538,549,561,571,586,598,610,624,634,645,658,670,690,703,715,725,739,752,763,776,789,799,811,821 'learn.microsoft.com/en-us/azure/sre-agent/ado-connector':689 'learn.microsoft.com/en-us/azure/sre-agent/agent-hooks':585 'learn.microsoft.com/en-us/azure/sre-agent/agent-identity':502 'learn.microsoft.com/en-us/azure/sre-agent/audit-agent-actions':384 'learn.microsoft.com/en-us/azure/sre-agent/azure-devops-wiki-knowledge':702 'learn.microsoft.com/en-us/azure/sre-agent/code-interpreter':597 'learn.microsoft.com/en-us/azure/sre-agent/connect-ado-repo-managed-identity':515 'learn.microsoft.com/en-us/azure/sre-agent/connect-devops-wiki':714 'learn.microsoft.com/en-us/azure/sre-agent/connect-pagerduty':724 'learn.microsoft.com/en-us/azure/sre-agent/connect-servicenow':526 'learn.microsoft.com/en-us/azure/sre-agent/create-manage-hooks-ui':609 'learn.microsoft.com/en-us/azure/sre-agent/create-python-tool':738 'learn.microsoft.com/en-us/azure/sre-agent/create-skill':623 'learn.microsoft.com/en-us/azure/sre-agent/create-subagent':633 'learn.microsoft.com/en-us/azure/sre-agent/cross-account-ado-oauth':751 'learn.microsoft.com/en-us/azure/sre-agent/deep-investigation':423 'learn.microsoft.com/en-us/azure/sre-agent/diagnose-observability':762 'learn.microsoft.com/en-us/azure/sre-agent/faq-troubleshooting':394 'learn.microsoft.com/en-us/azure/sre-agent/github-connector':775 'learn.microsoft.com/en-us/azure/sre-agent/kusto-tools':788 'learn.microsoft.com/en-us/azure/sre-agent/log-analytics-app-insights':439 'learn.microsoft.com/en-us/azure/sre-agent/manage-permissions':537 'learn.microsoft.com/en-us/azure/sre-agent/monitor-agent-usage':489 'learn.microsoft.com/en-us/azure/sre-agent/network-requirements':644 'learn.microsoft.com/en-us/azure/sre-agent/pagerduty-incidents':798 'learn.microsoft.com/en-us/azure/sre-agent/permissions':548 'learn.microsoft.com/en-us/azure/sre-agent/pricing-billing':450 'learn.microsoft.com/en-us/azure/sre-agent/python-code-execution':810 'learn.microsoft.com/en-us/azure/sre-agent/set-up-pagerduty-indexing':820 'learn.microsoft.com/en-us/azure/sre-agent/subscription-permission-visibility':560 'learn.microsoft.com/en-us/azure/sre-agent/supported-regions':460 'learn.microsoft.com/en-us/azure/sre-agent/track-incident-value':472 'learn.microsoft.com/en-us/azure/sre-agent/troubleshoot-java-aks':406 'learn.microsoft.com/en-us/azure/sre-agent/tutorial-agent-hooks':657 'learn.microsoft.com/en-us/azure/sre-agent/use-code-interpreter':669 'learn.microsoft.com/en-us/azure/sre-agent/user-roles':570 'limit':16,54,268,281,475,488 'line':94,106,207 'link':111,120 'local':64 'locat':88 'log':249,430 'make':15,53,237,410 'manag':304,506,529,602 'markdown':187,203 'mcp':146,173 'metadata.generated':127 'metric':262,468 'microsoft':175 'microsoftdoc':147,174 'monitor':479 'month':133 'network':165,637 'network/firewall':331 'oauth':772 'observ':361,756 'old':134 'oper':393 'pagerduti':359,718,792,814 'pat':774 'pattern':23,61,346,674 'perform':230,399 'permiss':311,533,544,555,569 'prefer':171 'price':255,285,446 'provid':43 'pull':138 'python':594,731,804 'python/shell':336 'queri':35,179,193,220,375 'quick':66 'quick-refer':65 'quota':17,55,269,289,476 'rang':95 'rbac':34,300,546 'read':101,116 'refer':67,121 'region':257,456 'relev':89 'remot':70 'repo':511 'repositori':144 'requir':164,640 'resourc':535 'rest':342,651 'return':186,202 'role':310,567 'run':782 'section':90 'secur':18,33,56,293,492,519 'security.md':113,114 'select':453 'servicenow':308,358,520 'set':332 'shell':596 'skill':40,42,78,163,185,199,614 'skill-azure-sre-agent' 'sla':732 'sourc':698,713 'source-microsoftdocs' 'special':329,627 'specifi':105 'sre':3,9,27,38,48,216,265,275,302,321,352,377,389,404,421,437,444,458,470,481,497,513,524,531,542,558,565,582,589,607,621,631,642,655,667,682,700,710,722,736,749,760,769,786,796,808,818 'string':180,194 'subag':330,628 'subscript':552 'subscription/resource':313 'suggest':135,152 'support':454 'team':357 'telemetri':222,379 'tenant':744 'text/markdown':201 'tool':148,362,366,616,734,757,780,805 'tools/skills':328 'tools/subagents':32 'topic':373,411,477,493,574,675 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'track':273 'troubleshoot':13,51,209,228,372,387 'ui':340 'understand':254,283,442,495,551 'unit':279,287,487 'url':374,412,478,494,575,676 'usag':277,483 'use':24,76,82,100,115,172,189,233,245,416,429,588,662 'user':137,154 'valu':261,467 'version':141 'via':339,650,771 'visibl':553 'vs':251 'webpag':191 'wiki':695,708 'wire':26 'work':687 'workflow':371 'workload':292","prices":[{"id":"ada00cbe-ea9e-40a2-91e4-31313221c06c","listingId":"073914b4-c998-4d10-ae0f-24fe16f1c77b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:00:14.347Z"}],"sources":[{"listingId":"073914b4-c998-4d10-ae0f-24fe16f1c77b","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-sre-agent","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-sre-agent","isPrimary":false,"firstSeenAt":"2026-04-18T22:00:14.347Z","lastSeenAt":"2026-05-18T18:53:59.851Z"}],"details":{"listingId":"073914b4-c998-4d10-ae0f-24fe16f1c77b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-sre-agent","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":549,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"77a5d4abf78723f8fc306f38faf2c86d0a312dae","skill_md_path":"skills/azure-sre-agent/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-sre-agent"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-sre-agent","description":"Expert knowledge for Azure Sre Agent development including troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when wiring SRE Agent to DevOps/Teams/ServiceNow, configuring tools/subagents, securing RBAC, querying KQL, or tracking AI Unit usage, and other Azure Sre Agent related development tasks. Not for Azure Monitor (use azure-monitor), Azure Reliability (use azure-reliability), Azure Resiliency (use azure-resiliency), Azure Service Health (use azure-service-health).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-sre-agent"},"updatedAt":"2026-05-18T18:53:59.851Z"}}