Freigeben über

Einen klassischen Chatbot als Skill in einem Bot Framework-Bot verwenden

  • Artikel

Anmerkung

Dieser Artikel enthält Informationen, die nur für Copilot Studio klassische Chatbots gelten. Diese Funktion ist in der neuen Copilot Studio Erfahrung nicht verfügbar.

Wenn Sie einen klassischen Chatbot als Fertigkeit mit einem Bot Framework Bot verwenden, bestimmt Bot Framework Bot, ob alles, was der Benutzer sagt, mit den Trigger-Phrasen des klassischen Chatbots übereinstimmt. Wenn eine Übereinstimmung vorliegt, leitet Bot Framework Bot die Konversation an den klassischen Chatbot weiter. Der klassische Chatbot extrahiert beliebige Entitäten und löst die passenden Thema aus.

Sie können auch eine Variable als Eingabe Copilot Studio von Composer an Bot Framework Fertigkeit Thema übergeben und die zurückgegebenen Ausgaben verwenden.

Wichtig

Sie müssen über eine Testversion oder Volllizenz Copilot Studio verfügen, um klassische Chatbots als Skills zu verwenden. Diese Funktion ist mit der Teams Copilot Studio Lizenz nicht verfügbar.

So richten Sie Ihren klassischen Chatbot als Fertigkeit ein:

  1. Fügen Sie Bot Framework Bot zur Whitelist für den klassischen Chatbot hinzu.

  2. Laden Sie das Manifest Fertigkeit für den klassischen Chatbot herunter.

  3. Verwenden Sie das heruntergeladene Manifest Fertigkeit in Bot Framework Composer, um eine Verbindung zwischen den Bots herzustellen.

  4. Verwenden Sie den Bot Framework Emulator, um zu bestätigen, dass Bot als Fertigkeit funktioniert.

Anforderungen

Fügen Sie Ihr Bot Framework Bot zur Whitelist für Ihren klassischen Chatbot hinzu.

Fügen Sie die App-ID von Bot Framework Bot zur Whitelist für den klassischen Chatbot hinzu, den Sie als Fertigkeit verwenden möchten. Die Bots müssen sich im selben Mandanten befinden.

  1. Öffnen Sie im Bot Framework Composer den Bot, der den Skill verwenden wird. Wählen Sie Konfigurieren und dann Entwicklungsressourcen aus. Kopieren Sie die ID in Microsoft-App-ID.

  2. Öffnen Sie in Copilot Studio den klassischen Chatbot, 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 Ihre Bot Framework-Bots App-ID ein und wählen Sie Weiter.

    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 eine App-ID nur für einen Bot Framework-Bot hinzufügen.

    Copilot Studio validiert die Bot Framework App-ID des Bot und bestätigt, dass sie 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.

Der Bot Framework-Bot wird durch seinen Anzeigenamen angezeigt, wenn Sie einen eingegeben haben, oder durch seine 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.

Notiz

Bot Framework-Bots, die der Positivliste hinzugefügt werden, werden nicht als Teil des Bot-Inhalts exportiert.

Laden Sie das Manifest des klassischen Chatbots Fertigkeit für Ihren klassischen Chatbot herunter

Bot Framework Bots können ein Copilot Studio Fertigkeit-Manifest verwenden, um eine Verbindung zum klassischen Chatbot zu konfigurieren, der das Manifest erstellt hat.

Alle klassischen Chatbots haben Fertigkeit-Manifeste. Dies sind JSON-Dateien, die den Namen, die Benutzeroberfläche und Triggerausdrücke eines Skills enthalten.

A Bot Framework Bot kann ein Fertigkeit-Manifest verwenden, um zu wissen, wann der klassische Chatbot Trigger sein soll (z. B. in Antwort auf etwas, das ein Benutzer ihm sagt).

Copilot Studio Fertigkeit-Manifeste folgen Version 2.2 des Bot Framework Fertigkeit-Manifestschemas und bestehen aus intents.lu und Manifest.json Dateien.

