Freigeben über

Verwenden Sie einen klassischen Chatbot als Funktion in einem Bot-Service.

Anmerkung

Dieser Artikel gilt nur für klassische Chatbots. Diese Funktion ist in der neuen Copilot Studio Benutzeroberfläche nicht verfügbar.

Wenn Sie einen klassischen Chatbot als Fähigkeit mit einem Bot Service-Bot verwenden, bestimmt der Bot Service-Bot, ob etwas, das der Benutzer sagt, den Triggerausdrücken des klassischen Chatbots entspricht. Wenn es eine Übereinstimmung gibt, kann der Bot Service-Bot die Unterhaltung an den klassischen Chatbot übergeben. Der klassische Bot extrahiert alle Entitäten und löst das passende Thema aus.

Wichtig

Du musst eine Probe- oder eine vollständige Copilot-Studio-Lizenz haben, um klassische Chatbots als Fähigkeiten zu nutzen. Diese Funktion ist mit dem Copilot Studio for Teams-Plan nicht verfügbar.

Zum Einrichten Ihres klassischen Bots als Fertigkeit:

  1. Fügen Sie den Bot Service-Bot zur Zulassungsliste für den klassischen Chatbot hinzu.

  2. Sie laden das Fertigkeits-Manifest für den klassischen Chatbot herunter.

  3. Stellen Sie eine Verbindung mit einem Copilot Studio-Skill von Ihrem Bot her.

  4. Vergewissern Sie sich, dass der Bot als Fertigkeit funktioniert.

Anforderungen

Fügen Sie Ihren Bot Service-Bot zur Zulassungsliste für Ihren klassischen Chatbot hinzu

Fügen Sie die Bot Service App-ID des Bots der Positivliste für den klassischen Chatbots hinzu, den Sie als Fertigkeit verwenden möchten. Die Bots müssen sich im selben Mandanten befinden.

  1. Rufen Sie die Microsoft-App-ID für Ihren Bot Services-Bot ab. Diese Informationen finden Sie im Azure-Portal oder in den Botkonfigurationen.

  2. Öffnen Sie in Copilot Studio den klassischen Bot, den Sie als Fertigkeit verwenden möchten.

  3. Wechseln Sie im Navigationsmenü zu Einstellungen und wählen Sie Sicherheit aus. Wählen Sie dann Positivliste.

  4. Wählen Sie Zulässigen Anrufer hinzufügen.

  5. Fügen Sie die App-ID Ihres Bot Service-Bots ein, und wählen Sie Weiter aus.

    Vorsicht

    Ein klassischer Chatbot kann nicht als Fertigkeit für andere klassische Chatbots fungieren. Wenn Sie versuchen, der Positivliste eine App-ID hinzuzufügen, die zu einem Power Virtual Agent-Bot gehört, erhalten Sie eine Fehlermeldung. Sie können nur eine App-ID für einen Bot-Bot hinzufügen.

    Copilot Studio überprüft die App-ID des Bot-Dienst-Bots und bestätigt, dass er zu einem Bot im selben Mandanten gehört.

  6. (Optional): Fügen Sie einen Anzeigename für den Bot hinzu, den Sie der Positivliste hinzugefügt haben.

  7. Wählen Sie Speichern aus.

Wenn Sie einen eingegeben haben, erscheint der Bot des Bot-Dienstes unter seinem Anzeigenamen, oder unter seiner App-ID, wenn Sie keinen Anzeigenamen eingegeben haben. Um ihn jederzeit zu löschen oder zu bearbeiten, wählen Sie das Symbol rechts neben dem Anzeigename oder der App-ID des Bots aus.

Anmerkung

Bot-Dienst-Bots, die der Zulassungsliste hinzugefügt wurden, werden nicht als Teil des Bot-Inhalts exportiert.

Sie laden das klassische Fertigkeits-Manifest für Ihren klassischen Bot herunter

