Grids AI Assistant: Add API Descriptions Part 2

api-reference/10 UI Components/GridBase/1 Configuration/aiIntegration.md

@@ -8,15 +8,27 @@ default: undefined
 Binds the {WidgetName} to an AI service.
 
 ---
-To activate AI functionality in {WidgetName}, configure this object and assign *"ai"* to a column's [type](/api-reference/_hidden/dxDataGridColumn/type.md '{basewidgetpath}/Configuration/columns/#type') property.
+The DevExtreme {WidgetName} ships with the following AI features:
 
-This object configures options for all AI columns within the component. To configure AI options specific to a column, define **columns[]**.**ai**.[aiIntegration](/api-reference/40%20Common%20Types/15%20grids/ColumnAIOptions/aiIntegration.md '{basewidgetpath}/Configuration/columns/ai/#aiIntegration').
+- AI Columns
+- AI Assistant
+
+To activate these AI features, configure **aiIntegration** and specify {WidgetName} properties as follows:
+
+- Assign *"ai"* to a column's [type](/api-reference/_hidden/dxDataGridColumn/type.md '{basewidgetpath}/Configuration/columns/#type') property to implement an AI Column.
+- Set **aiAssistant**.[enabled]({basewidgetpath}/Configuration/aiAssistant/#enabled) to `true` to activate the AI Assistant.
+
+This object stores shared AI options for the {WidgetName} AI Assistant and all AI columns within the component. To configure AI options specific to a column, define **columns[]**.**ai**.[aiIntegration](/api-reference/40%20Common%20Types/15%20grids/ColumnAIOptions/aiIntegration.md '{basewidgetpath}/Configuration/columns/ai/#aiIntegration'). To configure AI options specific to the AI Assistant, define **aiAssistant**.[aiIntegration]({basewidgetpath}/Configuration/aiAssistant/#aiIntegration).
 
 #include common-demobutton-named with {
     url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/AIColumns/",
-    name: "DataGrid"
+    name: "DataGrid - AI Columns"
 }
 #include common-demobutton-named with {
     url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/TreeList/AIColumns/",
-    name: "TreeList"
-}
+    name: "TreeList - AI Columns"
+}
+#include common-demobutton-named with {
+    url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/AIAssistant/",
+    name: "DataGrid - AI Assistant"
+}

api-reference/10 UI Components/GridBase/1 Configuration/onAIAssistantRequestCreating.md

@@ -29,7 +29,7 @@ The model data. Available only if you use Knockout.
 The JSON schema of the AI Assistant response.
 
 ##### field(e.additionalInfo): Record
-<!-- Description goes here -->
+Additional information included in the AI Assistant request.
 
 ---
 Use this handler to modify the AI Assistant request.

api-reference/10 UI Components/dxDataGrid/1 Configuration/aiAssistant.md → api-reference/10 UI Components/dxDataGrid/1 Configuration/aiAssistant/aiAssistant.md

@@ -1,10 +1,11 @@
 ---
 id: dxDataGrid.Options.aiAssistant
 type: AIAssistant
+inheritsType: AIAssistant
 ---
 ---
 ##### shortDescription
-<!-- Description goes here -->
+Configures the {WidgetName} AI Assistant.
 
 ---
 <!-- Description goes here -->

api-reference/10 UI Components/dxDataGrid/1 Configuration/aiAssistant/customizeResponseText.md

