add usage doc

Author: craigshoemaker

articles/app-service/sre-agent-usage.md

@@ -0,0 +1,80 @@
+---
+title: Create and use an SRE Agent
+description: Learn to use an automated agent to resolve problems and keep your apps running in Azure.
+services: app-service
+author: craigshoemaker
+ms.service: azure-container-apps
+ms.topic: how-to
+ms.date: 05/16/2025
+ms.author: cshoe
+---
+
+# Create and use an Azure SRE Agent
+
+An Azure SRE Agent helps you maintain the health and performance of your Azure resources through AI-powered monitoring and assistance. Agents continuously watch your resources for issues, provide troubleshooting help, and suggest remediation steps available through a natural language chat interface. To ensure accuracy and control, any agent action taken on your behalf requires your approval.
+
+This article demonstrates how to  create an SRE Agent, connect it to your resources to maintain optimal application performance.
+
+## Create an agent
+
+Create an agent by pointing it to the resource groups you want to monitor.
+
+### Prerequisites
+
+You need to grant your agent permissions so that it can access the Azure resources.
+
+Before you can create a new agent, make sure your user account has correct permissions. Your account needs `Microsoft.Authorization/roleAssignments/write` permissions using either [Role Based Access Control Administrator](/azure/role-based-access-control/built-in-roles) or [User Access Administrator](/azure/role-based-access-control/built-in-roles).
+
+### Create
+
+To create an SRE Agent, follow these steps:
+
+1. Go to the Azure portal and search for and select **SRE Agent**.
+
+1. Select **Create**.
+
+1. Enter the following values in the *Create agent* window:
+
+    | Property | Value |
+    |---|---|
+    | Subscription | Select your Azure subscription. |
+    | Resource group | Select an existing resource group or to create a new one, enter a name.  |
+    | Name | Enter a name for your agent. |
+    | Region | Select **Sweden Central**.<br><br>During preview, SRE Agents are only available in the *Sweden Central* region, but they can monitor resources in any Azure region.|
+    | Choose role | Select **Contributor role**. |
+
+1. Select the **Select resource groups** button.
+
+1. In the *Select resource groups to monitor* window, search for the resource group you want to monitor.
+
+    Avoid selecting the resource group name link. To select a resource group, check the checkbox next to the resource group.
+
+1. Scroll to the bottom of the dialog window and select **Save**.
+
+1. Select **Create**.
+
+## Chat with your agent
+
+Your agent has access to any resource inside the resource group associated with the agent. Use the chat feature to help you inquire about and resolve issues related to your resources.
+
+1. Go to the Azure portal, search for and select **SRE Agent**.
+
+1. Locate your agent in the list and select **Chat with agent**.
+
+Once the chat window loads, you can begin asking your agent questions. Here's a series of questions that can help you get started:
+
+- What can you help me with?
+- What subscriptions/resource groups/resources are you managing?
+- What alerts should I set up for `<RESOURCE_NAME>`?
+- Show me visualization of `2xx` requests vs HTTP errors for my web apps across all subscriptions
+
+If you have a specific problem in mind, you could ask questions like:
+
+- Why is `<RESOURCE_NAME>` slow?
+- Why is `<RESOURCE_NAME>` not working?
+- Can you investigate `<RESOURCE_NAME>`?
+- Can you get me the `<METRIC>` of `<RESOURCE_NAME>`?
+
+## Related content
+
+- [SRE Agent overview](./sre-agent-overview.md)

articles/app-service/toc.yml

@@ -219,8 +219,12 @@ items:
           href: /azure/templates/microsoft.web/allversions
 - name: Logs and monitoring
   items:
-    - name: SRE Agent overview
-      href: sre-agent-overview.md
+    - name: Troubleshoot and resolve issues with an agent
+      items:
+        - name: Overview
+          href: sre-agent-overview.md
+        - name: Use an SRE agent
+          href: sre-agent-usage.md
     - name: Monitor App Service
       href: monitor-app-service.md
     - name: Monitoring data reference