A Bot Framework Bot kann basierend auf den Manifestdaten entscheiden, ob der klassische Chatbot die Anfrage des Benutzers bearbeiten soll. Es gibt alles, was der Benutzer gesagt hat, an den klassischen Chatbot weiter. Anschließend gleicht der klassische Chatbot die Benutzeräußerungen mit einem Copilot Studio Thema ab, extrahiert alle Entitäten, die zum Ausfüllen der Slots erforderlich sind, und löst den Copilot Studio Thema aus.

Copilot Studio Fertigkeit-Manifeste werden automatisch generiert und aktualisiert. Ein klassischer Chatbot hat zwei Fertigkeit-Manifeste:

  • Testmanifest: Ermöglicht dem Bot Framework Bot, Verbinden zur Testversion Ihres klassischen Chatbots zu machen. Verwenden Sie das Testmanifest, um Änderungen an Ihrem Skill zu überprüfen, bevor Sie sie veröffentlichen.

    • Das Testmanifest steht für jeden neu erstellten klassischen Chatbot sofort zur Verfügung.
    • Es wird automatisch aktualisiert, um Änderungen widerzuspiegeln, jedes Mal, wenn Sie Ihren klassischen Chatbot speichern .

  • Veröffentlichtes Manifest: Ermöglicht dem Bot Framework Bot, Verbinden zur veröffentlichten Version Ihres klassischen Chatbots zu machen.

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

Anmerkung

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

Um das Veröffentlichte Manifest Ihres Bot zu generieren, veröffentlichen Sie Ihren klassischen Chatbot.

Beide Skillsanifeste werden im Bereich Positivliste verwalten angezeigt.

Die Skillmanifeste werden auch auf der Detailseite des Copiloten angezeigt. Wählen Sie im Navigationsmenü Einstellungen und anschließend Details aus. Die Detailsseite 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 heruntergeladen.

Anmerkung

Das Manifest Fertigkeit enthält keine Systemthemen und Composer-Dialoge, die einem klassischen Chatbot hinzugefügt werden. Nur Themen, die von Copilot-Autoren erstellt wurden, und Composer-Absichts-Trigger, die Autoren dem Bot hinzufügen, sind enthalten.

Verbinden zu a Copilot Studio Fertigkeit im Composer

Verwenden Sie Copilot Studio Fertigkeit-Manifeste, um eine Fertigkeit-Verbindung in Ihrem Bot Framework Bot in Composer zu erstellen.

  1. Wählen Sie in einem Bot Framework Composer-Projekt Hinzufügen und dann Mit einer Fertigkeit verbinden.

  2. Navigieren Sie zu Auswählen einem Copilot Studio Manifest-ZIP-Archiv und dann zu Auswählen Weiter.

  3. Auswählen die Themen oder Absichten in Ihrem klassischen Chatbot, die Sie zu Ihrem Bot Framework Bot hinzufügen möchten, und dann Auswählen Weiter.

  4. Überprüfen und bearbeiten Sie die Trigger-Phrasen für Ihren klassischen Chatbot und dann Auswählen Weiter.

  5. Stellen Sie sicher, dass Orchestrator für Projekte mit mehreren Bots verwenden ausgewählt ist, und wählen Sie dann Weiter.

  6. Überprüfen Sie, ob Copilot Studio Fertigkeit korrekt zu Ihrem Bot Framework Bot hinzugefügt wurde und ob im Projekt in Composer ein neues Trigger mit dem Namen Ihres klassischen Chatbots angezeigt wird.

Thema im Skillmanifest suchen

Verwenden Sie ein Ereignis, um ein Copilot Studio Thema im Fertigkeit zu Trigger. Um ein bestimmtes Thema von Composer aus aufzurufen, beziehen Sie sich auf das Thema mit dem im Skillmanifest damit verbundenen Namen.

  1. Wählen Sie die Aktion Mit einer Fertigkeit verbinden aus.

  2. Wählen Sie unter Name des Fertigkeitsdialogs Skillmanifest anzeigen aus.

  3. Suchen Sie im Manifest die Aktivitäten. Diese Eigenschaft enthält verschachtelte Eigenschaften, die die in Ihrem klassischen Chatbot verfügbaren Themen darstellen.

  4. Finden Sie das Thema, das Sie aufrufen möchten, und suchen Sie der Eigenschaft Name. Wenn Copilot Studio Fertigkeit ein Ereignis mit diesem Namen empfängt, löst es Thema aus.

    In diesem Beispiel lautet der Name der Ereignisaktivität dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Rufen Sie a Copilot Studio Fertigkeit Thema an

