Freigeben über

Agentenantwort mit dem Formulardesigner hinzufügen (Vorschauversion)

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Fügen Sie die Agent-Antwortkomponente einem Formular für modellgesteuerte Apps hinzu, das ein Microsoft Copilot Studio-Thema direkt aufrufen und dem Benutzer die Antwort anzeigen kann. Diese Komponente baut auf der Agent-API executeEvent auf und vereinfacht die Verwendung, da keine neue benutzerdefinierte Komponente erforderlich ist. Der implizite Kontext der App, der Seite und des Datensatzes sind in Copilot Studio verfügbar.

Diese Komponente unterstützt die folgenden Antworten von Copilot Studio:

  • Markdown
  • Adaptive Karte
  • Image
  • Video

Wichtig

  • Dies ist eine Previewfunktion.
  • Previewfunktionen sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Für diese Funktionen gelten ergänzende Nutzungsbedingungen, und sie stehen vor dem offiziellen Release zur Verfügung, damit Kund*innen früher Zugriff darauf erhalten und Feedback geben können.

Anforderungen

Erfordert die Benutzern erlauben, Daten mithilfe einer KI-gestützten Chatumgebung in Canvas und modellgesteuerten Apps Umgebungseinstellung für modellgesteuerte Apps. Weitere Informationen: Copilot Umgebungseinstellungen

Einem Formular eine Agent-Antwortkomponente hinzufügen

  1. Öffnen Sie den Formulardesigner, um ein Formular zu erstellen oder zu bearbeiten. Weitere Informationen: Erstellen von Formularen oder Bearbeiten von Formularen

  2. Wählen Sie im Formular-Designer Komponenten auf der Befehlsleiste aus.

  3. Erweitern Sie im Bereich Komponenten die Option Künstliche Intelligenz

  4. Ziehen Sie Agentenantwort auf das Formularcanvas.

    Agent-Antwort im Komponentenbereich

  5. Geben Sie im Dialogfeld Agent-Antwort hinzufügen den Ereignisnamen aus dem Thema in Copilot Studio im Feld Statischer Wert ein. Weitere Informationen: Ereignisname für ein Thema in Copilot Studio suchenEreignisnamen der Agentenantwort konfigurieren

    Anmerkung

    Die OptionAn Tabellenspalte binden wird für diese Komponente nicht unterstützt.

  6. Wählen Sie in der Befehlsleiste Speichern und veröffentlichen aus.

  7. Öffnen Sie das Formular in einer modellgesteuerten App, um die Komponente zu testen.

    Anmerkung

    In der Vorschau des Formulardesigners wird die Warnmeldung Agent Response ist nur verfügbar, wenn Sie die App abspielen angezeigt, da die Live-Vorschau noch nicht unterstützt wird.

Ereignisnamen für ein Thema in Copilot Studio suchen

  1. Öffnen Sie das Thema in Copilot Studio, und suchen Sie den Knoten Trigger.

  2. Vergewissern Sie sich, dass der Triggertyp Ein benutzerdefiniertes Clientereignis tritt ein oder Ein empfangenes Ereignis ist.

  3. Wählen Sie im Knoten TriggerBearbeiten aus.

    Copilot Studio – benutzerdefiniertes Clientereignis auslösen.

  4. Kopieren Sie im Eigenschaftenbereich Bei Ereignisaktivität den Wert der Eigenschaftszeichenfolge Ereignisname, der von der Agentenantwortkomponente übergeben werden soll. Weitere Informationen unter Trigger für ein Thema ändern

    Copilot Studio – Eigenschaftsbereich für Auslösen bei Ereignis.

Zugreifen auf App-Kontext

Wenn die Agent-Antwortkomponente das Copilot Studio-Thema aufruft, übergibt sie den Kontext für die App über einen Variablensatz. Im Folgenden sind Kontextvariablen aufgeführt, die als globale Copilot Studio-Variablen verfügbar sind.

Variable Beschreibung
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID des Tabellendatensatzes auf dem Hauptformular
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logischer Name der Tabelle in der Hauptseite
Global.PA__Copilot_Model_PageContext.pageContext.pageName Der Name der Hauptseite
Global.PA__Copilot_Model_PageContext.pageContext.pageType Typ der Hauptseite
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Eindeutiger Name der modellgesteuerten App

Barrierefreiheit

Wenn es sich bei der Copilot Studio-Antwort um eine adaptive Karte handelt, stellen Sie sicher, dass die folgenden bewährten Methoden befolgt werden, um eine barrierefreie Erfahrung zu erhalten.

Einschränkungen

  • Eigenschaften der Agentantwortkomponente werden derzeit nicht unterstützt:

    • Label
    • Beschriftung ausblenden
    • Auf Telefon ausblenden
    • Sperren
    • Schreibgeschützt
    • Komponentenbreite
    • Höhe der Komponente
    • An Tabellenspalte binden

  • Die Agentantwortkomponente unterstützt das Übergeben von zusätzlichem Kontext an Copilot Studio nicht. Erstellen Sie eine benutzerdefinierte Komponente mithilfe der Agent-API executeEvent , um das Übergeben von mehr Kontext zu unterstützen.

  • Die Agent-Antwortkomponente unterstützt nur eine schreibgeschützte adaptive Karte. Erstellen Sie eine benutzerdefinierte Komponente mithilfe der Agent-API executeEvent , um clientseitige Logik zu unterstützen.

  • Die Agentantwortkomponente wird für Mobile oder Tablets nicht unterstützt.

Häufig gestellte Fragen zu Agent-APIs und Agent-Antwortkomponente

Agent-API executeEvent

Übersicht über den modellgesteuerten Formulardesigner
Hinzufügen, Konfigurieren, Verschieben oder Löschen von Komponenten in einem Formular

  • Last updated on