原创|使用教程|编辑:龚雪|2024-09-30 11:05:47.173|阅读 13 次
概述:本文主要介绍界面控件DevExpress v24.2如何完成具有AI功能文本编辑器的扩展,欢迎下载最新版组件体验!
# 慧都年终大促·界面/图表报表/文档/IDE等千款热门软控件火热促销中 >>
本文重点介绍了DevExpress在近年来最热门领域——人工智能(AI)和自然语言处理(NLP)的改进!
NLP是人工智能的一个分支,它允许计算机与人类语言进行交互,这包括以有意义/有用的方式理解、解释、生成和回应文本(和语音)的能力。基于NLP的功能允许更好的数据分析、个性化体验、高效的沟通,并导致更明智的决策和提高效率。例如:
P.S:DevExpress拥有.NET开发需要的所有平台控件,包含600多个UI控件、报表平台、DevExpress Dashboard eXpressApp 框架、适用于 Visual Studio的CodeRush等一系列辅助工具。
DevExpress技术交流群10:532598169 欢迎一起进群讨论
DevExpress AI APIs允许您在WinForms、WPF或Blazor应用程序中注册和使用多个AI服务,DevExpress的抢先体验预览版(v24.2.1)支持以下AI服务:
本文中描述的AI服务和DevExpress AI扩展遵循"bring your own key" 原则,DevExpress不提供REST API,也不提供任何内置的LLMs/SLMs。您需要有一个激活的Azure/Open AI订阅来获取REST API端点、密钥和模型部署名称,这些变量必须在应用程序启动时指定,来注册AI客户端并在应用程序中启用DevExpress AI-Powered扩展。
在开始之前,您需要满足以下先决条件:
或 .NET Framework v4.7.2
下表列出了DevExpress AI相关的NuGet包:
要在控制台应用程序中使用DevExpress AI-Powered扩展,您需要安装以下DevExpress包中的一个并注册AI客户端:
DevExpress AI-Powered扩展在AIExtensionsContainerDefault容器中运行,该容器管理已注册的AI客户端,以便DevExpress UI组件可以自动利用AI服务。
下面的代码片段注册了一个Azure OpenAI客户端:
using Azure.AI.OpenAI; using DevExpress.AIIntegration; ... //Modify the following lines to obtain and pass your personal Azure OpenAI credentails to the Register* method. string AzureOpenAIEndpoint { get { return Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT"); } } string AzureOpenAIKey { get { return Environment.GetEnvironmentVariable("AZURE_OPENAI_APIKEY"); } } string DeploymentName { get { return Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENTNAME"); } } AIExtensionsContainerDefault defaultAIContainer; ... static void Main() { defaultAIContainer = new AIExtensionsContainerDefault(); defaultAIContainer.RegisterChatClientOpenAIService( new AzureOpenAIClient(new Uri(AzureOpenAIEndpoint), new System.ClientModel.ApiKeyCredential(AzureOpenAIKey)), DeploymentName ); }
要使用离线的模型,请调用RegisterChatClientOllamaAIService方法。这个方法注册一个Ollama客户端,在这个方法中,第一个参数是默认的,第二个参数指定模型名称:
defaultAIContainer.RegisterChatClientOllamaAIService("//localhost:11434/api/chat", "llama3.1");
一旦您注册了一个AI客户端,可以使用DevExpress AI驱动的扩展如下(DevExpress AI驱动的扩展如下所示):
var result = await defaultAIContainer.TranslateAsync(new TranslateRequest(textToTranslate, language)); //OR var translateExtension = defaultAIContainer.CreateTranslateExtension(); TranslateRequest request = new TranslateRequest(textToTranslate, language); var result = await translateExtension.ExecuteAsync(request, CancellationToken.None);
处理大型文本块可能具有挑战性,但我们已经覆盖了。DevExpress AI-Powered扩展自动将大型内容拆分为可管理的块(包括段落、句子、单词、标点符号和其他文本元素),以确保准确处理,以下是如何管理大型文本块和处理AI服务响应的方法:
public async Task<string> GetTranslation(string textToTranslate, string language) { TextResponse result = await defaultAIContainer.TranslateAsync(new TranslateRequest(textToTranslate, language)); if(result.IsCompleted) return result.Response; if(!result.IsRestrictedOrFailed) { string translatedText = result.Response; while(result.IsContinuationRequired){ await result.ContinueAsync(); translatedText += result.Response } return translatedText; } //Something unexpected happened switch (result.Status) { case ResponseStatus.MaxTokenLimitExceeded: case ResponseStatus.InputSizeLimitExceeded: return "The text you're trying to send within a request is too long and exceeds the allowed limit."; case ResponseStatus.ContentFiltered: return "Potentially harmful content was detected in your request."; case ResponseStatus.Error: return "An error occurred while processing the request."; } throw new NotSupportedException(); }
重要的响应包括:
使用以下设置来配置文本内容和图像的大小限制:
public static partial class AIIntegration { //Specifies the maximum number of tokens that can be processed by a model request. Applies to all DevExpress AI-Powered extensions. public static int? ChatMaxTokensDefault { get; set; } = null; //Specifies the default temperature for chat-based AI-Powered extensions. //To learn more please visit //ai.stackexchange.com/questions/32477/what-is-the-temperature-in-the-gpt-models public static float? ChatTemperatureDefault { get; set; } = null; //Specifies the maximum allowed size of the text buffer per request, in bytes. public static int TextBufferMaxSize { get; set; } = 64 * 1024;//64kb //Specifies the maximum allowed size of the image buffer per request, in bytes. public static int ImageBufferMaxSize { get; set; } = 2 * 1024 * 1024;//2mb //Specifies the maximum allowed chunk length, in characters. public static int ChunkMaxLength { get; set; } = 6000; }
DevExpress EAP v24.2附带以下AI支持的扩展:
这些扩展以类似聊天的方式工作 - 其中请求通过内置提示发送到OpenAI/Ollama模型。
除了提供对托管在Azure和Ollama中的AI模型的访问外,我们还实现了与Azure AI语言服务交互的API,包括Azure AI Translator和Azure AI Language(文本摘要)。服务的选择取决于您的预算,但是请注意,在调用以下方法时,文本翻译和摘要请求将专门发送到Azure AI语言服务:
string azureTranslatorEndpoint = GetEnvironmentVariable("AZURE_TRANSLATOR_ENDPOINT"); string azureTranslatorKey = GetEnvironmentVariable("AZURE_TRANSLATOR_API_KEY"); //Register an Azure.TextAnalytics client. defaultAIContainer.RegisterTranslatorAzureAIService(new TextTranslationClient(new AzureKeyCredential(azureTranslatorKey), new Uri(azureTranslatorEndpoint))); //Register an Azure.TextAnalytics client. string azureTextAnalyticsEndpoint = GetEnvironmentVariable("AZURE_TEXT_ANALYTICS_ENDPOINT"); string azureTextAnalyticsKey = GetEnvironmentVariable("AZURE_TEXT_ANALYTICS_API_KEY"); defaultAIContainer.RegisterTextAnalyticsAzureAIService(new TextAnalyticsClient(new Uri(azureTextAnalyticsEndpoint), new AzureKeyCredential(azureTextAnalyticsKey)));
DevExpress AI驱动的扩展具有预先构建的提示,可以根据需要进行定制:
1. AI驱动的扩展中派生并覆盖GetSystemPrompt方法:
public class WilliamShakespeareStyleExtension : RewriteStyleExtension { public WilliamShakespeareStyleExtension(IServiceProvider serviceProvider) : base(serviceProvider) { } protected override string GetSystemPrompt(RewriteStyleRequest request) { return "Rewrite this text in the William Shakespeare style."; } }
2. 在默认容器中注册您的扩展(这将覆盖内置扩展):
defaultAIContainer.Register<RewriteStyleRequest, WilliamShakespeareStyleExtension>();
当您调用RewriteStyleAsync方法时,自定义提示将与用户输入一起发送到AI服务。
在这个阶段,DevExpress AI相关的API的另一个重要元素开始发挥作用:AIExtensionsContainerLocal类。与默认扩展容器类似,AIExtensionsContainerLocal类存储了您手动实现和注册的ai支持的扩展,而无需替换DevExpress内置扩展。
关键的区别在于这个容器中包含的扩展不会被DevExpress UI组件自动使用,这允许您为应用程序的不同部分实现不同的行为。下面的代码片段实现了一个自定义的AI驱动的扩展(注意如何使用基类):
public class AuthoredStyleExtension : ChangeTextExtension<AuthoredStyleRequest> { public AuthoredStyleExtension(IServiceProvider serviceProvider) : base(serviceProvider) { } protected override string GetSystemPrompt(AuthoredStyleRequest request) { return $"Rewrite this text in the {request.Author} style"; } } //A custom request that processes text. public class AuthoredStyleRequest : TextRequest { public AuthoredStyleRequest(string Author, string Text) : base(Text) { this.Author = Author; } public string Author { get; init; } } public static class CustomAIIntegration { public static AuthoredStyleExtension CreateAuthoredStyleExtension(this IAIExtensionsContainer container){ return (AuthoredStyleExtension)container.GetExtension(typeof(AuthoredStyleRequest));
您可以实现自己的TextRequest后代,以便在构造提示符时向AI模型提供额外的信息。示例包括内置的ChangeTone和RewriteStyle扩展,它们获得用于指定语气(例如,Casual, Friendly, Confident)和风格(例如,Formal, Conversational)的枚举值。要在运行时调用自定义扩展,请使用以下代码片段:
var localContainer = new AIExtensionsContainerLocal(defaultAIContainer); localContainer.Register<AuthoredStyleRequest, AuthoredStyleExtension>(); AuthoredStyleExtension extension = localContainer.CreateAuthoredStyleExtension(); var request = new AuthoredStyleRequest("Mark Twain", textToModify); //Here you can also set up the Temperature variable that will be used to execute this particular model request request.Options.Temperature = 0.9f; string result = await extension.ExecuteAsync(request, CancellationToken.None);
DevExpress AI-Powered扩展支持本地化,这有助于确保AI驱动的功能对于不同地区的用户都是可访问和相关的。通过本地化人工智能扩展,您可以调整用户界面和任何预定义的内容,以满足最终用户的语言和文化偏好,您也可以根据区域偏好定制提示(例如,当使用单语言AI模型时)。
更多产品需求,欢迎咨询“”~
更多DevExpress线上公开课、中文教程资讯请上中文网获取
本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处、不得修改原文相关链接,如果存在内容上的异议请邮件反馈至chenjj@pclwef.cn
文章转载自:慧都网