The Syncfusion .NET MAUI AI AssistView (SfAIAssistView) is a comprehensive control for integrating AI services into .NET MAUI applications. It provides a user-friendly conversational interface with built-in support for requests, responses, suggestions, conversation history, multiple agents, toast notifications, and extensive customization options.
When to Use This Skill
Use this skill when you need to:
- Integrate AI chat interfaces in .NET MAUI applications
- Display conversational UI with user requests and AI responses
- Implement AI-powered assistants with suggestion prompts
- Create chat-based interactions with conversation history
- Build intelligent applications that interact with AI services
- Customize chat appearance with templates, themes, and styling
- Handle user interactions through events, commands, and data binding
- Manage conversation flows with headers, toolbars, and empty states
- Implement localization for multi-language AI chat applications
- Work with multiple AI agents for specialized assistant experiences
- Show contextual toast notifications for non-blocking feedback
- Design responsive AI interfaces with .NET MAUI cross-platform support
Common Scenarios:
- Customer support chatbots, AI assistants, help desk interfaces
- Conversational AI applications, virtual agents, interactive assistants
- Chat-based content generation, Q&A applications, knowledge bases
- Personal productivity assistants, note-taking with AI, writing helpers
- Educational platforms with AI tutors, interactive learning interfaces
- Any real-time conversational UI with AI-powered responses
Component Overview
SfAIAssistView is a comprehensive, feature-rich conversational control that:
- Displays AI-powered chat interfaces with user requests and AI responses
- Supports multiple content types (text, images, hyperlinks, cards, attachments)
- Provides flexible data binding with observable collections and MVVM patterns
- Enables customizable request/response display with templates and selectors
- Supports multiple AI agents with selected-agent customization
- Supports toast notifications for success, warning, and error feedback
- Includes smart suggestion system (header, response-specific, footer prompts)
- Offers toolbar and chat mode management with temporary sessions
- Maintains conversation history with timestamps and interaction tracking
- Handles rich user interactions (tapping, long-press, context menus)
- Provides customizable message input editor with file attachments and actions
- Supports structured prompt composition, disclaimer messages, and time break separators
- Features auto-scrolling, scroll-to-bottom button, voice input, and audio playback
- Supports comprehensive styling, theming, and platform-specific effects
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- NuGet package installation and setup
- Handler registration in MauiProgram.cs
- XAML namespace import and control initialization
- ViewModel setup with observable collections
- First request/response cycle implementation
- Common setup issues and troubleshooting
Agents
📄 Read: references/agents.md
- Multiple AI agents within a single chat experience
- Agent collection, selection, and editor
@lookup - Selected agent visibility and template customization
Items and Data Binding
📄 Read: references/items-and-data-binding.md
- Item properties (text, profile, timestamp, error messages)
- Item types (text, hyperlinks, images, cards, attachments)
- Item interaction events and commands
- Error response display and handling
- Custom item view templates
- Custom model binding and converters
- Context menus for requests and responses
Suggestions
📄 Read: references/suggestions.md
- Header-level suggestion prompts
- Response-specific suggestions
- Footer suggestions above the editor
- Suggestion selection events and commands
- Cancellation and submission behaviors
Header
📄 Read: references/header.md
- Header visibility and customization
- Header text and template configuration
- Displaying suggestions in headers
Toolbar
📄 Read: references/toolbar.md
- Toolbar visibility and title customization
- New Chat button implementation
- Temporary chat mode support
- Chat mode switching events
History
📄 Read: references/history.md
- Enabling conversation history
- Conversation item structure (title, timestamp, messages, pin state)
- Filtering, pinning, renaming, and deleting conversations
- History interaction handling and restore behavior
Events and Commands
📄 Read: references/events.md
- Item tapped and long-pressed events
- Request events and command handling
- Footer action commands (copy, retry, rating)
Editor and Attachments
📄 Read: references/editor-and-attachments.md
- Custom editor layouts and templates
- Expandable request editor for long prompts
- Editing previous requests
- File attachment support, limits, and image preview
- Attachment button modes and action buttons configuration
- Send button customization
Templates and Content Types
📄 Read: references/templates-and-content.md
- Request and response item templates
- Template selectors for dynamic templates
- Full control template customization
- Custom chat rendering implementation
Scrolling
📄 Read: references/scrolling.md
- Auto-scroll to latest messages
- Auto-scroll behavior for latest request or response
- Scroll-to-bottom button functionality
- Button appearance customization
Prompt Composition
📄 Read: references/prompt-composition.md
- System, context, and part-based prompt composition
- Deterministic composition order and filtering
- Prompt composing event inspection
Prompt Library
📄 Read: references/prompt-library.md
- Browse, search, and pick from a catalog of predefined prompts
SfPromptLibrary.ItemsSourceand thePromptItemmodel- Handle selection via the
PromptSelectedevent orPromptSelectedCommand
Disclaimer Message
📄 Read: references/disclaimer-message.md
- Disclaimer text below the editor
- Visibility and footer spacing behavior
Time Break Separators
📄 Read: references/time-break-separators.md
- Date-based message grouping
- Smart Today / Yesterday / weekday labels
- Custom time break template and styling
Voice Support
📄 Read: references/voice-support.md
- Microphone button voice input
- Speech recognition and editor text injection
- Response audio playback controls
- Platform permissions and fallback behavior
Toast Notifications
📄 Read: references/toast-notifications.md
- Non-blocking success, warning, and error feedback
Advanced Topics
📄 Read: references/advanced-topics.md
- Text selection support
- Stop responding functionality
- Performance optimization
AutoComplete Suggestions
📄 Read: references/autocomplete-suggestions.md
- AutoComplete suggestions while typing
- Prefix and timing configuration
- Suggestion data binding
- Selection handling and behaviors
- Custom suggestion templates
- State monitoring and server integration
Styling
📄 Read: references/styling.md
- Theme key application
- Style keys for all UI elements
- Customizing request/response appearance
- Platform-specific styling effects
Customization
📄 Read: references/customization.md
- Empty state views
- Localization (RESX)
- Right-to-left (RTL) support
- Disabling image previews via
AllowImagePreview(defaulttrue) - Platform-specific effects (iOS liquid glass)