Anstatt sich darauf zu verlassen, was ein Benutzer zu Trigger a Copilot Studio Fertigkeit Thema, sagt, können Sie es direkt aufrufen. Sie können nur Themen direkt aufrufen, die im Manifest Fertigkeit aufgeführt sind. Copilot Studio

  1. Wählen Sie im Composer-Erstellungsbereich Hinzufügen, dann Auf externe Ressourcen zugreifen und schließlich Mit einem Skill verbinden aus.

  2. Geben Sie in der Liste Fertigkeit Dialogname Ihren klassischen Chatbot Auswählen ein.

  3. Suchen Sie den Namen der Ereignisaktivität für den klassischen Chatbot Thema , den Sie aufrufen möchten. Kopieren Sie den Wert, lassen Sie die Anführungszeichen weg, und speichern Sie ihn, um ihn in den nächsten Schritten zu verwenden.

  4. Wählen Sie Schließen aus.

  5. Wählen Sie im Bereich Aktivität Code anzeigen aus.

  6. Geben Sie den folgenden Code ein oder kopieren Sie ihn hinein. Ersetzen Sie TOPIC_ACTIVITY_NAME mit dem Namen Ihrer Ereignisaktivität des Themas. Stellen Sie sicher, dass keine Anführungszeichen in der Eigenschaft name enthalten sind.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

Übergeben Sie eine Eingabevariable an a Copilot Studio Fertigkeit Thema

Bot Framework Composer kann eine Variable als Eingabe an a Copilot Studio Fertigkeit Thema übergeben. Informationen zum Erstellen von Copilot Studio Themen, die Eingabevariablen akzeptieren, finden Sie unter Mit Variablen arbeiten.

Wenn in Ihrem Fertigkeit-Manifest ein Copilot Studio Thema aufgeführt ist, das eine Eingabevariable empfangen kann, können Sie ihm eine Composer-Variable übergeben.

  1. Wählen Sie im Composer-Erstellungsbereich Hinzufügen, dann Auf externe Ressourcen zugreifen und schließlich Mit einem Skill verbinden aus.

  2. Geben Sie in der Liste Fertigkeit Dialogname Ihren klassischen Chatbot Auswählen ein.

  3. Suchen Sie den Namen der Ereignisaktivität für den klassischen Chatbot Thema , den Sie aufrufen möchten. Kopieren Sie den Wert, lassen Sie die Anführungszeichen weg, und speichern Sie ihn, um ihn in den nächsten Schritten zu verwenden.

  4. Suchen Sie die Eigenschaft Wert des Themas. Die Eigenschaft Wert enthält eine Eigenschaft $ref. Kopieren Sie diesen Wert und speichern Sie ihn, um ihn im nächsten Schritt zu verwenden.

    Warnung

    Wenn ein Copilot Studio Thema keine Eingaben hat, verfügt es auch nicht über die Eigenschaft Wert .

  5. Suchen Sie die Eigenschaft Definitionen und suchen Sie dann nach einer verschachtelten Eigenschaft, die mit dem $ref-Wert übereinstimmt, den Sie im vorherigen Schritt gefunden haben. Beachten Sie die Namen und Typen der Eingaben von Copilot Studio Thema. Sie werden sie in den nächsten Schritten verwenden.

  6. Wählen Sie Schließen aus.

  7. Wählen Sie im Bereich Aktivität Code anzeigen aus.

  8. Geben Sie den folgenden Code ein oder kopieren Sie ihn hinein. Ersetzen Sie diese Werte:

    1. Ersetzen Sie TOPIC_ACTIVITY_NAME mit dem Namen Ihrer Ereignisaktivität des Themas.
    2. Ersetzen Sie PVA_INPUT_VARIABLE mit einer Eingabevariablen aus Ihrem Thema.
    3. Ersetzen Sie COMPOSER_INPUT_VARIABLE mit einer Composer-Variablen, die einen Wert bereitstellt.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    In diesem Beispiel stellt die Composer-Variable dialog.storeLocation einen Wert für die Eingabevariable pva_StoreLocation im klassischen Chatbot Thema dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 bereit.

