Freigeben über


Erste Schritte bei der Integration von Conversational Language Understanding

In diesem Artikel erfahren Sie, wie Sie ein CLU-Modell in einen Agent integrieren.

Anmerkung

Stellen Sie sicher, dass sich die Umgebung für Ihren Agent in einer Region befindet, die von Copilot Studio mit einer entsprechenden CLU-Region unterstützt wird.

Nicht alle von Copilot Studio unterstützten Regionen verfügen über eine entsprechende CLU-Region.

Voraussetzungen

  • Ein vollständig geschultes CLU-Modell, einschließlich Absichten für alle Systemthemen und für alle benutzerdefinierten Themen, die Sie erstellen möchten
  • Die Schlüssel- und Vorhersage-URL für das bereitgestellte Modell
  • Der CLU-Projektname und der Bereitstellungsname
  • Ein Kontoschlüssel für Cognitive Services
  • Eine Website-URL für Azure AI Language
  • Ein Copilot Studio-Konto
  • Ein Copilot Studio-Agent , der für die Verwendung der klassischen Orchestrierung konfiguriert ist
  • Ein Copilot Studio-Sprachkonnektor, der für die Verwendung von maker-bereitgestellten Anmeldeinformationen konfiguriert ist

Vorbereiten des CLU-Projekts

  1. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.

  2. Erstellen Sie eine Sprachressource in Language Studio, wobei das Feature " Unterhaltungssprachenverständnis " aktiviert ist.

    Um sicherzustellen, dass Ihr Copilot Studio-Agent ordnungsgemäß funktioniert, muss das von Ihnen erstellte CLU-Modell über Absichten für alle Systemthemen und für alle benutzerdefinierten Themen verfügen, die Sie Ihrem Agent hinzufügen.

  3. Definieren Sie die Entitäten , die Ihr Copilot Studio-Agent verwenden soll.

  4. Training und Bereitstellung des CLU-Projekts in der gleichen Region wie Ihr Copilot Studio-Agent.

Vorbereiten Ihres Agents

  1. Wechseln Sie zur Einstellungen für Ihren Agent. Einstellungen für die Kategorie "Generative KI " werden angezeigt.

  2. Wenn die generative Orchestrierung aktiviert ist, wechseln Sie zu der klassischen Orchestrierung: Wählen Sie unter "Orchestrierung" die Option "Nein" aus.

  3. Wählen Sie im Seitenbereich " Sprachverständnis " aus.

  4. Wählen Sie "Vordefiniertes Azure NLU verwenden" aus.

  5. Wenn Ihre Umgebung noch nicht mit Azure AI Language verbunden ist oder Wenn Sie eine neue Verbindung verwenden möchten, wählen Sie " Verbindungen verwalten", wechseln Sie zu Power Apps, und erstellen Sie eine CLU-Verbindung.

  6. Wählen Sie die gewünschte CLU-Verbindung aus.

  7. Wählen Sie Speichern aus. Ein Fenster wird angezeigt, in dem Sie aufgefordert werden, eine Momentaufnahme Ihres Agents zu speichern, bevor Sie alle vorhandenen Triggerausdrücke für Ihre Themen löschen.

  8. Wählen Sie "Momentaufnahme speichern" aus, und speichern Sie das resultierende ZIP-Archiv (botContent.zip) an dem gewünschten Speicherort. Das ZIP-Archiv enthält eine einzelne YAML-Datei (botContent.yml) mit Ihrem Agent-Inhalt, einschließlich Triggerausdrücke und Nachrichten.

  9. Wählen Sie "Ja" aus, löschen Sie meine Auslöserausdrücke, und wählen Sie dann "Weiter" aus.

  10. Geben Sie den Namen und die Modellbereitstellungsinformationen für das entsprechende Azure AI Language-Projekt ein, und wählen Sie "Speichern" aus. Nach Abschluss dieses Vorgangs können Sie ein neues Systemthema mit dem Namen "Text analysieren" sehen. Dieses Thema ist mit Ihrem CLU-Modell verbunden, und sein Zweck besteht darin, Absichten und Entitäten in Unterhaltungen zwischen Kunden und Ihrem Agenten zu erkennen.

    Anmerkung

    Wenn Sie die Sprachverständniskonfiguration für Ihren Agenten wieder in Microsoft Copilot Studio NLU ändern, wird das Systemthema Analyze Text entfernt. Außerdem müssen Sie Beispielausdrücke für Themen, die derzeit externen Absichten zugeordnet sind, manuell hinzufügen.

Zuordnen von CLU-Absichten und Entitäten

Beginnen Sie in Ihrem Copilot Studio-Agent mit der Zuordnung vorhandener Themen zu CLU-Absichten. Sie können Absichten und Entitäten manuell zuordnen oder massenweise Zuordnungen durchführen.

