Important Announcement — Microsoft.Extensions.AI.Abstractions NuGet Package Version Upgrade in v24.2.6
On February 17, 2025, Microsoft released the 9.3.0-preview.1.25114.11 version of its Microsoft.Extensions.AI.Abstractions package. APIs associated with this package play an important role in the implementation of DevExpress AI-powered Extensions and the DevExpress Blazor AI Chat component. Microsoft's update introduced breaking changes to the IChatClient
interface. In this article, I will highlight these changes and outline our plans for transitioning to the most recent NuGet package.
IChatClient.CompleteAsync Methods
The following methods and classes in the IChatClient
interface were renamed:
Previous Version (9.0.0-preview.9.24556.5) | Updated Version (9.3.0-preview.1.25114.11) |
---|---|
CompleteAsync |
GetResponseAsync |
CompleteStreamingAsync |
GetStreamingResponseAsync |
ChatCompletion |
ChatResponse |
StreamingChatCompletionUpdate |
ChatResponseUpdate |
IChatClient.GetResponse Methods
Last week, the package was updated again to v9.3.0-preview.1.25161.3 (note the last two numbers). This update modified GetResponseAsync
and GetStreamingResponseAsync
method signatures: chatMessages
method argument type changed from IList
to IEnumerable
.
Note: Review the following merge requests in the Azure SDK for .NET Samples repository for additional information:
Version Upgrade in v24.2.6
DevExpress source code (up to v24.2.5) references 9.0.0-preview.9.24556.5. This may have affected AI-related functionality in your applications. The most common issue is the following runtime exception when using DevExpress AI-powered Extensions:
Could not load type Microsoft.Extensions.AI.ChatCompletion from assembly 'Microsoft.Extensions.AI.Abstractions, version=9.3.0.0'...
As you might expect, this occurs when using the latest versions of Microsoft.Extensions.AI
or related NuGet packages:
Azure.AI.OpenAI
OpenAI
Microsoft.Extensions.AI.OpenAI
To keep pace with rapid AI-related API updates and to help you use the newest APIs in your application, DevExpress will upgrade dependencies in our next minor build (v24.2.6):
Package Name | Current Version (v24.2.3–v24.2.5) | New Version (v24.2.6+) |
---|---|---|
Microsoft.Extensions.AI.Abstractions | 9.0.0-preview.9.24556.5 | 9.3.0-preview.1.25161.3 |
OpenAI | 2.0.0 | 2.2.0-beta.1 |
Azure.AI.OpenAI | 2.0.0 | 2.2.0-beta.1 |
Microsoft.Extensions.AI.OpenAI | 9.0.0-preview.9.24556.5 | 9.3.0-preview.1.25161.3 |
These changes will apply to v24.2.6. Once you upgrade to this version, please update your implementation if using IChatClient
interface methods described in this article.