docs: Docs update only (#17)

* updated image

* Added data source description

* Added additional instructoin on how to create data agent

* simplified overviews

* simplified solution overview text and moved some text into architecture section

* made spikes more visbile for 1

* updated ui

* Added agent UI

* consistency check

* resolved broken links

* sample questions

* Update docs/FabricDataAgentGuide.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update docs/FabricDataAgentGuide.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update docs/FabricDataAgentGuide.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: DocGailZhou

README.md

@@ -1,6 +1,6 @@
 # Real-Time Intelligence for Operations Solution Accelerator
 
-This solution accelerator provides the architecture and working solution for real-time intelligence for operations. We used simulated manufacturing facility asset data for the process flow. As real-time events are streamed in, anomalies are detected with notifications sent to a specified Outlook email account. The solution includes a customized Fabric Data Agent that provides a chat experience to answer users' questions with intelligence derived from the data.
+This solution accelerator provides a complete real-time intelligence platform for manufacturing operations. It analyzes live and historical telemetry data through interactive dashboards, automatically detects anomalies with email alerts, and includes an AI-powered data agent for conversational insights. The architecture and approach can be easily extended to other industries for broad adoption.
 
 **Key use cases include:**
 
@@ -21,11 +21,11 @@ This solution accelerator provides the architecture and working solution for rea
 Solution overview
 </h2>
 
-This solution accelerator provides a working solution for manufacturing asset performance monitoring, real-time anomaly detection, and anomaly notification. The manufacturing facility telemetry data is synthetically generated with the `Telemetry Data Simulator`. This architecture can be extended to other industries as long as the appropriate data is generated or actual operations data is ingested into the `Azure Event Hub`, and related component configurations and Kusto Query Language (KQL) code are updated accordingly. For a brief description of the architecture, please refer to [Solution Architecture Overview](./docs/TechnicalArchitecture.md).
+This solution accelerator delivers comprehensive asset monitoring, real-time anomaly detection, and automated notifications for manufacturing operations. 
 
 ### Solution architecture
 
-Below diagram illustrates the solution architecture.
+Below diagram illustrates the solution architecture. Synthetic telemetry data is generated by the `Telemetry Data Simulator`. The architecture easily adapts to other industries by connecting your own data sources to `Azure Event Hub` and customizing the dashboards and queries. For technical details, see the [Solution Architecture Overview](./docs/TechnicalArchitecture.md).
 
 | ![image](./docs/images/readme/solution-architecture.png) |
 | -------------------------------------------------------- |
@@ -180,7 +180,7 @@ Use cases can be summarized as below:
   - **The solution provides multiple business functions with a simple architecture** <br/>
     The deployed solution provides real-time telemetry data monitoring, analysis, summarization, graphical reports, anomaly detection and notifications with a quick to deploy, secure, and simple architecture.
 
-  - **A Fabric Data Agent getting quick business intelligence without programming effort.** <br/>
+  - **A Fabric Data Agent getting quick business intelligence without programming effort** <br/>
     The Fabric Data Agent can be quickly configured with instructions delivered in this solution accelerator, providing quick and accurate insights from data effortlessly. No programming skills are necessary.
 
   - **Real-Time Intelligence for Operations Dashboard**<br/>

docs/AzureAccountSetUp.md

@@ -0,0 +1,14 @@
+## Azure account setup
+
+1. Sign up for a [free Azure account](https://azure.microsoft.com/free/) and create an Azure Subscription.
+2. Check that you have the necessary permissions:
+    * Your Azure account must have `Microsoft.Authorization/roleAssignments/write` permissions, such as [Role Based Access Control Administrator](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#role-based-access-control-administrator-preview), [User Access Administrator](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#user-access-administrator), or [Owner](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#owner).
+    * Your Azure account also needs `Microsoft.Resources/deployments/write` permissions on the subscription level.
+
+You can view the permissions for your account and subscription by following the steps below: 
+- Navigate to the [Azure Portal](https://portal.azure.com/) and click on `Subscriptions` under 'Navigation' 
+- Select the subscription you are using for this accelerator from the list. 
+    - If you try to search for your subscription and it does not come up, make sure no filters are selected.
+- Select `Access control (IAM)` and you can see the roles that are assigned to your account for this subscription. 
+    - If you want to see more information about the roles, you can go to the `Role assignments`
+     tab and search by your account name and then click the role you want to view more information about.

docs/DemonstratorGuide.md

@@ -45,7 +45,7 @@ When you open one of the emails, you will see something similar to below:
 
 ## Step 5. Demonstrate the Fabric Data Agent
 
-Please follow the [Fabric Data Agent Guide](./FabricDataAgentGuide.md) to understand how the Fabric Data Agent is created and set up. If it is not already set up, you can follow the instructions to create and configure a new Fabric Data Agent in minutes. After that, you can ask any questions you'd like the agent to answer. For starters, you can use the [sample questions and answers](./fabric_data_agent/sample_test_questions.md). 
+Please follow the [Fabric Data Agent Guide](./FabricDataAgentGuide.md) to understand how the Fabric Data Agent is created and set up. If it is not already set up, you can follow the instructions to create and configure a new Fabric Data Agent in minutes. After that, you can ask any questions you'd like the agent to answer. For starters, you can use the [sample test questions](./fabric_data_agent/user_sample_test_questions.md). 
 
 In the Fabric workspace, find the Fabric Data Agent that is already set up. You will be able to chat with the agent right away. Below is the user interface you can expect: 
 

docs/FabricDataAgentGuide.md

@@ -1,9 +1,9 @@
 # Fabric Data Agent Guide
 
-After you have deployed your solution, you can add Azure Data Agent to get data analysis features from Fabric built-in AI capabilities. You can follow [Microsoft's Fabric Data Agent Guide](https://learn.microsoft.com/en-us/fabric/data-science/how-to-create-data-agent) to create and set up your Fabric Data Agent, and use the materials provided here to set up your agent quickly. For example, you can 
+After you have deployed your solution, you can add Azure Data Agent to get data analysis features from Fabric built-in AI capabilities. You can follow [Microsoft's Fabric Data Agent Guide](https://learn.microsoft.com/en-us/fabric/data-science/how-to-create-data-agent) to create and set up your Fabric Data Agent, and use the materials provided here to set up your agent quickly. For example, you can create a new item, search for 'data agent', you will be presented the clickable resource to create a Fabric Data Agent. 
 
 - Create a Fabric Data Agent with a name, for example, `RTI_Data_Agent`,
-- Add the EventHouse created in the Fabric workspace as your data source,
+- Add the KQL Database created in the Fabric workspace as your data source,
 - Use the Agent configuration files provided below to set up your Fabric Data Agent. 
 
 ## 📁 Agent Configuration Files
@@ -15,16 +15,25 @@ This folder contains essential configuration files for setting up your Fabric Da
 **[Agent Instructions - Master Prompt](./fabric_data_agent/agent_instructions.md)**  
 Contains the primary instructions and behavior guidelines for your Fabric Data Agent. This file establishes the agent's role, scope, and response patterns.
 
+**[Data Source Description](./fabric_data_agent/data_source_descriptions.md)**  
+Provides a description of the data source. 
+
 **[Data Source Instructions](./fabric_data_agent/data_source_instructions.md)**  
 Provides detailed information about your data structure, table relationships, and query patterns. This helps the agent understand your data and deliver more accurate, efficient responses.
 
-**[Example Queries](./fabric_data_agent/example_queries.md)**  
-Training pairs that map business questions to proven KQL queries. These examples help your data agent learn optimal response patterns for common manufacturing scenarios.
+**Example Question and KQL Query Set**
+
+You can provide example questions and corresponding KQL query code as well. In the `docs/fabric_data_agent` folder, you will find the below files as starters:
+
+1. example_question_1.md and example_kql_code_1.md
+2. example_question_2.md and example_kql_code_2.md
+3. example_question_3.md and example_kql_code_3.md
+
+### Testing the Data Agent
 
-### Testing Files
+Once the Data Agent is set up with the above agent configuration files, you will be able to chat with the agent right away. You can also publish your data agent for others to use. Below is the user interface you can expect ([link to more sample test questions](./fabric_data_agent/user_sample_test_questions.md)): 
 
-**[Test Sample Questions](./fabric_data_agent/sample_test_questions.md)**  
-A collection of sample questions you can use to test your agent's performance and evaluate response quality. Ideal for sharing with your testing team to jumpstart validation efforts.
+![Fabric Data Agent UI](../docs/images/deployment/fabric_data_agent_ui.png)
 
 ## 💡 Customization Tips