Bot-Service-Bots können ein Copilot Studio-Qualifikationsmanifest verwenden, um eine Verbindung mit dem klassischen Chatbot zu konfigurieren, der das Manifest erzeugt hat.

Alle klassischen Chatbots haben zwei Fertigkeitsmanifeste. Ein Fertigkeitsmanifest ist eine JSON-Datei, die den Namen, die Benutzeroberfläche und Triggerausdrücke eines Skills enthält.

Ein Bot-Service-Bot kann ein Fähigkeitsmanifest verwenden, um zu wissen, wann der klassische Chatbot ausgelöst wird (z. B. als Reaktion auf etwas, was ein Benutzer dazu sagt).

Copilot Studio-Qualifikationsmanifeste folgen Version 2.2 des Bot Service-Qualifikationsmanifestschemas und bestehen aus intents.lu und manifest.json Dateien.

Ein Bot Service-Bot kann entscheiden, dass ein klassischer Chatbot die Anforderung des Benutzers basierend auf den Manifestdaten verarbeiten soll. Es übergibt alles, was der Benutzer an den klassischen Chatbot gesagt hat. Dann gleicht der klassische Chatbot die Benutzeräußerung mit einem Copilot Studio Thema ab, extrahiert alle Entitäten, die für das Slot-Filling benötigt werden und löst das Copilot Studio Thema aus.

Alle Copilot Studio Fertigkeits-Manifeste werden automatisch generiert und aktualisiert. Ein klassischer Bot hat zwei Fertigkeitsmanifeste:

  • Testmanifest: Ermöglicht dem Bot Service-Bot, eine Verbindung mit der Testversion Ihres klassischen Chatbots herzustellen. Verwenden Sie das Testmanifest, um Änderungen an Ihrem Skill zu überprüfen, bevor Sie sie veröffentlichen.

    • Das Testmanifest ist für jeden neu erstellten klassischen Bot sofort verfügbar.
    • Es wird jedes Mal, wenn Sie Ihren klassischen Bot speichern, automatisch aktualisiert, um die Änderungen widerzuspiegeln.

  • Veröffentlichtes Manifest: Ermöglicht dem Bot-Service-Bot, eine Verbindung mit der veröffentlichten Version Ihres klassischen Chatbots herzustellen.

    • Das veröffentlichte Manifest ist nur für klassische Bots verfügbar, die mindestens einmal veröffentlicht wurden.
    • Es wird jedes Mal automatisch aktualisiert, um die Änderungen widerzuspiegeln, wenn Sie Ihren Agent veröffentlichen.

Anmerkung

Das veröffentlichte Manifest ist für klassische Bots, die nie veröffentlicht wurden, nicht verfügbar.

Um das von Ihren Bots veröffentlichte Manifest zu erstellen, veröffentlichen Sie Ihren klassischen Bot.

Beide Fertigkeit-Manifeste werden im Bereich Positivliste verwalten angezeigt.

Die Fertigkeitsmanifeste werden ebenfalls auf der Details-Seite des Chatbots angezeigt. Wählen Sie im Navigationsmenü Einstellungen und anschließend Details aus. Die Detailseite zeigt andere Metadaten an, darunter die Umgebungs-ID, Mandanten-ID und Bot-App-ID.

Um ein Manifest herunterzuladen, wählen Sie es aus. Es wird als.zip-Datei mit der Bezeichnung <bot name>manifest für das Veröffentlichte Manifest oder <bot name>test__manifest für das Testmanifest.

Anmerkung

Das Qualifikationsmanifest enthält keine Systemthemen. Es sind nur Themen, die von Chatbot-Autoren erstellt wurden, und Intent-Trigger, die Autoren dem Bot hinzufügen, enthalten.

Verbinden mit einem Copilot-Studio-Skill aus Ihrem Bot

Sie können die Informationen aus Ihrem Copilot Studio-Qualifikationsmanifest verwenden, um eine Qualifikationsverbindung in Ihrem Bot Service-Bot zu erstellen.

Weitere Informationen zur Struktur des Qualifikationsmanifests finden Sie unter Skills Manifest.

