syncfusion-maui-smart-scheduler

.NET MAUI AI 驱动的日程安排器（SfSmartScheduler）

一项全面的技能，用于实现 Syncfusion 的 AI 驱动日程安排器。它将传统日程安排与 AI 驱动的意图理解相结合，让用户能够使用自然语言创建、更新、删除和查看约会，并通过 AI 提示词导航日历和切换视图。

何时使用此技能

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

• 在 MAUI 应用中实现自然语言约会安排
• 让用户使用日常语言创建、更新或删除约会
• 让用户通过 AI 提示词导航日历和切换视图（例如“转到下周一”“切换到周视图”）
• 构建可感知资源的预订系统（会议室、设备、人员）
• 为日程安排应用添加 AI 驱动的冲突检测
• 实现智能约会摘要功能
• 创建对话式日程安排界面
• 自定义辅助视图的外观和行为
• 处理 AI 驱动的日程安排事件和响应
• 设置 AI 助手组件的样式

以下情况优先选择 SfSmartScheduler，而不是传统日程安排器：

• 用户更喜欢对话式界面，而非表单
• 应用需要理解上下文（当前视图、资源、可用情况）
• 冲突检测和解决至关重要
• 需要进行资源管理和可用性检查
• 快速生成约会摘要很有价值
• 用户应能够使用自然语言导航日历和切换视图

组件概览

SfSmartScheduler 将 Syncfusion Scheduler 与 AI 驱动的自然语言处理相结合。用户可以通过对话式提示词与日历交互，例如：

• “安排明天下午 2 点的团队会议”
• “预订周五下午的 A 会议室”
• “查找本周项目评审的空闲时段”
• “总结我明天的会议”
• “切换到周视图”（AI 驱动的视图切换）
• “转到下周一”（AI 驱动的日期导航）

此组件会遵循当前视图上下文和资源可用情况，检测冲突，支持 AI 驱动的日期导航和视图切换，并提供智能建议，让日程安排变成对话，而不是填写表单。

主要功能

• 自然语言 CRUD： 使用日常语言创建、更新和删除约会，无需填写结构化表单
• AI 驱动的控件处理： 通过 AI 提示词导航日历（DisplayDate）和切换视图（“转到下周一”“切换到周视图”“显示月视图”）
• 可感知资源的预订： 在遵循可用情况和当前日程安排器筛选条件的同时预订资源
• 冲突检测： 识别时间重叠的约会并提出解决方案
• 智能摘要： 为即将举行或选定的约会生成简洁摘要
• 自适应辅助面板： 为手机、平板电脑和桌面配置高度、宽度和布局
• 可自定义的辅助按钮： 启用、禁用或替换为自定义模板
• 事件支持： 可选择由 AI 自动驱动更改，或通过事件手动处理

文档和导航指南

开始使用

📄 阅读： references/getting-started.md

何时阅读： 首次设置、项目初始化、AI 服务配置

涵盖内容：

• 创建新的 MAUI 项目（Visual Studio、VS Code、Rider）
• 安装 Syncfusion.Maui.SmartComponents NuGet 包
• 注册处理程序（ConfigureSyncfusionCore()）
• 配置 AI 服务（Azure OpenAI、OpenAI、Ollama）
• 初始化 SfSmartScheduler（XAML 和 C#）
• 使用自然语言创建首个约会

自然语言操作

📄 阅读： references/natural-language-operations.md

适合阅读的场景： 实现对话式预约管理，了解支持的语言模式

涵盖内容：

• 自然语言 CRUD 操作（创建、更新、删除）
• 使用日常语言创建预约
• 理解时间、日期、主题和重复规则
• 使用自然语言引用资源
• 多操作命令
• 支持的短语和模式
• 上下文感知排期
• AI 驱动的日期导航（“转到下周一”“跳转到 12 月 1 日”）
• AI 驱动的视图切换（“切换到周视图”“显示月视图”）
• 示例：“安排明天下午 2 点的团队会议”“将营销评审移到周五”

资源感知功能

📄 阅读： references/resource-aware-features.md

适合阅读的场景： 实现资源预订、冲突检测、可用性检查和预约摘要

涵盖内容：

• 资源感知预订（会议室、设备、人员）
• 可用性检查和验证
• 检测时间重叠的预约冲突
• 资源不可用时提供替代资源建议
• 推荐相邻时间段
• 资源筛选和当前视图上下文
• 冲突解决方案（重新排期、重新分配、延长缓冲时间）
• 智能生成预约摘要
• 空闲时间查找功能

助手视图自定义

📄 阅读： references/assist-view-customization.md

适合阅读的场景： 自定义助手面板外观、布局、按钮模板和提示词

涵盖内容：

• 使用 EnableAssistButton 启用或禁用助手按钮
• 使用 AssistButtonTemplate 自定义助手按钮模板
• 自定义助手视图高度（AssistViewHeight）
• 自定义助手视图宽度（AssistViewWidth）
• 自定义标题文本（AssistViewHeaderText）
• 配置占位文本（Placeholder）
• 自定义 AI 提示词（Prompt）
• 配置建议提示词（SuggestedPrompts）
• 横幅可见性（ShowAssistViewBanner）
• 针对手机、平板电脑和桌面设备的自适应布局

事件和方法

📄 阅读： references/events-and-methods.md

适合阅读的场景： 实现自定义事件处理，以编程方式控制助手视图

涵盖内容：

• AssistAppointmentResponseCompleted 事件
• 事件参数：Appointment、Handled、AssistantResponse、Action
• 手动与自动预约处理
• ResetAssistView() 方法
• CloseAssistView() 方法
• OpenAssistView() 方法
• 以编程方式控制的示例
• 自定义验证逻辑
• 拦截 AI 生成的预约

样式

📄 阅读： references/styling.md

适合阅读的场景： 自定义助手视图外观、颜色、字体和品牌标识

涵盖内容：

• AssistStyle 属性概述
• 自定义占位文本颜色
• 助手视图标题样式（文本颜色、背景、字体）
• 自定义字体（大小、字体系列、属性）
• 配置字体自动缩放
• 完整的样式示例（XAML 和 C#）
• 主题集成
• 企业品牌标识注意事项