syncfusion-aspnetcore-smart-paste

Syncfusion ASP.NET Core Smart Paste Button

概述

Smart Paste Button 是一种智能 AI 驱动的 UI 控件，可自动解析剪贴板数据，并通过上下文理解和语义分析将数据智能映射到表单字段。本技能将指导你在 ASP.NET Core 应用中使用 Syncfusion 组件实现 Smart Paste 功能，并支持多种 AI 提供商和自定义后端。

Smart Paste Button 提供：

• 智能数据映射： 通过上下文理解将剪贴板数据与表单字段匹配
• 多种 AI 提供商： OpenAI、Azure OpenAI、Ollama 和自定义 IChatInferenceService 后端
• 表单字段注释： 使用明确的描述提升 AI 准确度，并帮助理解字段意图
• 外观自定义： 完整继承 Button 组件属性，可用于样式和主题设置
• 剪贴板集成： 自动解析剪贴板内容并智能分配值
• 自定义推理后端： 可扩展的架构，适用于专有或本地部署的 AI 服务
• Tag Helper 支持： 原生集成 ASP.NET Core TagHelper，适用于 Razor 页面和 MVC

何时使用此技能

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

• 需要通过剪贴板数据实现 AI 驱动的表单自动填充
• 需要为 Smart Paste 功能配置 OpenAI 或 Azure OpenAI
• 需要设置 Ollama 或自定义 AI 推理服务
• 需要添加智能字段注释以提升 AI 准确度
• 需要自定义 Smart Paste Button 的外观和行为
• 需要将 Smart Paste 集成到多字段表单中
• 需要实现自定义数据推理后端
• 需要确保与 ASP.NET Core Razor Pages 或 MVC 应用正确集成

组件概述

主要功能：

• 实时解析剪贴板并通过 AI 进行解读
• 使用默认提供商，无需配置即可快速设置
• 支持结构化和非结构化剪贴板数据
• 提供字段注释系统，实现精准的数据映射
• 可扩展的推理架构
• 全面符合无障碍访问规范
• 支持自定义主题和样式

常用属性：

• Content - 按钮显示文本
• CssClass - 用于设置样式的 CSS 类
• IconCss - 用于显示按钮图标的类
• Disabled - 启用/禁用状态
• EnableRtl - 从右向左语言支持

文档导航

入门指南

📄 阅读： references/getting-started.md

• 先决条件和系统要求
• 安装 Syncfusion.EJ2.AspNet.Core NuGet 包
• 配置 AI 服务（OpenAI、Azure OpenAI、Ollama）
• 使用 Razor Pages 和 MVC 设置项目
• 注册 Tag Helper
• 配置 CDN 样式表和脚本
• 创建首个 Smart Paste 实现
• 基本表单设置和 Smart Paste 集成

字段注释

📄 阅读： references/annotation.md

• 使用 data-smartpaste-description 属性
• 提升准确度的注释最佳实践
• 支持的输入类型（text、textarea、select、radio、checkbox）
• 基于意图的字段描述
• 多语言注释策略
• 复杂表单的字段元数据

按钮自定义

📄 阅读： references/customization.md

• 自定义 Smart Paste Button 外观
• CSS 类和图标配置
• 继承 Button 组件属性
• 样式和主题选项
• 自定义按钮文本和标签
• 状态和事件处理

自定义推理后端

📄 阅读： custom-inference-backend

• 实现 IChatInferenceService 接口
• 集成自定义 AI 提供商
• 在依赖注入中注册服务
• 请求/响应格式规范
• 字段映射的预期 JSON 结构
• 处理复杂推理场景
• 测试和调试自定义后端