Veranstaltungsübersicht Trigger (Vorschauversion)

Sie können benutzerdefinierte Agenten konfigurieren, um Aktionen auszuführen oder Themen in Antwort aufzurufen, wenn mithilfe von Ereignisauslösern etwas passiert. Im Gegensatz zu Thema-Auslösern, die eine Benutzereingabe erfordern, ermöglichen Ereignisauslöser Ihrem Agent, in Antwort autonom zu reagieren, wenn das definierte Ereignis eintritt.

Wichtig

Die Verwendung von Ereignisauslösern ist ein öffentliches Previewfunktion. Die Verwendung von Ereignisauslösern ist für Vorschauversion-Teilnehmer kostenlos, erfordert jedoch Nachrichten, die auf Ihre Nutzungskontingente angerechnet werden. Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Anmerkung

Diese Funktion ist nur für Agenten mit aktivierter generativer Orchestrierung verfügbar.

Funktionsweise von Ereignisauslösern

Ereignisauslöser erfordern ein ausgewähltes Ereignis, das eine Trigger-Nutzlast generiert und diese über einen Connector an Agent sendet. Die Nutzlast enthält Informationen zum Ereignis, einschließlich Variablen für bestimmte Arten von Daten. Wenn Agent die Nutzlast empfängt, führt es die vom Agent Autor in den Anweisungen von Agent bereitgestellten Anweisungen und die über die Nutzlast Trigger gesendeten Anweisungen aus.

Agenten handeln nur auf Grundlage des Entwurfs und der Anweisungen ihres Autor. Sie können beispielsweise ein Trigger hinzufügen, wenn ein neues Teammitglied hinzugefügt wird, und Antwort als Aktion festlegen, dem neuen Mitarbeiter eine Willkommensnachricht mit Onboarding-Ressourcen zu senden.

Ereignisauslöser werden basierend auf externen Ereignissen von Agent aktiviert. Sie unterscheiden sich von Thema-Triggern, die zum Aktivieren von Themen oder Aktionen basierend auf von Benutzern eingegebenen Trigger-Phrasen verwendet werden.

In diesem Artikel wird die Funktionsweise von Ereignisauslösern, ihre Einschränkungen und Strategien zur Fehlerbehebung erläutert. Weitere Informationen zum Hinzufügen eines Ereignisses Trigger finden Sie unter Ereignis Trigger hinzufügen.

Weitere Beispiele für Ereignisauslöser sind:

• Wenn ein Artikel erstellt wird in SharePoint
• Wenn eine Datei erstellt wird in OneDrive
• Wenn ein Aufgabe im Planner abgeschlossen ist
• Wenn eine neue E-Mail in Outlook eintrifft
• Eine festgelegte Zeitspanne ist vergangen (a Wiederholung Trigger)

Wichtig

Welche Auslöser verfügbar sind, hängt von den Daten-Schadensverhütung-Richtlinien Ihrer Organisation ab, die Power Automate von einem Administrator konfiguriert wurden.

Der Trigger-Workflow

Ein Trigger ist ein Teil eines Workflows, der mehrere Teile enthält:

1. Ein Ereignis Trigger registriert, dass ein bestimmtes Ereignis eingetreten ist.
2. Trigger sendet eine Nutzlast mit Informationen zum Ereignis und Anweisungen.
3. Agent verfügt über Anweisungen zum Auswählen einer oder mehrerer Aktionen basierend auf der Nutzlast.

Finden Sie das Trigger, das zu Ihrer Veranstaltung passt

Copilot Studio verfügt über eine Bibliothek mit Auslösern für eine Reihe von Ereignissen, die in Microsoft und Partnerdiensten auftreten können. Die Trigger-Konfiguration bestimmt die Parameter des Ereignisses, das Trigger initiiert. Es bestimmt auch den Inhalt der Nutzlast Trigger.

Bei den meisten Auslösern können Sie Parameter für das Ereignis angeben, das die Aktivierung von Trigger auslöst. Beispielsweise können Sie im Beim Eintreffen einer neuen E-Mail Trigger für Outlook festlegen, dass nur E-Mails, deren Betreffzeile die Zeichenfolge Projektdetails enthält, das Trigger aktivieren, und nicht jede eingehende E-Mail.