Manuelles Zuordnen von CLU-Absichten zu Themen

  1. Wechseln Sie zur Seite "Themen" für Ihren Agenten.

  2. Wählen Sie das gewünschte Thema aus.

  3. Wählen Sie auf dem Knoten "Trigger" die Option "Bearbeiten" aus. Der Bereich "Ausdrücke" wird angezeigt.

  4. Geben Sie unter "Absichtsname" den Namen der CLU-Absicht ein, die Sie diesem Thema zuordnen möchten. Der Intent-Name wird auf dem Trigger-Knoten unter Externe Intention angezeigt.

    Anmerkung

    Der CLU-Absichtsname muss genau so eingegeben werden, wie im CLU-Modell gespeichert, einschließlich übereinstimmenden Groß-/Kleinschreibung.

  5. Wählen Sie Speichern aus.

  6. Wiederholen Sie diese Schritte für alle verbleibenden Themen, die Sie einer externen CLU-Absicht zuordnen möchten.

Entitäten manuell zuordnen

  1. Wechseln Sie zur Einstellungen für Ihren Agent.

  2. Wählen Sie Entitäten aus.

  3. Wählen Sie Eine Entität hinzufügen>Eine externe Entität registrieren aus.

  4. Geben Sie in dem daraufhin geöffneten Bereich den gewünschten Namen und eine Beschreibung ein (optional).

  5. Wählen Sie für "Datentyp" die Option "Aus Beispieldaten" aus.

  6. Wählen Sie "Schema aus BEISPIEL-JSON abrufen", geben Sie einen JSON-Codeausschnitt für Ihre CLU-Entität ein, und wählen Sie "Bestätigen" aus. Hier finden Sie Beispiel-JSON-Codeausschnitte bei der Entitätsregistrierung für die Integration von konversationellem Sprachverständnis.

  7. Wählen Sie "Speichern" aus, und schließen Sie den Bereich.

  8. Wiederholen Sie diese Schritte für alle verbleibenden Entitäten, die Sie einer externen CLU-Entität zuordnen möchten.

Massenzuordnung durchführen

  1. Wechseln Sie zur Einstellungen für Ihren Agent.

  2. Wählen Sei Sprachverständnis.

  3. Wählen Sie "Themen und Entitäten aus Modelldaten hinzufügen" aus. Der Assistent zum Hinzufügen von Absichten und Entitäten wird angezeigt.

  4. Wählen Sie "Datei auswählen" aus, um die Datei mit ihren CLU-Modelldaten auszuwählen.

    Ihre Modelldaten werden im Vorschaubereich angezeigt.

  5. Wählen Sie Weiteraus. Der Bildschirm "Vorhandene Themen zuordnen" wird angezeigt.

  6. Wählen Sie die gewünschte CLU-Absicht für jedes Thema aus.

  7. Überprüfen Sie Ihre Auswahl, und wählen Sie "Weiter" aus. Der Bildschirm " Neue Themen erstellen " wird mit Absichten angezeigt, die keinem vorhandenen Thema zugeordnet sind.

  8. Erstellen Sie bei Bedarf ein neues Thema für jede dieser Absichten: Geben Sie unter "Neues Thema erstellen" einen Namen für jedes Thema ein, das Sie erstellen möchten.

    Anmerkung

    Der Assistent ignoriert alle Felder, die Sie leer lassen.

  9. Wählen Sie Weiteraus. Der Bildschirm " Entitäten registrieren " wird mit den CLU-Entitäten aus der Modelldatendatei angezeigt.

  10. Wählen Sie den entsprechenden Datentyp für die Entitäten aus, die Sie verwenden möchten, und wählen Sie dann "Weiter" aus. Der Bildschirm " Überprüfen" wird angezeigt.

  11. Überprüfen Sie die Zuordnungen auf der Registerkarte "Vorhandene Themen", " Neue Themen" und " Neue Entitäten ", und wählen Sie " Speichern" aus.

  12. Überprüfen Sie die Informationen auf dem Erfolgsbildschirm , und wählen Sie "Fertig" aus.

Sobald Sie mit diesem Verfahren fertig sind, können Sie zur Seite "Themen" wechseln, um Ihre Themen zu überprüfen. Weitere Informationen finden Sie unter Themen verwalten.

Neue CLU-Verbindung in Power Apps erstellen

  1. Wenn sich die Seite "Verbindungen " in Power Apps noch nicht im Fokus befindet, wählen Sie "Verbindungen " im linken Bereich aus.

  2. Wählen Sie Neue Verbindung.

  3. Wählen Sie Azure Cognitive Service for Language aus (verwenden Sie bei Bedarf das Suchfeld, um die Liste einzugrenzen). Es erscheint ein Fenster, in dem Sie zur Eingabe von Authentifizierungsinformationen aufgefordert werden.

  4. Wählen Sie als Authentifizierungstyp API-Schlüssel aus und geben Sie den erforderlichen Kontoschlüssel ein.

  5. Geben Sie die entsprechende Stammsite-URL ein (sofern vorhanden) ein.

  6. Wählen Sie Erstellen aus Die neue Verbindung mit dem Standardnamen „Azure Cognitive Service for Language“ wird in der Liste der Verbindungen für Ihre Umgebung angezeigt.

  7. Wählen Sie die drei Punkte () neben dieser Verbindung aus, und wählen Sie "Bearbeiten" aus.

  8. Ersetzen Sie im daraufhin angezeigten Fenster den Standardanzeigenamen durch etwas anderes, um diese Verbindung von anderen CLU-Verbindungen zu unterscheiden, und wählen Sie "Aktualisieren" aus.