Empfangen Sie eine Ausgabevariable von a Copilot Studio Fertigkeit Thema

Es ist möglich, Ausgaben von a Copilot Studio Fertigkeit Thema in Composer zu empfangen. Informationen zum Erstellen von Copilot Studio Themen, die Ausgaben zurückgeben, finden Sie unter Arbeiten mit Variablen.

  1. Wählen Sie im Composer-Erstellungsbereich Hinzufügen, dann Auf externe Ressourcen zugreifen und schließlich Mit einem Skill verbinden aus.

  2. Geben Sie in der Liste Fertigkeit Dialogname Ihren klassischen Chatbot Auswählen ein.

  3. Suchen Sie den Namen der Ereignisaktivität für Ihren klassischen Chatbot Thema , den Sie anrufen möchten. Kopieren Sie den Wert, lassen Sie die Anführungszeichen weg, und speichern Sie ihn, um ihn in den nächsten Schritten zu verwenden.

  4. Suchen Sie die Eigenschaft resultValue des Themas. Die resultValue-Eigenschaft enthält eine Eigenschaft $ref. Kopieren Sie diesen Wert und speichern Sie ihn, um ihn im nächsten Schritt zu verwenden.

    Warnung

    Wenn ein Copilot Studio Thema keine Ausgaben hat, verfügt es auch nicht über die Eigenschaft resultValue .

  5. Suchen Sie die Eigenschaft Definitionen und suchen Sie dann nach einer verschachtelten Eigenschaft, die mit dem $ref-Wert übereinstimmt, den Sie im vorherigen Schritt gefunden haben. Beachten Sie die Namen und Typen der Ausgabevariablen von Copilot Studio Thema. Sie werden sie in den nächsten Schritten verwenden.

    In diesem Beispiel gibt Copilot Studio Thema zwei Ausgaben vom Typ String zurück, pva_State und pva_Item.

  6. Wählen Sie Schließen aus.

  7. Wählen Sie im Bereich Aktivität Code anzeigen aus.

  8. Geben Sie den folgenden Code ein oder kopieren Sie ihn hinein. Ersetzen Sie TOPIC_ACTIVITY_NAME mit dem Namen Ihrer Ereignisaktivität des Themas. Stellen Sie sicher, dass keine Anführungszeichen in der Eigenschaft name enthalten sind.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

  9. Legen Sie im Codebereich die Eigenschaft auf eine Composer-Variable fest, um die Ausgabewerte von Copilot Studio Fertigkeit Thema. zu empfangen und zu speichern

  10. Wählen Sie im Composer-Erstellungsbereich Hinzufügen aus, dann Eigenschaften verwalten und schließlich Eigenschaften festlegen.

  11. Legen Sie Eigenschaft auf den Composer-Wert fest, der den extrahierten Wert speichern soll. Dann legen Sie Wert auf die Composer-Variable fest, in der Sie die Ausgaben des Themas gespeichert haben.

    In diesem Beispiel werden die Ausgabewerte von dialog.skillResult.pvaState und dialog.skillResult.pvaItem in neue Composer-Variablen dialog.State und dialog.Item extrahiert.

Testen Sie Ihren klassischen Chatbot als Fertigkeit mit einem Bot Framework Bot

Verwenden Sie den Bot Framework Emulator , um zu testen, ob Ihr Bot Framework Bot einen klassischen Chatbot ordnungsgemäß als Fertigkeit aufruft.

Wichtig

Ihr Bot Framework Bot muss zur Whitelist des klassischen Chatbots hinzugefügt werden, damit die Fertigkeit-Verbindung funktioniert.

Weitere Informationen