From 4657cfd1e8aab21d504c788e446a15b524058a1d Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Tue, 2 Jun 2026 17:16:01 +0400 Subject: [PATCH 1/9] Grids AI Assistant: Add How-To Topics --- .../12 AI Assistant/00 AI Assistant.md | 21 +++ .../05 Configuration and Use.md | 19 +++ .../10 Response Customization.md | 154 ++++++++++++++++++ .../15 Specifics and Best Practices.md | 14 ++ .../07 AI Assistant/00 AI Assistant.md | 14 ++ .../05 Configuration and Use.md | 19 +++ .../10 Response Customization.md | 154 ++++++++++++++++++ .../15 Specifics and Best Practices.md | 14 ++ 8 files changed, 409 insertions(+) create mode 100644 concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md create mode 100644 concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md create mode 100644 concepts/05 UI Components/DataGrid/12 AI Assistant/10 Response Customization.md create mode 100644 concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md create mode 100644 concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md create mode 100644 concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md create mode 100644 concepts/05 UI Components/TreeList/07 AI Assistant/10 Response Customization.md create mode 100644 concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md new file mode 100644 index 0000000000..7bf1319a9c --- /dev/null +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md @@ -0,0 +1,21 @@ +#include common-ctp-note-wo-devextreme + +The {WidgetName} AI Assistant allows you to interact with the component using natural language. + +You can use/configure the following DataGrid features via AI Assistant Chat prompts: + +- [Filtering and Searching](/Documentation/Guide/UI_Components/DataGrid/Filtering_and_Searching/) +- [Sorting](/Documentation/Guide/UI_Components/DataGrid/Sorting/) +- [Grouping](/Documentation/Guide/UI_Components/DataGrid/Grouping/) +- [Paging](/Documentation/Guide/UI_Components/DataGrid/Paging/) +- [Focused Row](/Documentation/Guide/UI_Components/DataGrid/Focused_Row/) +- [Selection](/Documentation/Guide/UI_Components/DataGrid/Selection/) +- [Summaries](/Documentation/Guide/UI_Components/DataGrid/Summaries/Predefined_Aggregate_Functions/) +- [Column Fixing](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Fixing/), [Resizing](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Sizing/), and [Reordering](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Reordering/) + +#include common-demobutton-named with { + url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/AIAssistant/", + name: "DataGrid - AI Assistant" +} + +[tags] ctp \ No newline at end of file diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md new file mode 100644 index 0000000000..da4de54542 --- /dev/null +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md @@ -0,0 +1,19 @@ +To activate the AI Assistant, configure the following properties: + +- Specify [aiIntegration](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#aiIntegration) or **aiAssistant**.[aiIntegration](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#aiIntegration) +- Set **aiAssistant**.[enabled](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#enabled) to `true` + +Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to the component [toolbar](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/). This button opens the AI Assistant chat in a pop-up window. + +[note] + +To ensure users can access the AI assistant, note the following recommendations: + +- Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/#visible) to `false`). +- If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. + +[/note] + +You can specify [chat](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). + +You can also define **aiAssistant**.[title](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#title) to specify a custom title for the AI Assistant popup. \ No newline at end of file diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/10 Response Customization.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/10 Response Customization.md new file mode 100644 index 0000000000..680f7fecb6 --- /dev/null +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/10 Response Customization.md @@ -0,0 +1,154 @@ +AI Assistant allows you to customize AI responses using the following callbacks: + +- [customizeResponseTitle](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#customizeResponseTitle): Customizes response titles (first line in a response) +- [customizeResponseText](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#customizeResponseText): Customizes response messages (all lines below the title) + +You can use these callbacks to localize responses. The following code snippet uses the [locale()](/Documentation/ApiReference/Common/Utils/localization/#locale) utility method to specify response messages and titles for multiple locales: + +--- + +##### jQuery + + + 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 */ }; + } + }, + customizeResponseTitle(status, commandNames) { + switch (currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }, + }, + }); + +##### Angular + + + + + + + + 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 */ }; + } + }; + customizeResponseTitle = (status, commandNames) => { + switch (this.currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }; + } + +##### Vue + + + + + + +##### React + + + 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 customizeResponseTitle(status, commandNames) { + switch (currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }; + + function App() { + return ( + <{WidgetName}> + + + ); + }; + +--- diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md new file mode 100644 index 0000000000..8a9221299d --- /dev/null +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -0,0 +1,14 @@ +Note the following AI Assistant specifics and best practices: + +- The assistant does not have access to component data out of the box. This can cause a command failure in certain usage scenarios. + + For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. + +- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). + +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the [request context](). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). + +- The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). + +#####See Also##### +- [DataGridPredefinedCommands](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/DataGridPredefinedCommands/) \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md new file mode 100644 index 0000000000..df122fcda1 --- /dev/null +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md @@ -0,0 +1,14 @@ +#include common-ctp-note-wo-devextreme + +The {WidgetName} AI Assistant allows you to interact with the component using natural language. + +You can use/configure the following TreeList features via AI Assistant Chat prompts: + +- [Filtering and Searching](/Documentation/Guide/UI_Components/TreeList/Filtering_and_Searching/) +- [Sorting](/Documentation/Guide/UI_Components/TreeList/Sorting/) +- [Paging](/Documentation/Guide/UI_Components/TreeList/Paging/) +- [Focused Row](/Documentation/Guide/UI_Components/TreeList/Focused_Row/) +- [Selection](/Documentation/Guide/UI_Components/TreeList/Selection/) +- [Column Fixing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Fixing/), [Resizing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Sizing/), and [Reordering](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Reordering/) + +[tags] ctp \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md new file mode 100644 index 0000000000..6cddb67075 --- /dev/null +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md @@ -0,0 +1,19 @@ +To activate the AI Assistant, configure the following properties: + +- Specify [aiIntegration](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#aiIntegration) or **aiAssistant**.[aiIntegration](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#aiIntegration) +- Set **aiAssistant**.[enabled](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#enabled) to `true` + +Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to the component [toolbar](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/). This button opens the AI Assistant chat in a pop-up window. + +[note] + +To ensure users can access the AI assistant, note the following recommendations: + +- Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/#visible) to `false`). +- If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. + +[/note] + +You can specify [chat](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). + +You can also define **aiAssistant**.[title](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#title) to specify a custom title for the AI Assistant popup. \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/10 Response Customization.md b/concepts/05 UI Components/TreeList/07 AI Assistant/10 Response Customization.md new file mode 100644 index 0000000000..3c71c7f5e7 --- /dev/null +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/10 Response Customization.md @@ -0,0 +1,154 @@ +AI Assistant allows you to customize AI responses using the following callbacks: + +- [customizeResponseTitle](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#customizeResponseTitle): Customizes response titles (first line in a response) +- [customizeResponseText](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#customizeResponseText): Customizes response messages (all lines below the title) + +You can use these callbacks to localize responses. The following code snippet uses the [locale()](/Documentation/ApiReference/Common/Utils/localization/#locale) utility method to specify response messages and titles for multiple locales: + +--- + +##### jQuery + + + 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 */ }; + } + }, + customizeResponseTitle(status, commandNames) { + switch (currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }, + }, + }); + +##### Angular + + + + + + + + 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 */ }; + } + }; + customizeResponseTitle = (status, commandNames) => { + switch (this.currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }; + } + +##### Vue + + + + + + +##### React + + + 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 customizeResponseTitle(status, commandNames) { + switch (currentLocale) { + case 'en': + return `${status.toUpperCase()}: ${commandNames.join(', ')}`; + case 'fr': + return /* Translated texts */; + } + }; + + function App() { + return ( + <{WidgetName}> + + + ); + }; + +--- diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md new file mode 100644 index 0000000000..b2aa247b65 --- /dev/null +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -0,0 +1,14 @@ +Note the following AI Assistant specifics and best practices: + +- The assistant does not have access to component data out of the box. This can cause a command failure in certain usage scenarios. + + For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. + +- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). + +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the [request context](). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/selection/#deferred). + +- The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). + +#####See Also##### +- [PredefinedCommands](/Documentation/ApiReference/Common_Types/grids/PredefinedCommands/) \ No newline at end of file From 5ea1608f01d3b01a8d70c68ac7eaf07a1e392340 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Tue, 2 Jun 2026 17:40:27 +0400 Subject: [PATCH 2/9] Add Minor Fixes --- .../DataGrid/12 AI Assistant/00 AI Assistant.md | 2 +- .../DataGrid/12 AI Assistant/05 Configuration and Use.md | 4 ++-- .../12 AI Assistant/15 Specifics and Best Practices.md | 2 +- .../TreeList/07 AI Assistant/00 AI Assistant.md | 2 +- .../TreeList/07 AI Assistant/05 Configuration and Use.md | 4 ++-- .../07 AI Assistant/15 Specifics and Best Practices.md | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md index 7bf1319a9c..23629faf62 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md @@ -2,7 +2,7 @@ The {WidgetName} AI Assistant allows you to interact with the component using natural language. -You can use/configure the following DataGrid features via AI Assistant Chat prompts: +You can use and configure the following DataGrid features via AI Assistant Chat prompts: - [Filtering and Searching](/Documentation/Guide/UI_Components/DataGrid/Filtering_and_Searching/) - [Sorting](/Documentation/Guide/UI_Components/DataGrid/Sorting/) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md index da4de54542..290307e4d1 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md @@ -7,13 +7,13 @@ Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to t [note] -To ensure users can access the AI assistant, note the following recommendations: +To ensure users can access the AI Assistant, note the following recommendations: - Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/#visible) to `false`). - If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. [/note] -You can specify [chat](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). +You can specify [chat](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configuration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). You can also define **aiAssistant**.[title](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/aiAssistant/#title) to specify a custom title for the AI Assistant popup. \ No newline at end of file diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index 8a9221299d..e1374add05 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -6,7 +6,7 @@ Note the following AI Assistant specifics and best practices: - AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). -- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the [request context](). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). - The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md index df122fcda1..db3e017614 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md @@ -2,7 +2,7 @@ The {WidgetName} AI Assistant allows you to interact with the component using natural language. -You can use/configure the following TreeList features via AI Assistant Chat prompts: +You can use and configure the following TreeList features via AI Assistant Chat prompts: - [Filtering and Searching](/Documentation/Guide/UI_Components/TreeList/Filtering_and_Searching/) - [Sorting](/Documentation/Guide/UI_Components/TreeList/Sorting/) diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md index 6cddb67075..6fccb929dd 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md @@ -7,13 +7,13 @@ Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to t [note] -To ensure users can access the AI assistant, note the following recommendations: +To ensure users can access the AI Assistant, note the following recommendations: - Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/#visible) to `false`). - If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. [/note] -You can specify [chat](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). +You can specify [chat](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#chat) and [popup](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#popup) objects in **aiAssistant** to customize the assistant window. These objects support DevExtreme [Chat](/Documentation/ApiReference/UI_Components/dxChat/Configuration/) and [Popup](/Documentation/ApiReference/UI_Components/dxPopup/Configuration/) configuration and allow you to integrate options such as [Chat suggestions](/Documentation/ApiReference/UI_Components/dxChat/Configuration/#suggestions). You can also define **aiAssistant**.[title](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/aiAssistant/#title) to specify a custom title for the AI Assistant popup. \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index b2aa247b65..a73c695eef 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -6,7 +6,7 @@ Note the following AI Assistant specifics and best practices: - AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). -- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the [request context](). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/selection/#deferred). +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxTreeList/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/selection/#deferred). - The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). From b2504f90199be026aceb8a07a3e058644ca6df58 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Tue, 2 Jun 2026 17:50:23 +0400 Subject: [PATCH 3/9] Update TreeList Recommendation --- .../TreeList/07 AI Assistant/15 Specifics and Best Practices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index a73c695eef..3999dc339a 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -6,7 +6,7 @@ Note the following AI Assistant specifics and best practices: - AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). -- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxTreeList/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/selection/#deferred). +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxTreeList/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#onAIAssistantRequestCreating)). - The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). From 621129fa1b443bd5ad77ec50d48fc309da62bb55 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 3 Jun 2026 17:14:14 +0400 Subject: [PATCH 4/9] Update Specifics --- .../12 AI Assistant/15 Specifics and Best Practices.md | 4 +++- .../07 AI Assistant/15 Specifics and Best Practices.md | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index e1374add05..6405766d27 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. This can cause a command failure in certain usage scenarios. +- The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. @@ -10,5 +10,7 @@ Note the following AI Assistant specifics and best practices: - The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). +- If you expect users to request certain commands in the AI Assistant, ensure the corresponding {WidgetName} feature is enabled to avoid command failures. + #####See Also##### - [DataGridPredefinedCommands](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/DataGridPredefinedCommands/) \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index 3999dc339a..e868d691cf 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. This can cause a command failure in certain usage scenarios. +- The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. @@ -10,5 +10,7 @@ Note the following AI Assistant specifics and best practices: - The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). +- If you expect users to request certain commands in the AI Assistant, ensure the corresponding {WidgetName} feature is enabled to avoid command failures. + #####See Also##### - [PredefinedCommands](/Documentation/ApiReference/Common_Types/grids/PredefinedCommands/) \ No newline at end of file From 54f1e7626e8dea5fe70fb6d2247439569ae22e36 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 3 Jun 2026 17:16:59 +0400 Subject: [PATCH 5/9] Remove CTP Tags & Notes --- .../DataGrid/12 AI Assistant/00 AI Assistant.md | 4 ---- .../TreeList/07 AI Assistant/00 AI Assistant.md | 4 ---- 2 files changed, 8 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md index 23629faf62..ee3eb3a904 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md @@ -1,5 +1,3 @@ -#include common-ctp-note-wo-devextreme - The {WidgetName} AI Assistant allows you to interact with the component using natural language. You can use and configure the following DataGrid features via AI Assistant Chat prompts: @@ -17,5 +15,3 @@ You can use and configure the following DataGrid features via AI Assistant Chat url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/AIAssistant/", name: "DataGrid - AI Assistant" } - -[tags] ctp \ No newline at end of file diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md index db3e017614..9f21040aeb 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md @@ -1,5 +1,3 @@ -#include common-ctp-note-wo-devextreme - The {WidgetName} AI Assistant allows you to interact with the component using natural language. You can use and configure the following TreeList features via AI Assistant Chat prompts: @@ -10,5 +8,3 @@ You can use and configure the following TreeList features via AI Assistant Chat - [Focused Row](/Documentation/Guide/UI_Components/TreeList/Focused_Row/) - [Selection](/Documentation/Guide/UI_Components/TreeList/Selection/) - [Column Fixing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Fixing/), [Resizing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Sizing/), and [Reordering](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Reordering/) - -[tags] ctp \ No newline at end of file From e85e2708af618dcdc97afe501e88cd793ca94808 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Thu, 4 Jun 2026 09:59:39 +0400 Subject: [PATCH 6/9] Apply suggestions from code review Co-authored-by: Vladimir Abadzhev --- .../12 AI Assistant/00 AI Assistant.md | 18 +++++++++--------- .../05 Configuration and Use.md | 2 +- .../15 Specifics and Best Practices.md | 8 ++++---- .../07 AI Assistant/00 AI Assistant.md | 14 +++++++------- .../05 Configuration and Use.md | 2 +- .../15 Specifics and Best Practices.md | 6 +++--- 6 files changed, 25 insertions(+), 25 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md index ee3eb3a904..c3a6ba8883 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md @@ -1,15 +1,15 @@ The {WidgetName} AI Assistant allows you to interact with the component using natural language. -You can use and configure the following DataGrid features via AI Assistant Chat prompts: +You can use and configure the following {WidgetName} capabilities via AI Assistant Chat prompts: -- [Filtering and Searching](/Documentation/Guide/UI_Components/DataGrid/Filtering_and_Searching/) -- [Sorting](/Documentation/Guide/UI_Components/DataGrid/Sorting/) -- [Grouping](/Documentation/Guide/UI_Components/DataGrid/Grouping/) -- [Paging](/Documentation/Guide/UI_Components/DataGrid/Paging/) -- [Focused Row](/Documentation/Guide/UI_Components/DataGrid/Focused_Row/) -- [Selection](/Documentation/Guide/UI_Components/DataGrid/Selection/) -- [Summaries](/Documentation/Guide/UI_Components/DataGrid/Summaries/Predefined_Aggregate_Functions/) -- [Column Fixing](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Fixing/), [Resizing](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Sizing/), and [Reordering](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Reordering/) +- [Filter Rows and Search for Text/Values](/Documentation/Guide/UI_Components/DataGrid/Filtering_and_Searching/) +- [Sort Data](/Documentation/Guide/UI_Components/DataGrid/Sorting/) +- [Group Rows](/Documentation/Guide/UI_Components/DataGrid/Grouping/) +- [Navigate between Data Pages](/Documentation/Guide/UI_Components/DataGrid/Paging/) +- [Change Row Focus](/Documentation/Guide/UI_Components/DataGrid/Focused_Row/) +- [Select Rows](/Documentation/Guide/UI_Components/DataGrid/Selection/) +- [Calculate Summaries](/Documentation/Guide/UI_Components/DataGrid/Summaries/Predefined_Aggregate_Functions/) +- [Fix](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Fixing/), [Resize](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Sizing/), and [Reorder Columns](/Documentation/Guide/UI_Components/DataGrid/Columns/Column_Reordering/) #include common-demobutton-named with { url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/AIAssistant/", diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md index 290307e4d1..7561e8fcda 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/05 Configuration and Use.md @@ -7,7 +7,7 @@ Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to t [note] -To ensure users can access the AI Assistant, note the following recommendations: +Ensure users can access the AI Assistant: - Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/#visible) to `false`). - If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index 6405766d27..56f58aeebf 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -2,13 +2,13 @@ Note the following AI Assistant specifics and best practices: - The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. - For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. + For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. -- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). +- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). -- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can enable **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). +- If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can activate **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). -- The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). +- The assistant does not support certain actions that are only accessible in the component UI (for instance, it cannot expand/collapse groups). - If you expect users to request certain commands in the AI Assistant, ensure the corresponding {WidgetName} feature is enabled to avoid command failures. diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md index 9f21040aeb..baabdf0af4 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md @@ -1,10 +1,10 @@ The {WidgetName} AI Assistant allows you to interact with the component using natural language. -You can use and configure the following TreeList features via AI Assistant Chat prompts: +You can use and configure the following {WidgetName} capabilities via AI Assistant Chat prompts: -- [Filtering and Searching](/Documentation/Guide/UI_Components/TreeList/Filtering_and_Searching/) -- [Sorting](/Documentation/Guide/UI_Components/TreeList/Sorting/) -- [Paging](/Documentation/Guide/UI_Components/TreeList/Paging/) -- [Focused Row](/Documentation/Guide/UI_Components/TreeList/Focused_Row/) -- [Selection](/Documentation/Guide/UI_Components/TreeList/Selection/) -- [Column Fixing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Fixing/), [Resizing](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Sizing/), and [Reordering](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Reordering/) +- [Filter Rows and Search for Text/Values](/Documentation/Guide/UI_Components/TreeList/Filtering_and_Searching/) +- [Sort Data](/Documentation/Guide/UI_Components/TreeList/Sorting/) +- [Navigate between Pages](/Documentation/Guide/UI_Components/TreeList/Paging/) +- [Change Row Focus](/Documentation/Guide/UI_Components/TreeList/Focused_Row/) +- [Select Rows](/Documentation/Guide/UI_Components/TreeList/Selection/) +- [Fix](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Fixing/), [Resize](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Sizing/), and [Reorder Columns](/Documentation/Guide/UI_Components/TreeList/Columns/Column_Reordering/) diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md index 6fccb929dd..9c4fd20f88 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/05 Configuration and Use.md @@ -7,7 +7,7 @@ Once activated, {WidgetName} adds a predefined item (*"aiAssistantButton"*) to t [note] -To ensure users can access the AI Assistant, note the following recommendations: +Ensure users can access the AI Assistant: - Do not hide the {WidgetName} toolbar (do not set **toolbar**.[visible](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/#visible) to `false`). - If you define **toolbar**.[items[]](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/toolbar/items/), include *"aiAssistantButton"* in the array. diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index e868d691cf..447ddc8069 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -2,13 +2,13 @@ Note the following AI Assistant specifics and best practices: - The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. - For instance, to select the last row on a page (when [paging](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/) is enabled), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. + For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. -- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (using keywords such as "also" or "only"). +- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). - If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxTreeList/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#onAIAssistantRequestCreating)). -- The assistant does not support certain actions that are only accessible in the component UI (for instance, expanding/collapsing groups). +- The assistant does not support certain actions that are only accessible in the component UI (for instance, it cannot expand/collapse groups). - If you expect users to request certain commands in the AI Assistant, ensure the corresponding {WidgetName} feature is enabled to avoid command failures. From 6c32e723731f57e90c99245b4f353037c3d73ff2 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Thu, 4 Jun 2026 14:42:53 +0400 Subject: [PATCH 7/9] Remove Security Note --- .../DataGrid/12 AI Assistant/15 Specifics and Best Practices.md | 2 +- .../TreeList/07 AI Assistant/15 Specifics and Best Practices.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index 56f58aeebf..97d27a3ea8 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. +- The assistant does not have access to component data out of the box. In certain usage scenarios, this approach can cause commands to fail. For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index 447ddc8069..777976fc1c 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. This prevents AI services from accessing user data and improves the AI Assistant's security. In certain usage scenarios, this approach can cause commands to fail. +- The assistant does not have access to component data out of the box. In certain usage scenarios, this approach can cause commands to fail. For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. From e9bb54739bf618c4b51d5462395edf5510183482 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Fri, 5 Jun 2026 11:33:27 +0400 Subject: [PATCH 8/9] Apply suggestions from code review Co-authored-by: dirkpieterse --- .../DataGrid/12 AI Assistant/00 AI Assistant.md | 2 +- .../DataGrid/12 AI Assistant/15 Specifics and Best Practices.md | 2 +- .../TreeList/07 AI Assistant/15 Specifics and Best Practices.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md index c3a6ba8883..af35f4cddb 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/00 AI Assistant.md @@ -1,4 +1,4 @@ -The {WidgetName} AI Assistant allows you to interact with the component using natural language. +The {WidgetName} AI Assistant allows you to use natural language to interact with the component. You can use and configure the following {WidgetName} capabilities via AI Assistant Chat prompts: diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index 97d27a3ea8..501c4bf88e 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. In certain usage scenarios, this approach can cause commands to fail. +- The assistant does not have access to component data by default. In some scenarios, this can cause commands to fail. For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index 777976fc1c..e6dfd1d979 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -4,7 +4,7 @@ Note the following AI Assistant specifics and best practices: For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. -- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). +- AI Assistant may not preserve the results of executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). - If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxTreeList/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#onAIAssistantRequestCreating)). From fefa68c6df4817fab7273df4d5fa5ad17c3b4f55 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Fri, 5 Jun 2026 11:36:13 +0400 Subject: [PATCH 9/9] Synchronize Final Edits --- .../DataGrid/12 AI Assistant/15 Specifics and Best Practices.md | 2 +- .../TreeList/07 AI Assistant/00 AI Assistant.md | 2 +- .../TreeList/07 AI Assistant/15 Specifics and Best Practices.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md index 501c4bf88e..35ac720793 100644 --- a/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/DataGrid/12 AI Assistant/15 Specifics and Best Practices.md @@ -4,7 +4,7 @@ Note the following AI Assistant specifics and best practices: For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails. -- AI Assistant may not preserve results of previously executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). +- AI Assistant may not preserve the results of executed commands of the same type. Specify if the AI should preserve or discard previous results in your requests (include keywords such as "also" or "only"). - If {WidgetName} is bound to a large dataset, the `selectAll` command may increase the context size of requests beyond the limits of your AI service. The `selectAll` command adds all row keys to the request [context](/Documentation/ApiReference/UI_Components/dxDataGrid/Types/AIAssistantRequestCreatingEvent/#context) (in [onAIAssistantRequestCreating](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#onAIAssistantRequestCreating)). To avoid this behavior, you can activate **selection**.[deferred](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/selection/#deferred). diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md index baabdf0af4..6d41745ea5 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/00 AI Assistant.md @@ -1,4 +1,4 @@ -The {WidgetName} AI Assistant allows you to interact with the component using natural language. +The {WidgetName} AI Assistant allows you to use natural language to interact with the component. You can use and configure the following {WidgetName} capabilities via AI Assistant Chat prompts: diff --git a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md index e6dfd1d979..c6af2bfb58 100644 --- a/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md +++ b/concepts/05 UI Components/TreeList/07 AI Assistant/15 Specifics and Best Practices.md @@ -1,6 +1,6 @@ Note the following AI Assistant specifics and best practices: -- The assistant does not have access to component data out of the box. In certain usage scenarios, this approach can cause commands to fail. +- The assistant does not have access to component data by default. In some scenarios, this approach can cause commands to fail. For instance, to select the last row on a [page](/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/paging/), the assistant calls the `selectByIndexes` command and uses the page size to specify an index. If the number of rows on the active page is smaller than the page size, the command fails.