Definieren Sie die Nutzlast Trigger

Die Nutzlast Trigger ist eine JSON- oder Nur-Text-Nachricht, die Informationen zu einem Ereignis enthält. Die Nutzlast wird als Nachricht an Ihr Agent gesendet. Wenn Sie ein Trigger hinzufügen, können Sie den Standardnutzlastinhalt für dieses Trigger beibehalten oder Ihre eigenen Anweisungen hinzufügen. Später können Sie den Inhalt der Nutzlast ändern, einschließlich der Hinzufügung von Variablen und Zeichenfolgenoperatoren, in Power Automate.

Beispielsweise lautet die Standardnachricht im Dialogfeld Wenn eine neue E-Mail eintrifft Trigger Inhalt verwenden von Body. Wenn Agent die Nutzlast empfängt, verfügt es über den Inhalt aus dem E-Mail-Text sowie Anweisungen zur Verwendung dieses Inhalts.

Sie können der Nutzlast Anweisungen hinzufügen, die an Ihr Agent gesendet werden und die dem Agent mitteilen, wie es sich verhalten soll, wenn es durch Trigger aktiviert wird. Wenn Sie mehrere Auslöser haben, kann jede Trigger-Nutzlast spezifische und detaillierte Anweisungen enthalten, ohne dass Sie lange und komplizierte Anleitungen in die allgemeinen Anweisungen von Agent schreiben oder Agent darüber verwirren müssen, welche Anweisungen für welches Trigger gelten.

Beispielsweise können Sie in der Nutzlast Wenn eine neue E-Mail eintrifft Trigger die Option Nach Aktionselementen für den Empfänger suchen Body hinzufügen. Wenn Agent die Nutzlast empfängt, erhält es die Anweisung, im Text der E-Mail nach Aktionselementen zu suchen.

Vermeiden Sie jedoch das Schreiben von Payload-Anweisungen, die mit den allgemeinen Anweisungen von Agent in Konflikt stehen. Konflikte in den Anweisungen können zu Fehlern oder unerwarteten Ergebnissen führen. Stellen Sie sicher, Testen Sie alle Änderungen, die Ereignisauslöser beinhalten.

Nachdem Sie ein Trigger erstellt haben, können Sie Variablen oder Zeichenfolgenoperatoren in einer Trigger-Nutzlast hinzufügen oder ändern und vorhandene Nutzlastanweisungen mithilfe ändern Power Automate.

Agent-Anweisungen im Vergleich zu Payload-Anweisungen

Nutzlastanweisungen legen fest, wie auf ein bestimmtes Ereignis reagiert werden soll. Sie können Agent-Anweisungen auch verwenden, um Ihrem Agent mitzuteilen, wie es mit Informationen von einem Trigger umgehen soll, wie es sich verhalten soll, wenn es eine Trigger-Nutzlast empfängt, und um das allgemeine Verhalten Ihres Agent festzulegen. Beispielsweise könnten die Anweisungen für ein Agent, das Microsoft-Aufgaben auf Grundlage eingehender E-Mails erstellt, wie folgt lauten: Wenn Sie Aktionselemente aus einer neuen E-Mail erhalten, erstellen Sie in der Aufgabenliste eine Aufgabe Aufgabe.

Allerdings sind die Anweisungen für Agent möglicherweise nicht in allen Situationen optimal geeignet. Wenn Ihr Agent mehrere Auslöser oder mehrere komplexe Ziele hat, sollten Sie stattdessen Anweisungen in der Trigger-Nutzlast verwenden.

Um das letzte Beispiel fortzusetzen, könnten Sie der Nutzlast Trigger eine Anweisung hinzufügen, um nach Aktionselementen für den Empfänger zu suchen Body. Wenn Agent die Nutzlast empfängt, wird es angewiesen, nach Aktionselementen zu suchen. Die allgemeinen Anweisungen von Agent weisen es dann an, für jedes gefundene Aktionselement Aufgaben zu erstellen.

