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:
- Azure KI-Suche: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB for MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure Data Explorer: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
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.