Delen via


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:

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.