Das Erstellen von Anweisungen für Agenten erfordert Übung. Weitere Tipps finden Sie unter Schreibanleitung und testen Sie stets alle Änderungen, die Sie an Ihrem Agent vornehmen.

Rufen Sie eine Aktion auf oder Thema

Wenn ein Agent eine Trigger-Nutzlast empfängt, bestimmen die Anweisungen, die Sie ihm gegeben haben, die Aktion oder das Thema, das es in Antwort aufruft. Ihre Anweisungen ermöglichen Ihrem Agent, basierend auf den verfügbaren Informationen eine Aktion Auswählen oder Thema auszuführen.

Ihr Agent erstellt nicht sofort eine neue Aktion oder Thema. Als Agent Autor, müssen Sie die Aktionen oder Themen definieren, von denen es Auswählen kann. Um zu erfahren, wie Ihr Agent bestimmt, welche Aktion oder Thema aufgerufen werden soll, gehen Sie zu Wie funktioniert der generative Modus?

Wenn Ihr Agent nicht wie erwartet reagiert, können Sie mit Aktivitätenkarte prüfen, ob wichtige Eingabeinformationen fehlen.

Sie können die Anweisungen unter anderem wie folgt verbessern:

• Hinzufügen detaillierterer Anweisungen zur Nutzlast Trigger oder zu den Anweisungen Agent. Ihr Agent benötigt möglicherweise mehr Anleitung, beispielsweise welche Informationen in einem bestimmten Eingabefeld für eine Aktion verwendet werden sollen.
• Einschließlich Anweisungen in der Trigger-Nutzlast.
• Weisen Sie Ihr Agent an, eine bestimmte Aktion oder Thema aufzurufen.
• Girokonto für widersprüchliche Anweisungen zwischen der Nutzlast von Trigger und den Anweisungen von Agent.
• Die Beschreibungen der Aktionen werden ergänzt, sodass Agent über mehr Informationen verfügt, um zu bestimmen, wann es aufgerufen werden soll.
• Hinzufügen von Beschreibungen zu den Aktionseingabefeldern, um Ihrem Agent dabei zu helfen, die Parameter korrekt auszufüllen. Wenn die Eingaben einer Aktion jedes Mal gleich sind, können Sie den Wert selbst festlegen.
• Aufruf von weniger als 15 Aktionen oder Themen hintereinander. Bei komplexen Agenten, die viele Aktionen oder Themen in einer einzigen Sequenz ausführen, kann es schwierig sein, diese zuverlässig auszuführen.

Wenn Ihr Agent immer noch Probleme hat, die erwartete Aktion aufzurufen, sollten Sie einen Power Automate Flow hinzufügen, der Ihr Ziel als Aktion für Ihr Agent erfüllt.

Veröffentlichungsagenten mit Ereignisauslösern

Bevor Sie Ihr Agent mit einem neuen Ereignis Trigger veröffentlichen, reagiert Agent nicht automatisch auf dieses Trigger. Stellen Sie sicher, dass Sie Agent vor der Veröffentlichung gründlich testen, denn nachdem Sie ein Agent veröffentlicht haben mit einem neuen Trigger, reagiert Ihr Agent jedes Mal automatisch, wenn seine Auslöser aktiviert werden. Sie können eine schrittweise Aufzeichnung der Auslöser und Reaktionen Ihres Agent auf der Aktivitätsseite sehen.

Informationen zum Aktivieren von Triggern während des Tests finden Sie unter Testen Sie ein Trigger.

Ereignisauslöser können zur Authentifizierung nur die Agent Autor's-Anmeldeinformationen verwenden (also die Anmeldeinformationen, die Sie zum Autorisieren der Verbindungen verwendet haben) für Ihr Trigger. Dadurch können Benutzer eines Agent das Agent verwenden, um mit derselben Autorisierung auf Daten und Systeme zuzugreifen. Weitere Informationen finden Sie unter Fehlerbehebung und Einschränkungen.

Authentifizierungsaktionen nach der Veröffentlichung

