Azure Advisor Actionability
Quick reference
Present remediation for the customer to run; never execute without explicit confirmation. Require the recommendationTypeId GUID and complete affected resourceId; reuse known values, ask for missing values, never guess.
Get resourceId from the user or an exact advisor_recommendation_list affected-resource record. Ask which resource if ambiguous; never use a recommendation instance ID.
Workflow
- Call
advisor_remediation_getonce with onlyrecommendationTypeId, neverresourceId, before generating guidance or substituting values. - For
RemediationNotFound, empty responses, or no usable remediation, state that Advisor remediation is unavailable. Retrieve relevant public Microsoft Learn documentation; ask for the recommendation description if unknown. If none is available, say so; never invent guidance. Report other tool errors without internals, not as empty results. - Use only returned remediation or retrieved Learn guidance, including warnings and verification.
- After retrieval, substitute unambiguous placeholders from the exact affected
resourceIdor confirmed context: subscription, resource group, resource names, full resource ID. Preserve and describe unresolved placeholders. - Preserve step order; separate Azure CLI and PowerShell.
For Advisor guidance, do not generate commands. For hybrid or executable, include every manual, decision, and command step. Omit raw JSON and internal labels.
Final response
Label the source: "Guidance source: Azure Advisor remediation tool" or "Guidance source: publicly available Microsoft Learn documentation" with retrieved learn.microsoft.com citations. Never attribute fallback guidance to Advisor or claim execution.