Freigeben über


Azure OpenAI-Erweiterung für Azure Functions

Wichtig

Die Azure OpenAI-Erweiterung für Azure Functions befindet sich derzeit in der Vorschau.

Die Azure OpenAI-Erweiterung für Azure Functions implementiert eine Reihe von Triggern und Bindungen, mit denen Sie Features und Verhaltensweisen von Azure OpenAI Service problemlos in Ihre Funktionscodeausführungen integrieren können.

Azure Functions ist ein ereignisgesteuerter Computedienst, der mehrere Trigger und Bindungen bereitstellt, um das Herstellen von Verbindungen mit anderen Azure-Diensten zu vereinfachen.

Mit der Integration zwischen Azure OpenAI und Functions können Sie Funktionen mit folgenden Fähigkeiten erstellen:

Aktion Trigger/Bindungstyp
Verwenden eines Standardtextprompts für die Vervollständigung von Inhalt Azure OpenAI-Eingabebindung für Textvervollständigung
Antworten auf eine Assistentenanforderung zum Aufrufen einer Funktion Azure OpenAI-Assistententrigger
Erstellen eines Assistenten Azure OpenAI-Ausgabebindung zum Erstellen eines Assistenten
Senden einer Nachricht an einen Assistenten Azure OpenAI-Eingabebindung zum Senden einer Nachricht an den Assistenten
Abrufen des Assistentenverlaufs Azure OpenAI-Eingabebindung zum Abfragen des Assistenten
Lesen von Texteinbettungen Azure OpenAI-Eingabebindung für Einbettungen
Schreiben in eine Vektordatenbank Azure OpenAI-Ausgabebindung zum Speichern von Einbettungen
Lesen aus einer Vektordatenbank Azure OpenAI-Eingabebindung für die semantische Suche

Installieren der Erweiterung

Das NuGet-Erweiterungspaket, das Sie installieren, hängt vom C#-Modus (In-Process oder isolierter Workerprozess) ab, den Sie in Ihrer Funktions-App verwenden:

Fügen Sie Ihrem Projekt die Azure OpenAI-Erweiterung hinzu, indem Sie das NuGet-Paket Microsoft.Azure.Functions.Worker.Extensions.OpenAI installieren. Dazu können Sie die .NET-CLI verwenden:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI  --prerelease

Wenn Sie eine Vektordatenbank zum Speichern von Inhalten verwenden, sollten Sie auch mindestens eines der folgenden NuGet-Pakete installieren:

Installieren des Pakets

Sie können die Vorschauerweiterung hinzufügen, indem Sie den folgenden Code in Ihrer host.json Datei hinzufügen oder ersetzen, der speziell auf eine Vorschauversion des 4.x-Bundles ausgerichtet ist, das die OpenAI-Erweiterung enthält:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Anwendungseinstellungen

Um die Azure OpenAI-Bindungserweiterung zu verwenden, müssen Sie eine oder mehrere dieser Einstellungen hinzufügen, die zum Herstellen einer Verbindung mit Ihrer OpenAI-Ressource verwendet werden. Während der lokalen Entwicklung müssen Sie diese Einstellungen auch zu Ihrer local.settings.json Datei hinzufügen.

Einstellungsname Beschreibung
AZURE_OPENAI_ENDPOINT Erforderlich. Legt den Endpunkt der OpenAI-Ressource fest, die von Ihren Bindungen verwendet wird.
AZURE_OPENAI_KEY Legt den Schlüssel fest, der für den Zugriff auf eine Azure OpenAI-Ressource verwendet wird.
OPENAI_API_KEY Legt den Schlüssel fest, der für den Zugriff auf eine Nicht-Azure OpenAI-Ressource verwendet wird.
AZURE_CLIENT_ID Legt eine vom Benutzer zugewiesene verwaltete Identität fest, die für den Zugriff auf die Azure OpenAI-Ressource verwendet wird.

Weitere Informationen finden Sie unter Verwenden von Anwendungseinstellungen.