Aspire.Hosting.Azure.CognitiveServices
8.0.0-preview.5.24201.12
Prefix Reserved
See the version list below for details.
dotnet add package Aspire.Hosting.Azure.CognitiveServices --version 8.0.0-preview.5.24201.12
NuGet\Install-Package Aspire.Hosting.Azure.CognitiveServices -Version 8.0.0-preview.5.24201.12
<PackageReference Include="Aspire.Hosting.Azure.CognitiveServices" Version="8.0.0-preview.5.24201.12" />
paket add Aspire.Hosting.Azure.CognitiveServices --version 8.0.0-preview.5.24201.12
#r "nuget: Aspire.Hosting.Azure.CognitiveServices, 8.0.0-preview.5.24201.12"
// Install Aspire.Hosting.Azure.CognitiveServices as a Cake Addin #addin nuget:?package=Aspire.Hosting.Azure.CognitiveServices&version=8.0.0-preview.5.24201.12&prerelease // Install Aspire.Hosting.Azure.CognitiveServices as a Cake Tool #tool nuget:?package=Aspire.Hosting.Azure.CognitiveServices&version=8.0.0-preview.5.24201.12&prerelease
Aspire.Hosting.Azure.CognitiveServices library
Provides extension methods and resource definitions for a .NET Aspire AppHost to configure Azure OpenAI.
Getting started
Prerequisites
- Azure subscription - create one for free
- Azure OpenAI or OpenAI account - create an Azure OpenAI Service resource
Install the package
In your AppHost project, install the .NET Aspire Azure Hosting Cognitive Services library with NuGet:
dotnet add package Aspire.Hosting.Azure.CognitiveServices
Usage example
Then, in the Program.cs file of AppHost
, add an Azure AI OpenAI service and consume the connection using the following methods:
var openai = builder.AddAzureOpenAI("openai");
var myService = builder.AddProject<Projects.MyService>()
.WithReference(openai);
The AddAzureOpenAI
method will read connection information from the AppHost's configuration (for example, from "user secrets") under the ConnectionStrings:openai
config key. The WithReference
method passes that connection information into a connection string named openai
in the MyService
project. In the Program.cs file of MyService
, the connection can be consumed using the client library Aspire.Azure.AI.OpenAI:
builder.AddAzureOpenAIClient("openai");
Additional documentation
- https://learn.microsoft.com/dotnet/api/overview/azure/ai.openai-readme
- https://github.com/dotnet/aspire/tree/main/src/Components/README.md
Feedback & contributing
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Aspire.Hosting.Azure (>= 8.0.0-preview.5.24201.12)
- Azure.Provisioning (>= 0.1.0-beta.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on Aspire.Hosting.Azure.CognitiveServices:
Repository | Stars |
---|---|
dotnet/eShop
A reference .NET application implementing an eCommerce site
|
|
Azure-Samples/eShopOnAzure
A variant of https://github.com/dotnet/eShop that uses Azure services
|
Version | Downloads | Last updated |
---|---|---|
9.0.0-rc.1.24511.1 | 1,815 | 10/15/2024 |
8.2.2 | 491 | 10/24/2024 |
8.2.1 | 3,697 | 9/26/2024 |
8.2.0 | 10,838 | 8/29/2024 |
8.1.0 | 8,148 | 7/23/2024 |
8.0.2 | 5,062 | 6/28/2024 |
8.0.1 | 6,092 | 5/21/2024 |
8.0.0 | 4,646 | 5/21/2024 |
8.0.0-preview.7.24251.11 | 5,000 | 5/7/2024 |
8.0.0-preview.6.24214.1 | 3,024 | 4/23/2024 |
8.0.0-preview.5.24201.12 | 2,909 | 4/9/2024 |