syncfusion-maui-ai-assistview

在 .NET MAUI 中实现 AI AssistView

Syncfusion .NET MAUI AI AssistView（SfAIAssistView）是一款功能全面的控件，可将 AI 服务集成到 .NET MAUI 应用程序中。它提供易于使用的对话界面，内置支持请求、响应、建议、对话历史记录、多个 Agent、Toast 通知以及丰富的自定义选项。

何时使用此技能

在以下情况下使用此技能：

• 在 .NET MAUI 应用程序中集成 AI 聊天界面
• 显示对话式 UI，包含用户请求和 AI 响应
• 实现 AI 驱动的助手，并提供建议提示词
• 创建基于聊天的交互，并保留对话历史记录
• 构建与 AI 服务交互的智能应用程序
• 自定义聊天外观，包括模板、主题和样式
• 通过事件、命令和数据绑定处理用户交互
• 使用页眉、工具栏和空状态管理对话流程
• 为多语言 AI 聊天应用程序实现本地化
• 使用多个 AI Agent，打造专门的助手体验
• 显示上下文 Toast 通知，提供非阻塞式反馈
• 使用 .NET MAUI 跨平台支持设计响应式 AI 界面

常见场景：

• 客户支持聊天机器人、AI 助手、帮助台界面
• 对话式 AI 应用程序、虚拟 Agent、交互式助手
• 基于聊天的内容生成、问答应用程序、知识库
• 个人效率助手、AI 笔记、写作助手
• 配备 AI 导师的教育平台、交互式学习界面
• 任何由 AI 驱动响应的实时对话式 UI

组件概览

SfAIAssistView 是一款功能全面、特性丰富的对话控件，可用于：

• 显示 AI 驱动的聊天界面，包含用户请求和 AI 响应
• 支持多种内容类型（文本、图像、超链接、卡片、附件）
• 使用可观察集合和 MVVM 模式提供灵活的数据绑定
• 通过模板和选择器自定义请求和响应的显示方式
• 支持多个 AI Agent，并可自定义所选 Agent
• 支持成功、警告和错误反馈的 Toast 通知
• 提供智能建议系统（页眉、特定响应、页脚提示词）
• 提供工具栏和聊天模式管理，并支持临时会话
• 保留对话历史记录，包括时间戳和交互跟踪
• 处理丰富的用户交互（点击、长按、上下文菜单）
• 提供可自定义的消息输入编辑器，支持文件附件和操作
• 支持结构化提示词组合、免责声明消息和时间间隔分隔符
• 提供自动滚动、滚动到底部按钮、语音输入和音频播放
• 支持全面的样式设置、主题设置和特定平台的效果

---

文档和导航指南

入门

📄 阅读： references/getting-started.md

• NuGet 包安装和设置
• 在 MauiProgram.cs 中注册处理程序
• 导入 XAML 命名空间并初始化控件
• 使用可观察集合设置 ViewModel
• 实现第一个请求/响应周期
• 常见设置问题和故障排除

Agent

📄 阅读： references/agents.md

• 在单个聊天体验中使用多个 AI Agent
• Agent 集合、选择和编辑器 @ 查找
• 所选 Agent 的可见性和模板自定义

项目和数据绑定

📄 阅读： references/items-and-data-binding.md

• 项目属性（文本、个人资料、时间戳、错误消息）
• 项目类型（文本、超链接、图像、卡片、附件）
• 项目交互事件和命令
• 错误响应的显示和处理
• 自定义项目视图模板
• 自定义模型绑定和转换器
• 请求和响应的上下文菜单

建议

📄 阅读： references/suggestions.md

• 标题级别的建议提示词
• 针对回复的建议
• 编辑器上方的页脚建议
• 建议选择事件和命令
• 取消和提交行为

标题

📄 阅读： references/header.md

• 标题的显示与自定义
• 标题文本和模板配置
• 在标题中显示建议

工具栏

📄 阅读： references/toolbar.md

• 工具栏的显示与标题自定义
• 新建聊天按钮的实现
• 临时聊天模式支持
• 聊天模式切换事件

历史记录

📄 阅读： references/history.md

• 启用对话历史记录
• 对话条目结构（标题、时间戳、消息、置顶状态）
• 筛选、置顶、重命名和删除对话
• 历史记录交互处理和恢复行为

事件和命令

📄 阅读： references/events.md

• 条目点击和长按事件
• 请求事件和命令处理
• 页脚操作命令（复制、重试、评分）

编辑器和附件

📄 阅读： references/editor-and-attachments.md

• 自定义编辑器布局和模板
• 用于长提示词的可展开请求编辑器
• 编辑先前的请求
• 文件附件支持、限制和图片预览
• 附件按钮模式和操作按钮配置
• 发送按钮自定义

模板和内容类型

📄 阅读： references/templates-and-content.md

• 请求和响应条目模板
• 用于动态模板的模板选择器
• 完全自定义模板
• 自定义聊天渲染实现

滚动

📄 阅读： references/scrolling.md

• 自动滚动到最新消息
• 自动滚动到最新请求或响应
• 滚动到底部按钮功能
• 自定义按钮外观

提示词组合

📄 阅读： references/prompt-composition.md

• 基于系统、上下文和部分内容组合提示词
• 确定性的组合顺序和筛选
• 检查提示词组合事件

提示词库

📄 阅读： references/prompt-library.md

• 浏览、搜索并从预定义提示词目录中选择
• SfPromptLibrary.ItemsSource 和 PromptItem 模型
• 通过 PromptSelected 事件或 PromptSelectedCommand 处理选择

免责声明消息

📄 阅读： references/disclaimer-message.md

• 编辑器下方的免责声明文本
• 显示状态和页脚间距行为

时间分隔符

📄 阅读： references/time-break-separators.md

• 按日期对消息分组
• 智能显示“今天”“昨天”或星期几标签
• 自定义时间分隔模板和样式

语音支持

📄 阅读： references/voice-support.md

• 麦克风按钮语音输入
• 语音识别和向编辑器注入文本
• 响应音频播放控件
• 平台权限和回退行为

Toast 通知

📄 阅读： references/toast-notifications.md

• 提供非阻塞式成功、警告和错误反馈

高级主题

📄 阅读： references/advanced-topics.md

• 文本选择支持
• 停止响应功能
• 性能优化

自动补全建议

📄 阅读： references/autocomplete-suggestions.md

• 输入时显示自动补全建议
• 前缀和时序配置
• 建议数据绑定
• 选择处理和行为
• 自定义建议模板
• 状态监控和服务端集成

样式

📄 阅读： references/styling.md

• 主题键的应用
• 所有 UI 元素的样式键
• 自定义请求和响应的外观
• 特定平台的样式效果

自定义

📄 阅读： references/customization.md

• 空状态视图
• 本地化（RESX）
• 从右向左（RTL）支持
• 通过 AllowImagePreview（默认值为 true）禁用图像预览
• 特定平台的效果（iOS 液态玻璃）

---