Merge pull request #299945 from craigshoemaker/sre/overview-branding-faq

[SRE Agent] Update: Overview -> branding and FAQ section

Author: AnnaMHuff

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

@@ -1,17 +1,15 @@
 ---
-title: SRE Agent overview (preview)
+title: Azure SRE Agent overview (preview)
 description: Learn how AI-enabled agents help solve problems and support resilient and self-healing systems on your behalf.
-services: container-apps
 author: craigshoemaker
-ms.service: azure-container-apps
 ms.topic: conceptual
-ms.date: 05/08/2025
+ms.date: 05/16/2025
 ms.author: cshoe
 ---
 
-# SRE Agent overview (preview)
+# Azure SRE Agent overview (preview)
 
-Site Reliability Engineering (SRE) focuses on creating reliable, scalable systems through automation and proactive management. An SRE Agent brings these principles to your cloud environment by providing AI-powered monitoring, troubleshooting, and remediation capabilities. An SRE Agent automates routine operational tasks and provides reasoned insights to help you maintain application reliability while reducing manual intervention. Available as a chatbot, you can ask questions and give natural language commands to maintain your applications and services. To ensure accuracy and control, any agent action taken on your behalf requires your approval.
+Site Reliability Engineering (SRE) focuses on creating reliable, scalable systems through automation and proactive management. Azure SRE Agent brings these principles to your Azure hosted applications by providing AI-powered monitoring, troubleshooting, and remediation capabilities to your app environments. The agent automates routine operational tasks and provides reasoned insights to help you maintain application reliability while reducing manual intervention. Available as a chat interface, you can ask questions and give natural language commands to maintain your applications and services. To ensure accuracy and control, any agent action taken on your behalf requires your approval.
 
 Agents have access to every resource inside the resource groups associated to the agent. Therefore, agents:
 
