diff --git a/wpf-toc.html b/wpf-toc.html index 508e9d1493..e52207d64c 100644 --- a/wpf-toc.html +++ b/wpf-toc.html @@ -179,6 +179,7 @@
  • Getting Started
  • Open AI
  • Suggestion
    • +
  • History
  • Typing Indicator
  • Stop Responding
  • Response Toolbar
    • diff --git a/wpf/AI-AssistView/aiassistview_images/wpf_aiassistview_history.png b/wpf/AI-AssistView/aiassistview_images/wpf_aiassistview_history.png new file mode 100644 index 0000000000..460b73242b Binary files /dev/null and b/wpf/AI-AssistView/aiassistview_images/wpf_aiassistview_history.png differ diff --git a/wpf/AI-AssistView/history.md b/wpf/AI-AssistView/history.md new file mode 100644 index 0000000000..55d843d855 --- /dev/null +++ b/wpf/AI-AssistView/history.md @@ -0,0 +1,198 @@ +--- +layout: post +title: Conversation history in WPF AI AssistView | Syncfusion® +description: Learn how to display, navigate, and manage multiple conversations using conversation history in the Syncfusion® WPF AI AssistView control. +platform: wpf +control: SfAIAssistView +documentation: ug +--- + +# Conversation history in WPF AI AssistView + +The `SfAIAssistView` supports conversation history for creating new chats, preserving previous conversations, and switching between archived conversations through a built-in navigation view. + +## Conversation history + +The `Conversations` property stores the archived conversations displayed in the navigation view. Each conversation is represented by an `AssistConversationItem` that contains a title, start date and time, and a collection of messages. + +### Define the view model + +Create a view model with an `ObservableCollection` and populate each conversation with its associated messages. + +{% tabs %} +{% highlight c# tabtitle="AIAssistViewModel.cs" %} + +using System; +using System.Collections.ObjectModel; +using Syncfusion.UI.Xaml.Chat; + +namespace AIAssistViewHistoryWPF +{ + public class AIAssistViewModel + { + public ObservableCollection Chats { get; set; } + + public Author CurrentUser { get; set; } + + public ObservableCollection Conversations { get; set; } + + public AIAssistViewModel() + { + CurrentUser = new Author() { Name = "User" }; + Chats = new ObservableCollection(); + + Conversations = new ObservableCollection() + { + CreateConversation( + "Scotland", + "Tell me about Scotland.", + "Scotland is known for its historic castles, landscapes, and cultural heritage.", + DateTime.Now.AddHours(-2)), + + CreateConversation( + "Coding practices", + "What are some good coding practices?", + "Use code reviews, unit testing, clear naming, and consistent coding standards.", + DateTime.Now.AddHours(-1)), + + CreateConversation( + "Syncfusion", + "What does Syncfusion provide?", + "Syncfusion provides UI controls and components for .NET applications.", + DateTime.Now) + }; + } + + private AssistConversationItem CreateConversation( + string title, + string requestText, + string responseText, + DateTime dateTime) + { + return new AssistConversationItem() + { + Title = title, + DateTime = dateTime, + AssistItems = new ObservableCollection() + { + new TextMessage() + { + Text = requestText, + DateTime = dateTime, + Author = CurrentUser + }, + new TextMessage() + { + Text = responseText, + DateTime = dateTime.AddMinutes(1), + Author = new Author() { Name = "Syncfusion AI" } + } + } + }; + } + } +} + +{% endhighlight %} +{% endtabs %} + +### Bind conversations to SfAIAssistView + +Set the window's data context and bind the `Conversations` property to display the archived conversations in the navigation view. Set `ShowNavigationView` to `True` because the navigation view is hidden by default. + +{% tabs %} +{% highlight xaml tabtitle="MainWindow.xaml" hl_lines="18 19 20 21" %} + + + + + + + + + + + + +{% endhighlight %} +{% endtabs %} + +Selecting an archived conversation replaces the current messages with the messages stored in its `AssistItems` collection. The built-in **New Chat** option clears the current conversation and preserves a conversation that contains a request in the history. + +![Conversation history in WPF AI AssistView](aiassistview_images\wpf_aiassistview_history.png) + +## Show or hide the navigation view + +The `ShowNavigationView` property controls the visibility of the conversation history navigation view. Its default value is `false`. + +{% tabs %} +{% highlight xaml tabtitle="MainWindow.xaml" hl_lines="2" %} + + + +{% endhighlight %} +{% highlight c# tabtitle="MainWindow.xaml.cs" hl_lines="8" %} + +using System.Windows; + +namespace AIAssistViewHistoryWPF +{ + public partial class MainWindow : Window + { + public MainWindow() + { + InitializeComponent(); + aiAssistView.ShowNavigationView = true; + } + } +} + +{% endhighlight %} +{% endtabs %} + +The built-in hamburger button collapses or expands the navigation view when it is visible. + +## Customize the navigation header + +The `NavigationHeader` property sets the text displayed at the top of the navigation view. Its default value is `string.Empty`. + +{% tabs %} +{% highlight xaml tabtitle="MainWindow.xaml" hl_lines="2" %} + + + +{% endhighlight %} +{% highlight c# tabtitle="MainWindow.xaml.cs" hl_lines="8" %} + +using System.Windows; + +namespace AIAssistViewHistoryWPF +{ + public partial class MainWindow : Window + { + public MainWindow() + { + InitializeComponent(); + aiAssistView.NavigationHeader = "Chat History"; + } + } +} + +{% endhighlight %} +{% endtabs %}