Azure OpenAI-extensie voor Azure Functions
Belangrijk
De Azure OpenAI-extensie voor Azure Functions is momenteel in preview.
De Azure OpenAI-extensie voor Azure Functions implementeert een set triggers en bindingen waarmee u eenvoudig functies en gedrag van Azure OpenAI Service kunt integreren in de uitvoeringen van uw functiecode.
Azure Functions is een gebeurtenisgestuurde rekenservice die een set triggers en bindingen biedt om eenvoudig verbinding te maken met andere Azure-services.
Met de integratie tussen Azure OpenAI en Functions kunt u functies bouwen die het volgende kunnen doen:
Actie | Type trigger/binding |
---|---|
Een standaardtekstprompt gebruiken voor voltooiing van inhoud | Invoerbinding voor voltooiing van Azure OpenAI-tekst |
Reageren op een assistentaanvraag om een functie aan te roepen | Azure OpenAI-assistenttrigger |
Een assistent maken | Azure OpenAI-assistent: uitvoerbinding maken |
Een assistent een bericht sturen | Azure OpenAI-assistent na invoerbinding |
Assistentgeschiedenis ophalen | Queryinvoerbinding voor Azure OpenAI-assistent |
Tekst insluitingen lezen | Invoerbinding voor Azure OpenAI-insluitingen |
Schrijven naar een vectordatabase | Uitvoerbinding voor Azure OpenAI-insluitingen opslaan |
Lezen uit een vectordatabase | Azure OpenAI semantische zoekinvoerbinding |
De extensie installeren
Het NuGet-extensiepakket dat u installeert, is afhankelijk van de C#-modus in-proces of geïsoleerd werkproces dat u gebruikt in uw functie-app:
Voeg de Azure OpenAI-extensie toe aan uw project door het NuGet-pakket Microsoft.Azure.Functions.Worker.Extensions.OpenAI te installeren. Dit kunt u doen met behulp van de .NET CLI:
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease
Wanneer u een vectordatabase gebruikt voor het opslaan van inhoud, moet u ook ten minste een van deze NuGet-pakketten installeren:
- Azure AI Search: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB voor MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure Data Explorer: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
Bundel installeren
U kunt de preview-extensie toevoegen door de volgende code toe te voegen aan of te vervangen in uw host.json
bestand, die specifiek is gericht op een preview-versie van de 4.x-bundel die de OpenAI-extensie bevat:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Toepassingsinstellingen
Als u de Azure OpenAI-bindingsextensie wilt gebruiken, moet u een of meer van deze instellingen toevoegen, die worden gebruikt om verbinding te maken met uw OpenAI-resource. Tijdens de lokale ontwikkeling moet u deze instellingen ook toevoegen aan uw local.settings.json
bestand.
Naam instelling | Beschrijving |
---|---|
AZURE_OPENAI_ENDPOINT |
Vereist. Hiermee stelt u het eindpunt van de OpenAI-resource in die wordt gebruikt door uw bindingen. |
AZURE_OPENAI_KEY |
Hiermee stelt u de sleutel in die wordt gebruikt voor toegang tot een Azure OpenAI-resource. |
OPENAI_API_KEY |
Hiermee stelt u de sleutel in die wordt gebruikt voor toegang tot een niet-Azure OpenAI-resource. |
AZURE_CLIENT_ID |
Hiermee stelt u een door de gebruiker toegewezen beheerde identiteit in die wordt gebruikt voor toegang tot de Azure OpenAI-resource. |
Zie Werken met toepassingsinstellingen voor meer informatie.