Merge pull request #51231 from MicrosoftDocs/NEW-introduction-microsoft-copilot-azure

New introduction microsoft copilot azure module

Author: v-ccolin

learn-pr/advocates/introduction-microsoft-copilot-azure/1-introduction-microsoft-copilot-azure.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.introduction-microsoft-copilot-azure
+title: Introduction to Microsoft Copilot in Azure
+metadata:
+  title: Introduction to Microsoft Copilot in Azure
+  description: Understand the capabilities of Microsoft Copilot in Azure.
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 4
+content: |
+  [!include[](includes/1-introduction-microsoft-copilot-azure.md)]

learn-pr/advocates/introduction-microsoft-copilot-azure/2-access-microsoft-copilot-azure.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.access-microsoft-copilot-azure
+title: Access Microsoft Copilot in Azure
+metadata:
+  title: Access Microsoft Copilot in Azure
+  description: Learn the different ways to access Microsoft Copilot in Azure.
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/2-access-microsoft-copilot-azure.md)]

learn-pr/advocates/introduction-microsoft-copilot-azure/3-perform-operations-tasks-copilot-azure.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.perform-operations-tasks-copilot-azure
+title: Perform operations tasks using Microsoft Copilot in Azure
+metadata:
+  title:  Perform Operations Tasks Using Microsoft Copilot in Azure
+  description: TBD
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 7
+content: |
+  [!include[](includes/3-perform-operations-tasks-copilot-azure.md)]

learn-pr/advocates/introduction-microsoft-copilot-azure/4-managing-access-copilot-azure.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.managing-access-copilot-azure
+title: Managing access to Copilot in Azure
+metadata:
+  title: Managing Access to Copilot in Azure
+  description: Learn how to manage access to Microsoft Copilot in Azure.
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/4-managing-access-copilot-azure.md)]

learn-pr/advocates/introduction-microsoft-copilot-azure/5-knowledge-check.yml

@@ -0,0 +1,47 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.knowledge-check
+title: Knowledge check
+metadata:
+  title: Knowledge Check
+  description: This knowledge check tests your understanding of the module content.
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 4
+content: Choose the best response for each question.
+quiz:
+  questions:
+    - content: "You're the Cloud administrator for your organization. What is a scenario on which you can use Microsoft Copilot in Azure to aid in your work?"
+      choices:
+        - content: "Manage non-Azure resources."
+          isCorrect: false
+          explanation: "Microsoft Copilot in Azure can only manage Azure and Azure Arc connected resources."
+        - content: "Create on-premises virtual machines."
+          isCorrect: false
+          explanation: "Microsoft Copilot in Azure can manage Arc-enabled servers but can't create on-premises resources."
+        - content: "Visualize an Azure virtual network topology."
+          isCorrect: true
+          explanation: "Microsoft Copilot in Azure can create a visual network topology of Azure virtual networks."
+    - content: "You're authoring a YAML specification file to deploy a workload to Azure Kubernetes Service. You found this sample YAML file on the web and aren't sure what the file does. How can you use Microsoft Copilot in Azure to support a safe deployment?"
+      choices:
+        - content: "Ask Microsoft Copilot in Azure to author a new YAML specification file."
+          isCorrect: false
+          explanation: "Creating a new file requires a review and comparison related of the sample file."
+        - content: "Ask Microsoft Copilot in Azure to explain the YAML specification file."
+          isCorrect: true
+          explanation: "Microsoft Copilot in Azure can explain the sample YAML code so you're in control of what it's doing."
+        - content: "Ask Microsoft Copilot in Azure to fix the YAML specification file."
+          isCorrect: false
+          explanation: "Microsoft Copilot in Azure can fix YAML if there are errors with its syntax."
+    - content: "How does Microsoft Copilot in Azure comply with the permissions and RBAC settings of your company?"
+      choices:
+        - content: "Microsoft Copilot in Azure won't perform actions that you don't have permissions to or access resources you don't have access to already."
+          isCorrect: true
+          explanation: "Microsoft Copilot in Azure is restricted to the permissions and authorization you already have and can't operate outside those boundaries."
+        - content: "You can ask Microsoft Copilot in Azure to elevate your role to Global Administrator."
+          isCorrect: false
+          explanation: "Microsoft Copilot in Azure can't be used to elevate your current role or add permissions."
+        - content: "Microsoft Copilot in Azure operates under a different service account and can be provided access to different resources."
+          isCorrect: false
+          explanation: "Microsoft Copilot in Azure only operates with the same context that your user account has."

learn-pr/advocates/introduction-microsoft-copilot-azure/6-summary.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.introduction-microsoft-copilot-azure.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Module summary.
+  ms.date: 07/03/2025
+  author: Orin-Thomas
+  ms.author: viniap
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/6-summary.md)]

learn-pr/advocates/introduction-microsoft-copilot-azure/includes/1-introduction-microsoft-copilot-azure.md