Wenn Ihrem Agent die Authentifizierung zum Ausführen einer Aktion fehlt oder es so konfiguriert ist, dass eine Benutzerauthentifizierung angefordert wird, sendet es eine Nachricht an den Benutzer, in der es um Anmeldeinformationen bittet. Wenn der Flow eines Agent unterbrochen wird, weil er keine Informationen empfangen kann oder eine Aktion fehlgeschlagen ist, kann die Sitzung nicht fortgesetzt werden. Wenn Ihr Agent autonom ausgeführt werden soll, muss jede Aktion mit einer funktionierenden Authentifizierung konfiguriert werden, die keine Benutzereingabe erfordert. Sie können Ihrem Agent auch anweisen, keine Anmeldeinformationen von Benutzern anzufordern.

Agenten können möglicherweise nicht jeden Connector erfolgreich ausführen. Wenn ein Agent wiederholt einen Connector nicht aufrufen kann, sollten Sie die Erstellung eines Power Automate Flow-Aktion das den problematischen Connector verwendet, um die Aktion abzuschließen.

Fehlerbehebung und Einschränkungen

Kontingentbeschränkungen

Wenn Trigger zu häufig aktiviert werden, verbraucht Ihr Agent möglicherweise mehr Ressourcen als erwartet. Ihr Agent könnte dann die Servicelast überschreiten Kontingentgrenzen, und Ihr Dienst könnte gedrosselt werden.

Administratoren können Überwachung der Ressourcennutzung durch Power Platform. Sie können außerdem die Verwendung von Ereignisauslösern in einem Umgebung blockieren.

So vermeiden Sie die Überschreitung von Kontingentgrenzen:

• Gehen Sie vorsichtig vor, wenn Sie sehr häufige Auslöser oder Auslöser hinzufügen, die sich unbegrenzt wiederholen. Beispielsweise wird eine Wiederholung Trigger immer dann aktiviert, wenn eine festgelegte Zeitspanne verstreicht. Je länger kleiner die Zeitspanne zwischen den Aktivierungen ist, desto mehr Ressourcen verwendet Trigger.
• Behalten Sie im Auge, wie viele Auslöser in einem Umgebung aktiv sind.

Trigger können nur Maker-Anmeldeinformationen verwenden

Derzeit können Ereignisauslöser nur die Anmeldeinformationen Agent Autor's zur Authentifizierung verwenden. Wenn Sie ein Agent mit authentifizierten Ereignisauslösern veröffentlichen oder Teilen, können Benutzer möglicherweise auf Informationen zugreifen oder das Agent auffordern, Aktionen unter Verwendung der Anmeldeinformationen des Autor auszuführen.

Um zu verhindern, dass Benutzer auf geschützte Daten oder Systeme zugreifen oder diese ändern, sollten Sie sorgfältig prüfen, ob und wie Daten und Systeme, die eine Authentifizierung erfordern, von Agenten mit Ereignisauslösern verwendet werden. Autoren sollten beim Teilen oder Veröffentlichen von Agenten, die Ereignisauslöser enthalten, vorsichtig sein.

Administratoren können Benutzer außerdem daran hindern Copilot Studio , Ereignisauslöser mit ihren Agenten zu verwenden. Weitere Informationen finden Sie unter Ereignisauslöser blockieren.

Einschränkungen bei der Verwendung von Wissensquellen mit Ereignisauslösern

Agenten können einige Wissensquellen in Antwort nicht auf ein Ereignis Trigger verweisen. Für einige Wissensquellen ist zur Authentifizierung beim Zugriff ein Agent erforderlich, Agenten können diese Authentifizierung jedoch nicht autonom bereitstellen.

Vermeiden Sie diese Wissensquellen, wenn in Antwort auf ein Ereignis Trigger verwiesen wird:

• SharePoint
• Dataverse
• Graph-Konnektoren
• AI Builder Eingabeaufforderungen

Verweisen Sie stattdessen auf diese Wissensquellen in Antwort auf ein Ereignis Trigger:

• Öffentliche Websites
• Hochgeladene Dateien
• Unternehmensdaten mithilfe von Konnektoren