Der Abschnitt "Aktivitäten" des Qualifikationsmanifests enthält die Themen, die in Ihrem klassischen Chatbot verfügbar sind.

Sie können einen Fertigkeitsverbraucher in Ihrem Bot Service-Bot implementieren, um einen klassischen Chatbot als Fertigkeit aufzurufen.

Ihren klassischen Bot als Fertigkeit mit einem Bot Service-Bot testen

Sie können veranlassen, dass der Bot Service Emulator testet, dass Ihr Bot Service Bot einen klassischen Chatbot als Fertigkeit korrekt aufruft.

Wichtig

Ihr Bot Service-Bot muss der Zulassungsliste des klassischen Chatbots hinzugefügt werden, damit die Fähigkeitsverbindung funktioniert.

Aktualisieren Sie einen Multimandanten-Bot zu einem Einzelmandanten-Bot.

Die folgende Abbildung zeigt das Szenario, in dem ein Bot Service-Bot einen klassischen Chatbot aufruft, um ihn als Fähigkeit zu verwenden.

Abbildung der Interaktionen zwischen einem Bot Service Bot und einem klassischen Chatbot.

Sowohl der Bot Service-Bot als auch der klassische Chatbot verfügen über eine Microsoft Entra ID App-Registrierung, auf die von den Azure Bot-Instanzen verwiesen wird. Diese Microsoft Entra ID-App-Registrierungen wurden als mehrinstanzenfähig erstellt. Der Bot Service-Bot fordert ein Token vom Bot-Dienstmandanten an und verwendet dieses Token zur Authentifizierung bei Copilot Studio mit dem Azure Bot Service. Copilot Studio verwendet den gleichen Mechanismus, um den Bot Service-Bot zu kontaktieren.

Die Anwendungsregistrierung von dem Copilot Studio Chatbot wird jetzt als einzelner Mandant erstellt, sodass diese Kommunikation nicht mehr funktioniert. Microsoft Entra ID weigert sich, Token für Anwendungsregistrierungen mit einem Mandanten zu erstellen, die sich nicht im selben Mandanten befinden.

Copilot Studio überprüft außerdem das eingehende Token und lehnt Anforderungen von Mandanten ab, die nicht erwartet werden, z. B. die Mandanten-ID, in der die Anwendungsregistrierung des klassischen Chatbot erstellt wurde.

Um dieses Problem zu beheben, gibt es zwei mögliche Lösungen.

Klassische Chatbots im selben Mandanten wie der Bot-Service-Bot

In Szenarien, in denen der Copilot Studio-Chatbot bereits im selben Mandanten wie der Bot-Service-Bot bereitgestellt wird und nur von diesem Bot verwendet wird, aktualisieren Sie den Bot auf eine Konfiguration mit einem einzigen Mandanten, und stellen Sie dann Ihren BotDienst-Bot erneut bereit. Weitere Informationen zum Konfigurieren eines Botdienst-Bots für einen einzelnen Mandanten finden Sie unter Bereitstellen und Veröffentlichen eines Bots.

Copilot Studio Chatbot, der nicht auf Einzelmandant aktualisiert werden können

In Szenarien, in denen der Copilot Studio-Chatbot bereits im selben Mandanten wie der Bot Service-Bot bereitgestellt wird, aber der Bot nicht als Einzelmandanten-Bot aktualisiert werden kann, müssen Sie den Code im Bot Service-Bot aktualisieren, um das Token für die Kommunikation mit dem Copilot Studio-Chatbot zu erstellen. Das Token muss für den Mandanten erstellt werden, in dem auch der Copilot Studio-Chatbot erstellt wurde. Darüber hinaus muss die Antwort akzeptiert werden, was wahrscheinlich voraussetzt, dass Sie die Schritte unter Konvertieren eines vorhandenen Skills von einem mehrinstanzenfähigen in einen einzelnen Mandanten ausführen.

Weitere Informationen

  • Last updated on