Configure the AI Smart Assistant in .NET MAUI DataGrid

Updated on Feb 9, 2026

This article provides information on how to configure the AI Smart Assistant functionality in the .NET MAUI DataGrid control.

AI Smart Assistant Settings

You can configure the default settings for the AI Smart Assistant functionality using the AISettings (of type Telerik.Maui.Controls.DataGrid.DataGridAISettings) property of the DataGrid.

Below you can find a list of the available configuration options applied through the RadDataGrid.AISettings:

• InputText (string)—Specifies the text of the input field.
• SubmitPromptOnSelection (bool)—Specifies whether selecting a prompt should automatically submit the request. The default value is false.
• OpenOnFocus (bool)—Specifies whether the prompt input should open the suggestions dropdown when the input field is focused. The default value is true.
• IsSuggestedPromptsVisible (bool)—Specifies whether the suggested prompts should be visible. The default value is true.
• IsRecentPromptsVisible (bool)—Specifies whether the recent prompts should be visible. The default value is true.
• IsEmptyContentVisible (bool)—Specifies whether the empty content message should be visible when no suggestions are available. The default value is true.
• SuggestedPrompts (IEnumerable<string>)—Specifies the collection of suggested prompts.
• RecentPrompts (IEnumerable<string>)—Specifies the collection of recent prompts.

This is how the default AI Smart Assistant view looks like when there are no suggestions and recent prompts available and the IsEmptyContentVisible property is set to True:

Events

The DataGrid provides the following events related to AI Smart Assistant functionality:

• PromptRequest—Occurs when a prompt is submitted from the AI Smart Assistant panel.

  • The sender argument, which is of type object, but can be cast to the RadDataGrid type.
  • A DataGridPromptRequestEventArgs object, which provides the following properties:
    • Prompt—Gets the prompt text that was submitted from the user.
    • RequestJson—Specifies the JSON request sent to the AI model.
    • ResponseJson—Specifies the response text.
    • HasError—Specifies whether an error occurred during processing.

• CancelPromptRequest—Occurs when the user requests to cancel the current AI processing operation

  • The sender argument, which is of type object, but can be cast to the RadDataGrid type.
  • An EventHandler object.

Commands

• PromptRequestCommand (ICommand)—Gets the command that is executed when a prompt request is submitted. The command parameter is of type Telerik.Maui.Controls.DataGrid.DataGridPromptRequestCommandContext.
• CancelPromptRequestCommand (ICommand)—Gets the command that is executed when canceling a prompt request. The command parameter is of type object.

Example

Here is an example of how to configure the AI Smart Assistant settings in the .NET MAUI DataGrid:

1. Add the DataGrid definition in XAML:

xaml

<telerik:RadDataGrid x:Name="dataGrid"
                     AutoGenerateColumns="False"
                     IsAIEnabled="True"
                     UserEditMode="Cell"
                     UserGroupMode="Enabled"
                     PromptRequest="OnPromptRequest"
                     CancelPromptRequest="OnCancelPromptRequest"
                     Grid.Row="1">
    <telerik:RadDataGrid.AISettings>
        <telerik:DataGridAISettings x:Name="AISettings" />
    </telerik:RadDataGrid.AISettings>
    <telerik:RadDataGrid.Columns>
        <telerik:DataGridTextColumn PropertyName="Name" HeaderText="Name" />
        <telerik:DataGridTextColumn PropertyName="Position" HeaderText="Job Position" />
        <telerik:DataGridTextColumn PropertyName="City" HeaderText="City" />
        <telerik:DataGridTextColumn PropertyName="PostalCode" HeaderText="Postal Code" />
        <telerik:DataGridTextColumn PropertyName="Company" HeaderText="Company" />
    </telerik:RadDataGrid.Columns>
</telerik:RadDataGrid>

2. Add the telerik namespace:

xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"

3. Add a sample data model:

c#

public class Person
{
    public string Name { get; set; }

    public string Position { get; set; }

    public string City { get; set; }

    public string PostalCode { get; set; }

    public string Company { get; set; }
}

4. Define the data for the DataGrid ItemsSource:

c#

