Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird die Integration eines openAI-Bots für Unterhaltungen in einen Azure Communication Services-Chat veranschaulicht. Der OpenAI-Chat-Bot verwendet Microsoft Bot Framework , das in den semantischen Kernel integriert ist. Der OpenAI-Bot ruft Antworten aus einer internen Wissensbasis ab und fasst sie zusammen, um Benutzerfragen in natürlicher Sprache zu beantworten.
Schritt 1: Bereitstellen eines Basismodells mit Azure AI Foundry
Folgen Sie im Azure AI Foundry-Portal dem Artikel Projekt erstellen, um ein neues Projekt zu erstellen. Wenn Sie dazu aufgefordert werden, erstellen Sie einen neuen Hub, und akzeptieren Sie alle Standardeinstellungen.
Öffnen Sie Ihr Projekt, wechseln Sie zu den enthaltenen Funktionen, wählen Sie Azure OpenAI-Dienst aus, und speichern Sie sowohl den API-Schlüssel als auch die Dienstendpunkt-URL.
Navigieren Sie im linken Menü zu "Meine Objekte" → Modelle + Endpunkte. Klicken Sie dann auf +Modell bereitstellen , und wählen Sie "Basismodell bereitstellen" aus.
Wählen Sie "gpt-4o " aus, und klicken Sie auf "Bestätigen".
Geben Sie einen Bereitstellungsnamen Ihrer Wahl ein, und klicken Sie dann auf "Verbinden" und "Bereitstellen".
Kehren Sie nach Abschluss der Bereitstellung zu Models + Endpunkten zurück, um zu überprüfen, ob Ihr Modell ausgeführt wird. In diesem Beispiel ist das bereitgestellte Modell gpt-4o.
Schritt 2: Erstellen einer Web App-Ressource
Klicken Sie im Azure-Portal auf Ressource erstellen. Geben Sie in das Suchfeld web app ein. Wählen Sie die Kachel Web-App aus.
Wählen Sie unter Web-App erstellen Details für die App aus, oder geben Sie sie ein, einschließlich der Region, in der Sie die App bereitstellen möchten.
Wählen Sie Überprüfen und erstellen aus, um die Bereitstellung und die Bereitstellungsdetails zu überprüfen. Wählen Sie dann Erstellen aus.
Wenn die Web-App-Ressource erstellt wird, kopieren Sie die hostname-URL, die in den Ressourcendetails angezeigt wird. Die URL ist Teil des Endpunkts, den Sie für die Web-App erstellen.
Schritt 3: Erstellen einer Azure Bot Service-Ressource
Klicken Sie im Azure-Portal auf Ressource erstellen. Geben Sie im Suchfeld bot ein. Wählen Sie die Azure Bot-Kachel aus.
Wählen Sie unter "Erstellen eines Azure Bots" "Multi Tenant" als App-Typ und "Neue Microsoft App-ID erstellen" als Erstellungstyp aus.
Wählen Sie Überprüfen und erstellen aus, um die Bereitstellung und die Bereitstellungsdetails zu überprüfen. Wählen Sie dann Erstellen aus.
Rufen Sie die Bot-App-ID ab, und erstellen Sie das Kennwort. Notieren Sie diese Werte, die für spätere Konfigurationen verwendet werden sollen.
Schritt 4: Erstellen eines Messaging-Endpunkts für den Bot
Azure Bot Service erwartet normalerweise, dass der Bot Application Web App Controller einen Endpunkt in der Form /api/messages
verfügbar macht. Der Endpunkt verarbeitet alle Nachrichten, die an den Bot gesendet werden.
Erstellen Sie als Nächstes in der Botressource einen Web-App-Messagingendpunkt:
Wechseln Sie im Azure-Portal zu Ihrer Azure Bot-Ressource. Wählen Sie im Ressourcenmenü die Option "Konfiguration" aus.
Fügen Sie in "Configuration" für den Messaging-Endpunkt die Hostnamen-URL der Web-App ein, die Sie im vorherigen Abschnitt kopiert haben. Fügen Sie der URL
/api/messages
an.Wählen Sie Anwenden.
Schritt 5: Erstellen einer Azure Communication Service-Ressource
Wählen Sie im Azure-Portal die Option "Ressource erstellen" aus. Geben Sie im Suchfeld Kommunikationsdienste ein. Wählen Sie die Kachel "Kommunikationsdienste " aus.
In Erstellen Sie einen Azure-Kommunikationsdienst können Sie das Abonnement, die Ressourcengruppe, den Namen der Kommunikationsdienstressource und die mit der Ressource verbundene geografische Lage angeben.
Wählen Sie Überprüfen und erstellen aus, um die Bereitstellung und die Bereitstellungsdetails zu überprüfen. Wählen Sie dann Erstellen aus.
Navigieren Sie zur Ressource. Wählen Sie
Einstellungen - Identitäten & Benutzerzugriffstoken Chat , und klicken Sie dann aufGenerieren . Speichern Sie das Identitäts- und Benutzerzugriffstoken für die zukünftige Verwendung.
Schritt 6: Aktivieren des Kommunikationsdienste-Chatkanals
Wenn Sie über eine Communication Services-Ressource verfügen, können Sie einen Communication Services-Kanal in der Botressource einrichten. Dieser Prozess generiert eine Bot Azure Communication Services-Benutzer-ID für den Bot.
Wechseln Sie im Azure-Portal zu Ihrer Azure Bot-Ressource. Wählen Sie im Ressourcenmenü die Option Kanäle aus. Wählen Sie in der Liste der verfügbaren Kanäle "Kommunikationsdienste – Chat" aus.
Wählen Sie Verbinden aus, um eine Liste der Communication Services-Ressourcen anzuzeigen, die in Ihrem Abonnement verfügbar sind.
Wählen Sie im Bereich Neue Verbindung die Communication Services-Chatressource und dann Anwenden aus.
Wenn die Ressourcendetails überprüft werden, wird eine Bot Azure Communication Services-Benutzer-ID in der Spalte "Bot Azure Communication Services ID " angezeigt. Speichern Sie die ID für die spätere Verwendung.
Schritt 7: Bereitstellen der Web-App
Öffnen Sie den
ChatBot
Ordner im Beispiel-Repository in Visual Studio Code (VS Code). Stellen Sie sicher, dass Sie VS Code verwenden, da sie die Microsoft Entra-ID in der Codebereitstellung unterstützt.Ersetzen Sie die Platzhalter im Beispiel-Repository durch tatsächliche Werte:
- Füllen Sie in der
SemanticKernelService.cs
Datei die Werte für VariablenmodelId
,endpoint
undapiKey
. - Füllen Sie in der
appsettings.json
Datei die Werte der VariablenMicrosoftAppId
undMicrosoftAppPassword
aus, indem Sie diebot app id
und diebot password
, die Sie in Schritt 3 dokumentiert haben, verwenden.
- Füllen Sie in der
Installieren Sie die Azure App Service-Erweiterung in VS Code.
Melden Sie sich bei Ihrem Azure-Konto in VS Code an. Um auf den Anmeldebereich zuzugreifen, klicken Sie auf das Azure-Symbol auf der Aktivitätsleiste auf der Seite des Fensters.
Installieren Sie die Azure App Service-Erweiterung in VS Code.
Erstellen Sie das Projekt, indem Sie den folgenden Befehl im Stammverzeichnis des Projekts "ChatBot" ausführen.
dotnet publish -c Release -o ./bin/Publish
Mit diesem Befehl werden die Ordner bin
und obj
generiert.
Um die Web App bereitzustellen, klicken Sie mit der rechten Maustaste auf den neuen
/bin/Publish
Ordner, und wählen Sie "In Web App bereitstellen" aus.Wählen Sie die Azure App Service-Web-App aus, für die Sie die Anwendung bereitstellen möchten. Bestätigen Sie die Bereitstellung.
Schritt 8: Ausführen der Demo
Führen Sie die Schritte vor "Abrufen eines Chatthreadclients" in "Chat zu Ihrer App hinzufügen " aus, um eine Chat-App zu erstellen und einen Thread zu starten.
Wichtige Hinweise:
- Sie haben bereits die Azure Communication Service-Ressource im Portal erstellt, sodass Sie das
<Azure Communication Services endpoint>
,<Access_ID>
und<Access_Token>
in Ihrem Code direkt verwenden können. - Beim Erstellen eines Threads müssen Sie ein weiteres
ChatParticipant
-Objekt mithilfe derBot Azure Communication Services User ID
erstellen, die in Schritt 6: Aktivieren des Communication Services-Chatkanals erstellt wurde, um<Access_ID>
als den Botbenutzer darzustellen. - Speichern Sie
Thread Id
für die spätere Verwendung.
- Sie haben bereits die Azure Communication Service-Ressource im Portal erstellt, sodass Sie das
Öffnen Sie die Zusammengesetzte UI-Bibliothek: Azure Communication Services Chat Thread UI – Vorhandenem Chatthread beitreten.
Geben Sie die erforderlichen Informationen an, um einem vorhandenen Chatthread beizutreten.
- Anzeigename: Sie können den gewünschten Namen auswählen.
- Benutzer-ID für den Benutzer: die in Schritt
<Access_ID>
gespeicherte . - Gültiges Token für den Benutzer: das
<Access_Token>
in Schritt 8.1 gespeicherte Token. - Azure Communication Services-Endpunkt: der in Schritt
<Azure Communication Services endpoint>
gespeicherte . - Vorhandener Thread: der
Thread Id
in Schritt 8.1 gespeicherte Thread.
Stellen Sie die folgenden Fragen in Folge:
- Fragen 1: Meine Benutzer-ID ist 110. Ich habe vor einigen Tagen einen Laptop gekauft. Könnten Sie helfen, die Lieferung nachzuverfolgen?
- Frage 2: Ich habe eine Rückgabe für meine Power Bank angefordert. Irgendwelche Updates?
- Frage 3: Ich habe Bluetooth Earphones vor 2 Tagen gekauft, aber sie wurden noch nicht ausgeliefert. Warum?
OpenAI ruft die Daten ab, die für die Semantik der Frage relevant sind, und stellt eine Antwort basierend auf verfügbaren Daten bereit.
Handelsmarken
Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienstleistungen enthalten. Die autorisierte Verwendung von Microsoft-Marken oder Logos unterliegt den Microsoft Markenrichtlinien
Die Verwendung von Microsoft-Marken oder Logos in geänderten Versionen dieses Projekts darf keine Verwirrung oder den Eindruck einer Microsoft-Förderung verursachen.
Jede Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieses Dritten.
Verwandte Artikel
- Fügen Sie Ihrer Chat-App einen Bot hinzu.
- Teilnehmen an einem vorhandenen Chatthread aus der Azure Communication Services-Chatthread-UI-Bibliothek.