@@ -26,27 +24,35 @@ An SRE Agent also integrates with [PagerDuty](https://www.pagerduty.com/) to sup
 > [!NOTE]
 > The SRE Agent feature is in limited preview. To sign up for access, fill out the [SRE Agent application](https://go.microsoft.com/fwlink/?linkid=2319540).
 
+By using an SRE Agent, you consent the product-specific [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+
 ## Key features
 
 The SRE Agent offers several key features that enhance the reliability and performance of your Azure resources:
 
-- **Proactive monitoring**: Continuous resource monitoring with real-time alerts for potential issues and daily resource reports.
+- **Proactive monitoring**: Continuous 24x7 resource monitoring with real-time alerts for potential issues and daily resource reports.
 
 - **Automated mitigation:** Automatic detection and mitigation of common issues, reducing downtime and improving resource health. While agents attempt to work on your behalf, all automation requires your approval.
 
+- **Infrastructure best practices:** Identify and remediate resources not following security best practices and help updates.
+
+- **Automates incident response:** Automatically respond to Azure Monitor alerts or PagerDuty incidents with initial analysis.
+
+- **Accelerates root cause analysis:** Diagnose root causes of app issues by analyzing metrics and logs and suggest mitigations.
+
 - **Resource visualization**: Comprehensive views of your resource dependencies and health status.
 
     :::image type="content" source="media/sre-agent/sre-agent-knowldege-graph.png" alt-text="Screenshot of an SRE Agent knowledge graph.":::
 
-An SRE Agent works to proactively monitor and maintain your Azure services. Each day your agent creates daily resource reports which provide insights into the health and status of your applications. Reports include:
+An SRE Agent works to proactively monitor and maintain your Azure services. Each day your agent creates daily resource reports which provide insights into the health and status of your applications.
 
-- **Actionable steps**: Measures you can take each day to reduce errors and harden security practices.
+Reports include:
 
-- **Key insights**: Summaries of important details relevant to the health and maintenance of your Azure resources.
+- **Incident summary:** Generates information about incidents raised by the SRE Agent on the previous day. Categories include: active, mitigated, or resolved.
 
-- **Reasoning**: Summaries of analysis done by your agent helping surface possible problem areas in your apps.
+- **Application group performance and health:** Key metrics for each application group to assess system stability and performance. Metrics include: availability, CPU usage, and memory usage.
 
-- **Actions already taken by the agent**: A list of tasks the agent did on your behalf for the day.
+- **Action summary:** Summaries of important details and insights relevant to the health and maintenance of your Azure resources.
 
 ## Scenarios
 
@@ -67,3 +73,56 @@ An agent can provide detailed information about different aspects of your apps a
 ## Preview access
 
 Access to an SRE Agent is only available as a limited preview. To sign up for access, fill out the [SRE Agent application](https://go.microsoft.com/fwlink/?linkid=2319540).
+
+## Frequently asked questions
+
+### What is Azure SRE Agent, what can it do, and what are its intended uses?
+
+The Azure SRE Agent is a system designed to assist Site Reliability Engineers (SREs) in managing their Azure resources. Agents perform tasks such as monitoring, diagnosing, and mitigating issues.
+
+The system takes your input on the resources it manages, the health or status of specific resources, and any issues to those resources.
+
+Outputs from the agent include:
+
+- Information about resources
+- Mitigations and solutions to issues
+- Recommendations on best practices
+- Actions to resolve issues or implement best practices with user approval
+
+The Azure SRE Agent offers functionalities to assist SREs in managing Azure resources. Agents monitor system metrics and logs to detect issues early, diagnose the root causes of problems, and implement fixes and preventive measures to avoid future incidents. Examples of tasks the agent can handle include:
+
+- Diagnosing and troubleshooting "application down" scenarios
+- Getting resource availability information
+- Ensuring Azure resources are following best practices.
+
+The agent performs actions on behalf of the user with the right approvals and permissions, ensuring that humans remain in control.
+
+The intended use of the SRE Agent is to help you monitor, diagnose issues, and maintain your Azure resources. The agent is designed to improve the reliability and efficiency of software systems by handling tasks like:
+
+- Reading customer resource metrics and logs
+- Provide mitigations or recommendations
+- Perform actions on the customer's behalf with the right approvals and permissions
+
+The agent aims to reduce the toil of SREs by automating routine tasks and providing insights and recommendations to enhance system reliability.
+
+### How was SRE Agent evaluated? What metrics are used to measure performance?
+
+The SRE Agent was evaluated through various assessment activities, including user validation, measurement, and mitigations. Metrics used to measure performance include the accuracy of diagnostics, the effectiveness of mitigations, and user feedback on the agent's recommendations.
+
+The evaluation process involved testing the agent's capabilities across different scenarios, such as app availability and incident response, to ensure its reliability and effectiveness. Results are generalizable across use cases that weren't part of the initial evaluation. The agent's design allows it to adapt to different situations and provide consistent performance.
+
+### What are the limitations of SRE Agent? How can impact of SRE Agent’s limitations be minimized?
+
+The known limitations of the SRE Agent include its reliance on user approval for performing actions, which can slow down the response time in critical situations. Additionally, the agent might not be able to solve all problems or could produce inaccurate recommendations due to limitations in its knowledge base.
+
+You can minimize the impact of these limitations by providing detailed and accurate inputs, regularly updating the agent's configuration, and closely monitoring its actions. Ensuring a human SRE reviews and validates the agent's recommendations also helps mitigate potential errors.
+
+### What operational factors and settings allow for effective and responsible use of SRE Agent?
+
+Effective and responsible use of the SRE Agent requires configuring the system to manage the appropriate resources and setting up permissions and approvals for actions. Ensuring that the agent operates within defined parameters and regularly reviewing its actions can help maintain reliability and safety.
+
+### How do I provide feedback?
+
+The current feedback system for the Azure SRE Agent includes thumbs-up and thumbs-down buttons for you to rate the quality of the agent's responses.
+
+When you select either the thumbs-up or thumbs-down button, a small pop-up appears in the same view containing a text box for free-form text feedback. You can enter submit comments here to help the development identify areas for improvement.

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

@@ -0,0 +1,78 @@
+---
+title: Create and use an Azure SRE Agent
+description: Learn to use an automated agent to resolve problems and keep your apps running in Azure.
+author: craigshoemaker
+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 **Azure SRE Agent**.
+
+1. Locate your agent in the list and select the agent name.
+
+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
+
+- [Azure 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