private void LoadSampleData()
{
    this.people.Add(new Person { Name = "Nancy Davolio", Position = "Sales Representative", City = "Seattle", PostalCode = "98101", Company = "Northwind Traders" });
    this.people.Add(new Person { Name = "Andrew Fuller", Position = "Vice President, Sales", City = "Tacoma", PostalCode = "98402", Company = "Northwind Traders" });
    this.people.Add(new Person { Name = "Janet Leverling", Position = "Sales Representative", City = "Kirkland", PostalCode = "98033", Company = "Northwind Traders" });
    this.people.Add(new Person { Name = "Margaret Peacock", Position = "Sales Representative", City = "Redmond", PostalCode = "98052", Company = "Northwind Traders" });
    this.people.Add(new Person { Name = "Steven Buchanan", Position = "Sales Manager", City = "London", PostalCode = "SW1A 1AA", Company = "Consolidated Holdings" });
    this.people.Add(new Person { Name = "Michael Suyama", Position = "Sales Representative", City = "London", PostalCode = "EC1A 1BB", Company = "Consolidated Holdings" });
    this.people.Add(new Person { Name = "Robert King", Position = "Sales Representative", City = "London", PostalCode = "W1A 1HQ", Company = "Consolidated Holdings" });
    this.people.Add(new Person { Name = "Laura Callahan", Position = "Inside Sales Coordinator", City = "Portland", PostalCode = "97205", Company = "Contoso Ltd." });
    this.people.Add(new Person { Name = "Anne Dodsworth", Position = "Sales Representative", City = "Portland", PostalCode = "97209", Company = "Contoso Ltd." });
    this.people.Add(new Person { Name = "Tim Cook", Position = "Account Manager", City = "San Francisco", PostalCode = "94103", Company = "Fabrikam" });
}

5. Define the prompt handling properties:

c#

private static readonly HttpClient HttpClient = new HttpClient();
private CancellationTokenSource cancellationTokenSource;
private ObservableCollection<string> suggestedPrompts;
private ObservableCollection<string> recentPrompts;
private readonly ObservableCollection<Person> people = new();

6. Handle the PromptRequest event in the code-behind:

c#

private async void OnPromptRequest(object sender, Telerik.Maui.Controls.DataGrid.DataGridPromptRequestEventArgs e)
{
    if (this.cancellationTokenSource != null)
    {
        // An AI request is already being processed
        return;
    }

    this.cancellationTokenSource = new CancellationTokenSource();

    try
    {
        var request = JsonSerializer.Deserialize<object>(e.RequestJson);
        var requestResult = await HttpClient.PostAsJsonAsync("https://demos.telerik.com/service/v2/ai/grid/smart-state", request, this.cancellationTokenSource.Token);
        var response = await requestResult.Content.ReadAsStringAsync(this.cancellationTokenSource.Token);

        e.ResponseJson = response;
    }
    catch (OperationCanceledException)
    {
    }
    catch (Exception ex)
    {
        await this.ShowErrorAsync($"Failed to process request: {ex.Message}");
        e.HasError = true;
    }
    finally
    {
        this.cancellationTokenSource?.Dispose();
        this.cancellationTokenSource = null;
    }
}

7. Handle the CancelPromptRequest event in the code-behind:

c#

private void OnCancelPromptRequest(object sender, System.EventArgs e)
{
    this.cancellationTokenSource?.Cancel();
}

8. Add items to the suggested prompts collection:

c#

this.suggestedPrompts = new ObservableCollection<string>
{
    "Group the employees by Company",
    "Filter employees that work for Northwind Traders",
    "Sort the employees by City in descending order",
    "Lock the Position column",
    "Clear all sorting, filtering and grouping",
};

9. Add items to the recent prompts collection:

c#

this.recentPrompts = new ObservableCollection<string>
{
    "Clear all sorting, filtering and grouping",
    "Group the employees by Company",
};

10. Assign the collections to the AISettings:

c#

this.AISettings.SuggestedPrompts = this.suggestedPrompts;
this.AISettings.RecentPrompts = this.recentPrompts;

11. Set the data to the DataGrid ItemsSource:

c#

this.LoadSampleData();
this.dataGrid.ItemsSource = this.people;

The DataGrid AI Smart Assistant examples in the SDKBrowser Demo Application use a Telerik-hosted AI service for demonstration purposes only. You have to configure your own AI service for the AI Smart Assistant to work in your application. How to do that is described in the Getting Started with the AI Smart Assistant article.

For a runnable example demonstrating the configuration options, see the SDKBrowser Demo Application and go to the DataGrid > AI Smart Assistant category.

See Also

• Prompt Controlled Overview
• Style the AI Smart Assistant Templates
• Templates for AI Smart Assistant