Update README.md

pollyndos · web-flow · commit 7ec7157cc1bd · 2025-01-07T14:59:59.000+04:00
diff --git a/README.md b/README.md
@@ -3,39 +3,40 @@
 [![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183)
 [![](https://img.shields.io/badge/💬_Leave_Feedback-feecdd?style=flat-square)](#does-this-example-address-your-development-requirementsobjectives)
 <!-- default badges end -->
-# Report Viewer and Grid for Blazor —  Integrate an AI Assistant based on Azure OpenAI
+# Blazor Grid and Report Viewer — Incorporate an AI Assistant (Azure OpenAI) in your next DevExpress-powered Blazor app 
 
-This example adds a Copilot-inspired chat window (the [`DxAIChat`](http://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat) component) to a Blazor application with DevExpress Report Viewer and Grid components. The chat utilizes an [Azure OpenAI Assistant](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/assistant) to answer user questions based on information displayed in the report and/or data grid.
+This example adds a Copilot-inspired chat window (DevExpress [`DxAIChat`](http://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat) component) to a DevExpress-powered Blazor application (using both the DevExpress Report Viewer and Blazor Grid component). Our chat implementation utilizes [Azure OpenAI Assistant](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/assistant) to answer user questions based on information displayed in the report and/or data grid. 
 
-To integrate an AI-powered chat into your application, complete the following key steps: 
+To integrate AI-powered chat capabilities to your next great Blazor application, please follow the steps below:  
 
-1. Register AI Services in the application.
-2. Add a `DxAIChat` component.
-3. Export component data and pass it to the AI Assistant.
+1. Register AI Services within the application. 
+2. Add the DevExpress Chat component (`DxAIChat`). 
+3. Export component data and pass it to the AI Assistant. 
 
-This example uses the following DevExpress Blazor Components:
+The following DevExpress Blazor Components were used in this sample project:
 
-- [Grid](https://www.devexpress.com/blazor/data-grid/)
+- [DevExpress Blazor Grid](https://www.devexpress.com/blazor/data-grid/)
+
+    Our Blazor Grid component displays project management data. You can use the AI Assistant to:
 
-    The Grid component displays project management data. You can use the AI Assistant to:
     - Prioritize tasks.
-    - Count tasks with a specific status.
-    - Filter tasks by owner or priority.
+    - Count tasks using status data.
+    - Filter tasks by owner or priority. 
 
     Implementation details: [Use an AI Assistant with the DevExpress Blazor Grid](#use-an-ai-assistant-with-the-devexpress-blazor-grid).
 
 - [Report Viewer](https://www.devexpress.com/subscriptions/reporting/)
 
-    The Report Viewer includes several reports bound to different data. Use the AI Assistant to interact with report data:
+    Our Report Viewer includes several reports bound to different data. Use the AI Assistant to interact with report data as follows: 
 
-    - *Drill-Down Report*: Analyze invoice totals, delivery statuses, and averages.
+    - *Drill-Down Report*: Analyze invoice totals, delivery status, and averages. 
     - *Market Share Report*: Compare market share changes across regions.
-    - *Restaurant Menu*: Examine price ranges and categorize vegetarian options.
+    - *Restaurant Menu*: Examine price range and categorize vegetarian options. 
 
-    Implementation details: [Use an AI Assistant with the DevExpress Blazor Report Viewer](#use-an-ai-assistant-with-the-devexpress-report-viewer).
+    Implementation details: [Add an AI Assistant to the DevExpress Blazor Report Viewer](#add-an-ai-assistant-to-the-devexpress-report-viewer).
 
 >[!NOTE]
-> Open AI Assistant initialization may take some time. `DxAIChat` is ready for use once the Microsoft Azure OpenAI service completes the source document scan. This example uses the following source documents: Excel file exported from the data grid and PDF file exported from the report viewer.
+> Open AI Assistant initialization may take time. `DxAIChat` is ready for use once Microsoft Azure OpenAI completes its source document scan.
 
 ## Implementation Details
 
@@ -44,7 +45,7 @@ This example uses the following DevExpress Blazor Components:
 > [!NOTE]  
 > DevExpress AI-powered extensions follow the "bring your own key" principle. DevExpress does not offer a REST API and does not ship any built-in LLMs/SLMs. You need an active Azure/Open AI subscription to obtain the REST API endpoint, key, and model deployment name. These variables must be specified at application startup to register AI clients and enable DevExpress AI-powered Extensions in your application.
 
-Add the following code snippet to the *Program.cs* file to register AI Services and an [OpenAI Assistant](https://platform.openai.com/docs/assistants/overview) in your application:
+Add the following code snippet to the *Program.cs* file to register AI Services and incorporate an [OpenAI Assistant](https://platform.openai.com/docs/assistants/overview) in your application:
 
 ```cs
 using Azure.AI.OpenAI;
@@ -67,21 +68,22 @@ builder.Services.AddDevExpressAI((config) => {
 });
 ```
 
-For more information on the use of AI Assistants with `DxAIChat` and managing messages with custom RAG (Retrieval-Augmented Generation) solutions, refer to the following topic: [AI Service Assistants in the DxAIChat component](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat#ai-service-assistants).
+For additional information on the use of AI Assistants with `DxAIChat` and managing messages with custom RAG (Retrieval-Augmented Generation) solutions, refer to the following topic: [AI Service Assistants in the DxAIChat component](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat#ai-service-assistants).
 
-Note that the availability of Azure Open AI Assistants depends on the region. For more details, refer to the following article: [Azure OpenAI Service models -- Assistants (Preview)](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#assistants-preview).
+>[!NOTE]
+> The availability of Azure Open AI Assistants depends on region. For additional guidance in this regard, refer to the following document: [Azure OpenAI Service models -- Assistants (Preview)](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#assistants-preview).
 
 **Files to Review:**
 
 - [Program.cs](./DevExpress.AI.Samples.Blazor/Program.cs)
 
 ### Use an AI Assistant with the DevExpress Blazor Grid
 
-One page in this example displays `DxGrid` and `DxAIChat` components:
+This example includes a page with both the DevExpress Blazor Grid (`DxGrid`) and Blazor Chat component (`DxAIChat`): 
 
 ![Blazor Grid and Integrated AI Assistant](images/data-grid.png)
 
-For `DxGrid` configuration (data binding and customizations), review the following code file: [Grid.razor](./DevExpress.AI.Samples.Blazor/Components/Pages/Grid.razor).
+To configure our Blazor Grid (data binding and customizations), review the following code file: [Grid.razor](./DevExpress.AI.Samples.Blazor/Components/Pages/Grid.razor).
 
 #### Add AI Chat to the Grid Page
 
@@ -117,7 +119,7 @@ Use the [`MessageContentTemplate`](https://docs.devexpress.com/Blazor/DevExpress
 
 #### Set Up the AI Assistant
 
-Handle the `OnAfterRenderAsync` event and call the [`SetupAssistantAsync`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.IAIChat.SetupAssistantAsync(DevExpress.AIIntegration.Services.Assistant.AIAssistantOptions)) method to create an AI assistant and provide it with data and instructions. This example calls the grid's [`ExportToXlsxAsync`](https://docs.devexpress.com/Blazor/DevExpress.Blazor.DxGrid.ExportToXlsxAsync.overloads) method to generate data for the AI Assistant. 
+Handle the `OnAfterRenderAsync` event and call the [`SetupAssistantAsync`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.IAIChat.SetupAssistantAsync(DevExpress.AIIntegration.Services.Assistant.AIAssistantOptions)) method to create your AI assistant and provide it with data and instructions. This example calls our Blazor Grid's [`ExportToXlsxAsync`](https://docs.devexpress.com/Blazor/DevExpress.Blazor.DxGrid.ExportToXlsxAsync.overloads) method to generate data for the AI Assistant. 
 
 ```razor
 @using DevExpress.AIIntegration.OpenAI.Services
@@ -145,22 +147,22 @@ Handle the `OnAfterRenderAsync` event and call the [`SetupAssistantAsync`](https
 }
 ```
 
-You can review and tailor assistant instructions according to your needs in the following file: [Instructions.cs](./DevExpress.AI.Samples.Blazor/Instructions.cs).
+You can review and tailor AI assistant instructions in the following file: [Instructions.cs](./DevExpress.AI.Samples.Blazor/Instructions.cs).
 
-For information on OpenAI Assistants, refer to the following article: [Assistants API overview](https://platform.openai.com/docs/assistants/overview).
+For information on OpenAI Assistants, refer to the following document: [Assistants API overview](https://platform.openai.com/docs/assistants/overview).
 
 **Files to Review:**
 
 - [Grid.razor](./DevExpress.AI.Samples.Blazor/Components/Pages/Grid.razor)
 - [Instructions.cs](./DevExpress.AI.Samples.Blazor/Instructions.cs)
 
-###  Use an AI Assistant with the DevExpress Blazor Report Viewer
+###  Add an AI Assistant to the DevExpress Blazor Report Viewer
 
-The following image displays the Blazor Report Viewer UI implemented in this example. The AI Assistant tab uses the `DxAIChat` component to display requests and responses:
+As you can see in the following image, this sample uses our Blazor Report Viewer alongside the DevExpress Chat component (the AI Assistant tab uses the `DxAIChat` component to display requests and responses): 
 
 ![Blazor Report Viewer and Integrated AI Assistant](images/report-viewer.png)
 
-#### Add New Tab for AI Assistant
+#### Add New Tab for Your AI Assistant
 
 Use the [`OnCustomizeTabs`](https://docs.devexpress.com/XtraReports/DevExpress.Blazor.DxViewer.OnCustomizeTabs) event to add a new tab: 
 
@@ -192,7 +194,7 @@ Use the [`OnCustomizeTabs`](https://docs.devexpress.com/XtraReports/DevExpress.B
 
 A new [`TabModel`](https://docs.devexpress.com/XtraReports/DevExpress.Blazor.Reporting.Models.TabModel._members) object is added to the tab list. The [`UserAssistantTabContentModel`](https://github.com/DevExpress-Examples/blazor-grid-and-report-viewer-integrate-ai-assistant/blob/24.2.3%2B/CS/DevExpress.AI.Samples.Blazor/Models/UserAssistantTabContentModel.cs#L6) class implements the [`ITabContentModel`](https://docs.devexpress.com/XtraReports/DevExpress.Blazor.Reporting.Models.ITabContentModel) interface that specifies AI Assistant tab visibility. The tab is only visible when the report is initialized and contains at least one page.
 
-The `TabTemplate` property specifies the tab content. It dynamically renders the `DxAIChat` component inside the tab and passes the `ContentModel` as a parameter to control the tab's content.
+The `TabTemplate` property specifies tab content. It dynamically renders the `DxAIChat` component inside the tab and passes `ContentModel` as a parameter to control tab content.
 
 The content for the AI Assistant tab is defined in the following file: [AITabRenderer.razor](./DevExpress.AI.Samples.Blazor/Components/Reporting/AITabRenderer.razor). 
 
@@ -213,7 +215,7 @@ The content for the AI Assistant tab is defined in the following file: [AITabRen
 @code {
     [Parameter] public UserAssistantTabContentModel Model { get; set; }
     string ClearAnnotations(string text) {
-    //To clear out the annotations in a response from assistant.
+    //To clear out annotations in a response from the assistant.
         return Regex.Replace(text, @"\【.*?】", "");
     }
     
@@ -234,7 +236,7 @@ Use the [`MessageContentTemplate`](https://docs.devexpress.com/Blazor/DevExpress
 
 #### Set Up the AI Assistant
 
-Handle the [`Initialized`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat.Initialized) event and call the [`SetupAssistantAsync`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.IAIChat.SetupAssistantAsync(DevExpress.AIIntegration.Services.Assistant.AIAssistantOptions)) method to create an AI assistant and provide it with data and instructions. This example calls the [`ExportToPdf`](https://docs.devexpress.com/CoreLibraries/DevExpress.XtraPrinting.PrintingSystemBase.ExportToPdf(System.IO.Stream)) method to generate data for the AI Assistant:
+Handle the [`Initialized`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.DxAIChat.Initialized) event and call the [`SetupAssistantAsync`](https://docs.devexpress.com/Blazor/DevExpress.AIIntegration.Blazor.Chat.IAIChat.SetupAssistantAsync(DevExpress.AIIntegration.Services.Assistant.AIAssistantOptions)) method to create your AI assistant and provide it with data and instructions. This example calls the [`ExportToPdf`](https://docs.devexpress.com/CoreLibraries/DevExpress.XtraPrinting.PrintingSystemBase.ExportToPdf(System.IO.Stream)) method to generate data for the AI Assistant:
 
 ```razor
 @using DevExpress.AIIntegration.Blazor.Chat
@@ -256,7 +258,7 @@ Handle the [`Initialized`](https://docs.devexpress.com/Blazor/DevExpress.AIInteg
 }
 ```
 
-You can review and tailor instructions to your needs in the following file: [Instructions.cs](./DevExpress.AI.Samples.Blazor/Instructions.cs).
+You can review and tailor AI assistant instructions in the following file: [Instructions.cs](./DevExpress.AI.Samples.Blazor/Instructions.cs).
 
 For information on OpenAI Assistants, refer to the following article: [Assistants API overview](https://platform.openai.com/docs/assistants/overview).
 