@@ -0,0 +1,145 @@
+---
+id: dxDataGrid.Options.aiAssistant.customizeResponseText
+type: function(command)
+---
+---
+##### shortDescription
+Customizes AI Assistant response messages for each command.
+
+##### param(command): DataGridCommandInfo
+Information about the command.
+
+##### return: ResponseStatusTexts
+Custom messages for **success** and **failure** responses.
+
+---
+**customizeResponseText** is called for each command. Use this function to customize response messages for AI Assistant commands. The chat displays these messages below the response title. If a response includes multiple commands, the chat displays each message on a separate line.
+
+When a command succeeds, the AI Assistant chat displays the response in green and prefixes the text with a checkmark button emoji (✅). When a command fails, the AI Assistant chat displays the response in red and prefixes the text with a cross mark emoji (❌).
+
+The **command** parameter contains the following fields:
+
+- **name**: The command's name ([DataGridPredefinedCommandNames]({basewidgetpath}/Types/DataGridPredefinedCommandNames/)).
+- **args**: Command arguments. Refer to [DataGridPredefinedCommands]({basewidgetpath}/Types/DataGridPredefinedCommands/) for information about the arguments of each available command.
+
+Configure **customizeResponseText** to return an object with the following fields:
+
+- **success**: Text to display when the command succeeds.
+- **failure**: Text to display when the command fails.
+
+If you do not specify any of these fields, the AI Assistant chat displays the default message. 
+
+You can use this function to localize response text. The following code snippet uses the [locale()](/Documentation/ApiReference/Common/Utils/localization/#locale) method to specify text for multiple locales:
+
+---
+
+##### jQuery
+
+    <!-- tab: index.js -->
+    const currentLocale = DevExpress.localization.locale();
+
+    $('#{widget-name}-container').dx{WidgetName}({
+        aiAssistant: {
+            customizeResponseText(command) {
+                switch (currentLocale) {
+                    case 'en':
+                        return {
+                            success: `Command succeeded: ${command.name}`,
+                            failure: `Command failed: ${command.name}`,
+                        };
+                    case 'fr':
+                        return { /* Translated texts */ };
+                }
+            },
+        },
+    });
+
+##### Angular
+
+    <!-- tab: app.component.html -->
+    <dx-{widget-name}>
+        <dxo-{widget-name}-ai-assistant
+            [enabled]="true"
+            [customizeResponseText]="customizeResponseText"
+        ></dxo-{widget-name}-ai-assistant>
+    </dx-{widget-name}>
+
+    <!-- tab: app.component.ts -->
+    import { Dx{WidgetName}Module, type Dx{WidgetName}Types } from 'devextreme-angular/ui/{widget-name}';
+    import { locale } from "devextreme/localization";
+
+    export class AppComponent {
+        currentLocale = locale();
+        customizeResponseText = (command) => {
+            switch (this.currentLocale) {
+                case 'en':
+                    return {
+                        success: `Command succeeded: ${command.name}`,
+                        failure: `Command failed: ${command.name}`,
+                    };
+                case 'fr':
+                    return { /* Translated texts */ };
+            }
+        };
+    }
+
+##### Vue
+
+    <!-- tab: App.vue -->
+    <template>
+        <Dx{WidgetName}>
+            <DxAIAssistant
+                :customize-response-text="customizeResponseText"
+            />
+        </Dx{WidgetName}>
+    </template>
+
+    <script setup lang="ts">
+    import { Dx{WidgetName}, DxAIAssistant, type Dx{WidgetName}Types } from 'devextreme-vue/{widget-name}';
+    import { locale } from "devextreme/localization";
+
+    const currentLocale = locale();
+    function customizeResponseText(command) {
+        switch (currentLocale) {
+            case 'en':
+                return {
+                    success: `Command succeeded: ${command.name}`,
+                    failure: `Command failed: ${command.name}`,
+                };
+            case 'fr':
+                return { /* Translated texts */ };
+        }
+    };
+    </script>
+
+##### React
+
+    <!-- tab: App.tsx -->
+    import { {WidgetName}, AIAssistant, type {WidgetName}Types } from 'devextreme-react/{widget-name}';
+    import { locale } from "devextreme/localization";
+
+    const currentLocale = locale();
+    function customizeResponseText(command) {
+        switch (currentLocale) {
+            case 'en':
+                return {
+                    success: `Command succeeded: ${command.name}`,
+                    failure: `Command failed: ${command.name}`,
+                };
+            case 'fr':
+                return { /* Translated texts */ };
+        }
+    };
+
+    function App() {
+        return (
+            <{WidgetName}>
+                <AIAssistant
+                    enabled={true}
+                    customizeResponseText={customizeResponseText}
+                />
+            </{WidgetName}>
+        );
+    };
+
+---