@@ -0,0 +1,35 @@
+Microsoft Copilot in Azure is an AI-powered assistant designed to simplify how you manage, optimize, and troubleshoot your Azure environment. Microsoft Copilot in Azure understands your infrastructure and helps you get things done using natural language. Copilot uses Large Language Models (LLMs), the Azure control plane, and insights about your Azure environment to help you work more efficiently.
+
+Microsoft Copilot in Azure can help you navigate the hundreds of services and thousands of resource types that Azure offers. It unifies knowledge and data across hundreds of services to increase productivity, reduce costs, and provide deep insights. Microsoft Copilot in Azure can help you learn about Azure by answering questions, and it can provide information tailored to your own Azure resources and environment. By letting you express your goals in natural language, Microsoft Copilot in Azure can simplify your Azure management experience.
+
+If an action can be taken by Microsoft Copilot in Azure, Copilot requests any necessary details to then confirm if it should perform the action should be taken. For example, if you prompt Microsoft Copilot in Azure to create a virtual machine, it asks necessary details, provide you with a proposed plan of action, and wait for your confirmation.  If Microsoft Copilot in Azure can't perform an action, it provides you with information on how you can perform a task manually.
+
+Below is a nonexhaustive list of tasks that Microsoft Copilot in Azure can help you with:
+
+- Understand your Azure environment:
+  - Get resource information through Azure Resource Graph queries
+  - Understand service health events and status
+  - Analyze, estimate, and optimize costs
+  - Find Azure Advisor recommendations
+  - Visualize network topology
+  - Query your attack surface
+  - Investigate Azure Firewall IDPS attacks
+- Work smarter with Azure services:
+  - Execute commands
+  - Deploy and manage virtual machines
+  - Discover and deploy workload templates
+  - Work with AKS clusters efficiently
+  - Get information about Azure Monitor metrics and logs
+  - Work smarter with Azure Local
+  - Manage and troubleshoot storage accounts
+  - Troubleshoot disk performance
+  - Design, troubleshoot, and secure networks
+  - Troubleshoot Azure Arc extension issues
+  - Improve Azure SQL Database-driven applications
+- Write and optimize code:
+  - Generate Azure CLI scripts
+  - Generate PowerShell scripts
+  - Generate Terraform and Bicep configurations
+  - Author API Management policies
+  - Create Kubernetes YAML files
+  - Troubleshoot apps faster with App Service

learn-pr/advocates/introduction-microsoft-copilot-azure/includes/2-access-microsoft-copilot-azure.md

@@ -0,0 +1,18 @@
+You can access Microsoft Copilot in Azure in the Azure portal, through the Azure mobile app, or through AI Shell. Throughout a conversation, Microsoft Copilot in Azure answers questions, generates queries, performs tasks, and safely acts on your behalf. It makes high-quality recommendations and takes actions while respecting your organization's policy and privacy. Microsoft Copilot in Azure can only access the resources that you have permission to and can only take actions that you have permission to perform, with your confirmation required for any actions.
+
+To use Microsoft Copilot in Azure in the Azure portal:
+
+1. Open the Azure portal on your preferred browser:
+1. On the top bar, select the Copilot icon. The Copilot panel opens on the right-hand side.
+1. From the Copilot panel, you can initiate a conversation with Copilot.
+
+   [![A screenshot of a Microsoft Copilot in Azure chat in the Azure portal.](../media/copilot-chat.png)](../media/copilot-chat-big.png#lightbox)
+
+In addition to using the portal, you can access Microsoft Copilot in Azure through AI Shell. AI Shell is an interactive command line shell that provides a chat interface for AI language models. The shell provides agents that connect to different AI models and other assistance providers. Users can interact with the agents in a conversational manner. With AI Shell, you can access Copilot in Azure's AI-driven suggestions, using natural language prompts, directly in your CLI environment to:
+
+- Quickly resolve common Azure CLI and PowerShell errors with guided suggestions
+- Simplify your Azure workflows
+- Automate complex setups
+- Gain insights into best practices
+
+[![An animated image showing interaction with Azure CLI.](../media/ai-shell-azure-agent.gif)](../media/ai-shell-azure-agent-big.gif#lightbox)

learn-pr/advocates/introduction-microsoft-copilot-azure/includes/3-perform-operations-tasks-copilot-azure.md

@@ -0,0 +1,45 @@
+You can ask Microsoft Copilot in Azure questions about your Azure resources and cloud environment. From anywhere in the Azure portal, you can ask Microsoft Copilot in Azure to explain more about Azure concepts, services, or offerings. You can ask questions to learn how a feature works, or which configurations best meet your budgets, security, and scale requirements. Microsoft Copilot in Azure can guide you to the right user experience or even author scripts and other artifacts that you can use to deploy your solutions. Answers are grounded in the latest Azure documentation, so you can get up-to-date guidance just by asking a question.
+
+You can ask Microsoft Copilot in Azure questions to learn which services are best suited for your workloads or get ideas about additional services that might help support your objectives. For instance, you can ask "What service would you recommend to implement distributed caching?" or "What are popular services used with Azure Container Apps?" Where applicable, Microsoft Copilot in Azure provides links to start working with the service or learn more. In some cases, you also see metrics about how often a service is used. You can also ask additional questions to find out more about the service and whether it's right for your needs.
+
+## Troubleshoot Azure services
+
+Microsoft Copilot in Azure can also help you troubleshoot services and understand more about information presented in Azure. This can be especially helpful when looking at diagnostic details. For example, when viewing diagnostics for a resource, you can say "Give me a summary of this page" or "What's the issue with my app?" You can ask what an error means or ask what the next steps would be to implement a recommended solution.
+
+Microsoft Copilot in Azure can also help explain errors from the Notifications pane:
+
+[![Screenshot of Copilot in Azure providing a link to help troubleshoot an error in the Notifications pane.](../media/service-notifications.png)](../media/service-notifications-big.png#lightbox)
+
+## Integration with Azure services
+
+Microsoft Copilot in Azure is integrated into many assure services. For example, when deploying VMs, Microsoft Copilot in Azure can help you create resources that match your specific needs:
+
+[![A screenshot of Microsoft Copilot in Azure assisting the creation of a virtual machine.](../media/copilot-create-virtual-machine.png)](../media/copilot-create-virtual-machine-big.png#lightbox)
+
+Some actions can be executed from the Copilot pane and will open the corresponding view in the Azure portal. For example, in the prompt below it was asked "what resources were created in the last 24 hours?". Microsoft Copilot in Azure created an Azure Resource Graph query and provided the option to Run the query. When you run the query, the Azure Resource Graph Explorer view opens and runs the query:
+
+[![A screenshot of Microsoft Copilot in Azure interacting with resource graph explorer.](../media/resource-graph-explorer.png)](../media/resource-graph-explorer-big.png#lightbox)
+
+Microsoft Copilot in Azure is also integrated to aid you in creating scripts or reviewing existing code. For example, when you deploy a YAML specification to an Azure Kubernetes Service cluster, Microsoft Copilot in Azure can help you write or help editing the YAML code:
+
+[![A screenshot of Microsoft Copilot in Azure assisting with the creation of YAML code.](../media/copilot-yaml.png)](../media/copilot-yaml-big.png#lightbox)
+
+When using Copilot to author YAML files, you can also use commands for the following:
+
+- /explain: Get more information about the YAML file or a highlighted section.
+- /format: Apply standard indentation or fix other formatting issues.
+- /fix: Resolve problems with invalid YAML.
+- /chat: Open the full Microsoft Copilot in Azure chat window.
+- /discard: Discard previously made changes.
+- /close: Closes the inline Copilot control.
+- /retry: Tries the previous prompt again.
+
+## Limitations
+
+While Microsoft Copilot in Azure can perform many types of tasks, there are some limitations and Microsoft Copilot in Azure might not be able to complete your request. In these cases, you'll generally see an explanation along with more information about how you can carry out the intended action. Present limitations include:
+
+- You can't continue the same conversation beyond 24 hours.
+- Any action taken on more than 10 resources must be performed outside of Microsoft Copilot in Azure.
+- Some responses that display lists are limited to the top five items.
+- For some tasks and queries, using a resource's name doesn't work, and the Azure resource ID must be provided.
+- Excessive use of Copilot in Azure may result in temporary throttling of access to Copilot in Azure.

learn-pr/advocates/introduction-microsoft-copilot-azure/includes/4-managing-access-copilot-azure.md

@@ -0,0 +1,19 @@
+By default, Microsoft Copilot in Azure is available to all users in a tenant. However, Global Administrators can manage access to Microsoft Copilot in Azure for their organization. Access can also be optionally granted to specific Microsoft Entra users or groups.
+
+If Microsoft Copilot in Azure isn't available for a user, they see an unauthorized message when they select the Copilot button in the Azure portal.
+
+Regardless of access to Microsoft Copilot in Azure, Microsoft Copilot in Azure itself only has access to resources that the user has access to. It can only take actions that the user has permission to perform and requires confirmation before making changes. Microsoft Copilot in Azure complies with all existing access management rules and protections such as Azure role-based access control (Azure RBAC), Privileged Identity Management, Azure Policy, and resource locks.
+
+To manage access to Microsoft Copilot in Azure for users in your tenant, any Global Administrator in that tenant can follow these steps.
+
+1. Elevate your access so that your Global Administrator account can manage all subscriptions in your tenant.
+1. In the Azure portal, search for Copilot in Azure admin center and select it.
+1. In Copilot in Azure admin center, under Settings, select Access management.
+1. Select the toggle next to On for entire tenant to change it to Off for entire tenant.
+1. To grant access to specific Microsoft Entra users or groups, select Manage RBAC roles.
+1. Assign the Copilot for Azure User role to specific users or groups. For detailed steps, see Assign Azure roles using the Azure portal.
+1. When you're finished, remove your elevated access.
+
+Global Administrators for a tenant can change the Access management selection at any time.
+
+[![A screenshot the Azure portal where access to Microsoft Copilot in Azure is managed.](../media/access-control.png)](../media/access-control-big.png)