Übersicht über Ereignisauslöser (Vorschauversion)

Sie können benutzerdefinierte Agenten so konfigurieren, dass sie Aktionen ausführen oder Themen aufrufen, wenn etwas mithilfe von Ereignisauslösern geschieht. Im Gegensatz zu Thementriggern, die Eingaben von einem Benutzer erfordern, ermöglichen Ereignistrigger Ihrem Agent, autonom als Reaktion auf das Eintreten des definierten Ereignisses zu handeln.

Funktionsweise von Ereignistriggern

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

Agenten handeln nur auf der Grundlage des Designs und der Anweisungen ihres Autors. Sie können beispielsweise einen Triggern für das Hinzufügen eines neuen Teammitglieds hinzufügen und die Antwort als die Aktion Dem neuen Mitarbeitenden eine Begrüßungsnachricht mit Onboarding-Ressourcen senden festlegen.

Ereignistrigger werden basierend auf Ereignissen außerhalb des Agenten aktiviert. Sie unterscheiden sich von Thementriggern, die zum Aktivieren von Themen oder Aktionen basierend auf von Benutzern eingegebenen Triggerphrasen verwendet werden.

In diesem Artikel werden die Funktionsweise von Ereignistriggern, ihre Einschränkungen und Strategien zur Problembehandlung erläutert. Weitere Informationen zum Hinzufügen eines Ereignisauslösers finden Sie unter Hinzufügen eines Ereignisauslösers.

Andere Beispiele für Ereignistrigger sind zum Beispiel:

• Erstellen eines Elements in SharePoint
• Erstellen einer Datei in OneDrive
• Erledigung einer Aufgabe im Planner
• Ablauf einer festgelegten Zeitspanne (ein Wiederholungstrigger)

Den Workflow auslösen

Ein Trigger ist ein Teil eines Workflows, der aus mehreren Teilen besteht:

1. Ein Ereignisauslöser registriert, dass ein bestimmtes Ereignis aufgetreten ist.
2. Der Trigger sendet Nutzdaten die Informationen über das Ereignis und Anweisungen enthalten.
3. Der Agent enthält Anweisungen zur Auswahl einer oder mehrerer Aktionen oder Themen je nach Nutzdaten.

Finden Sie den Auslöser, der zu Ihrem Ereignis 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 Triggerkonfiguration bestimmt die Parameter des Ereignisses, das den Trigger initiiert. Außerdem wird der Inhalt der Trigger-Nutzlast bestimmt.

Bei den meisten Triggern können Sie Parameter für das Ereignis angeben, das den Trigger aktiviert. Zum Beispiel wählen Sie im Trigger Wenn eine Zeile hinzugefügt, geändert oder gelöscht wird für Dataverse aus, welche Änderungen der Tabelle den Trigger aktivieren.

Triggernutzlast definieren

Die Triggernutzlast ist eine JSON- oder Nur-Text-Nachricht, die Informationen zu einem Ereignis enthält. Die Nutzdaten werden als Nachricht an Ihren Agenten gesendet. Wenn Sie einen Trigger hinzufügen, können Sie den Standardnutzlastinhalt für diesen Trigger beibehalten oder eigene Anweisungen hinzufügen. Später können Sie den Inhalt der Nutzen ändern und unter anderem Variablen und Zeichenfolgenoperatoren in Power Automate hinzufügen.

Die Standardmeldung im Trigger Wenn eine Zeile hinzugefügt, geändert oder gelöscht wird lautet z. B. Inhalt aus Body verwenden. Wenn der Agent die Nutzdaten empfängt, enthalten sie den Inhalt der Zeile und Anweisungen zur Verwendung dieses Inhalts.

Sie können Anweisungen hinzufügen, die an Ihren Agenten in den Nutzdaten gesendet werden und den Agenten anweisen, wie er sich verhalten soll, wenn er durch den Trigger aktiviert wird. Wenn Sie mehrere Trigger haben, kann jedes Triggernutzdatenpaket spezifische und detaillierte Anweisungen enthalten, ohne dass Sie lange und komplizierte Anleitungen in die allgemeinen Anweisungen des Agenten schreiben zu müssen oder ihn zu verwirren, welche Anweisungen für welchen Trigger gelten.

Beispielsweise können Sie in Triggernutzdaten Wenn eine Zeile hinzugefügt, geändert oder gelöscht wird die Anweisung Eine Zusammenfassung der Änderungen im Chat senden hinzufügen. Wenn der Agent die Nutzdaten empfängt, fasst er die Änderungen für den Benutzenden im Agenten-Chat zusammen.

Vermeiden Sie es jedoch, Nutzlastanweisungen zu schreiben, die mit den allgemeinen Anweisungen von Agent in Konflikt stehen. Konflikte in Anweisungen können zu Fehlern oder unerwarteten Ergebnissen führen. Stellen Sie sicher, dass Sie alle Änderungen testen, die Ereignisauslöser betreffen.

Nachdem Sie einen Trigger erstellt haben, können Sie Nutzdaten Variablen oder Zeichenfolgenoperatoren hinzufügen oder ändern und vorhandene Nutzdatenanweisungen mithilfe von Power Automate ändern.

Agent Anweisungen im Vergleich zu Nutzlastanweisungen

Nutzlastanweisungen sind spezifisch für die Reaktion auf ein Ereignis. Sie können auch Agent Anweisungen verwenden, um Ihre Agent anzuweisen, wie sie mit Informationen von einem Trigger umgehen und wie sie sich verhalten sollen, wenn sie eine Triggernutzlast empfangen, sowie um das allgemeine Verhalten Ihrer Agent zu bestimmen. Für eine Agent, die in neuen Dataverse Tabellenzeilen nach doppelten Kontonamen sucht, könnten die Anweisungen z. B. wie folgt lauten: Wenn eine neue Zeile hinzugefügt wird, überprüfen Sie, ob es sich um ein doppeltes Konto handelt. Wenn ein Duplikat vorhanden ist, erstellen Sie eine To-Do-Aufgabe, um sie zu untersuchen, und fügen Sie Details zu den Änderungen und Duplikaten hinzu.

Allerdings funktionieren Agent Anweisungen möglicherweise nicht für alle Situationen am besten. Wenn Ihr Agent mehrere Trigger oder mehrere komplexe Ziele hat, sollten Sie stattdessen die Anweisungen in der Trigger-Payload verwenden.

Wenn Sie das letzte Beispiel fortsetzen, können Sie in der Trigger-Payload eine Anweisung hinzufügen, um in derselben Tabelle nach doppelten Kontonamen zu Dataverse suchen. Wenn der Agent die Nutzlast empfängt, wird er angewiesen, nach doppelten Kontonamen zu suchen. In den allgemeinen Anweisungen der Agenten heißt es dann Erstelle eine To-do-Aufgabe, wenn es Duplikate gibt, um sie zu untersuchen, und füge Details zu den Änderungen und Duplikaten hinzu.

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

Eine Aktion oder ein Thema aufrufen

Wenn ein Agent eine Triggernutzlast empfängt, bestimmen die Anweisungen, die Sie ihm gegeben haben, die Aktion oder das Thema, die bzw. das er als Antwort aufruft. Ihre Anweisungen ermöglichen es Ihrem Agent, eine Aktion oder ein Thema basierend auf den verfügbaren Informationen auszuwählen.

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

Wenn Ihr Agent nicht wie erwartet reagiert, können Sie die Aktivitätskarte verwenden, um festzustellen, ob wichtige Eingabeinformationen fehlen.

Zu den Verbesserungen, die Sie an den Anweisungen vornehmen können, gehören:

• Hinzufügen detaillierterer Anweisungen in der Trigger-Payload oder Agent-Anweisungen Ihr Agent benötigen möglicherweise mehr Anweisungen, z. B. welche Informationen in einem bestimmten Eingabefeld für Aktionen verwendet werden sollen.
• Einfügen von Anweisungen in die Trigger-Payload.
• Ihren Agenten anweisen, eine bestimmte Aktion oder ein bestimmtes Thema aufzurufen.
• Auf widersprüchliche Anweisungen zwischen Triggernutzdaten und Agentenanweisungen überprüfen.
• Ergänzen Sie die Beschreibungen der Aktionen, damit der Agent mehr Informationen hat, um zu bestimmen, wann er aufgerufen werden soll.
• Beschreibungen zu den Aktionseingabefeldern hinzufügen, damit Ihre Agenten die Parameter korrekt ausfüllen können. Wenn die Eingaben einer Aktion jedes Mal gleich sind, können Sie den Wert selbst festlegen.
• Aufrufen von weniger als 15 Aktionen oder Themenbereichen nacheinander. Komplexe Agenten, die viele Aktionen oder Themenbereiche in einer einzigen Sequenz ausführen, können Probleme mit der zuverlässigen Ausführung bekommen.

Wenn Ihr Agent immer noch Schwierigkeiten mit der Ausführung der erwarteten Aktion hat, sollten Sie in Erwägung ziehen, einen Power Automate Flow, der Ihr Ziel erfüllt, als Aktion für Ihren Agenten hinzuzufügen.

Agenten mit Ereignistriggern veröffentlichen

Bevor Sie Ihren Agenten mit einem neuen Ereignistrigger veröffentlichen, reagiert er auf diesen Trigger nicht automatisch. Stellen Sie sicher, dass Sie den Agenten vor der Veröffentlichung gründlich testen, denn nachdem Sie einen Agenten mit einem neuen Trigger veröffentlicht haben, reagiert er automatisch jedes Mal, wenn seine Trigger aktiviert werden. Eine Schritt-für-Schritt-Aufzeichnung der Trigger und Reaktionen Ihres Agenten finden Sie auf der Seite Aktivität.

Informationen zum Aktivieren von Triggern während des Testens finden Sie unter Testen eines Triggers.

Ereignisauslöser können für den Trigger nur die Anmeldeinformationen des Agent-Autors für die Authentifizierung verwenden (d. h. die Anmeldeinformationen, mit denen Sie die Verbindungen autorisiert haben). Dies kann es Benutzenden eines Agenten erlauben, ihn zu verwenden, um mit eben dieser Autorisierung auf Daten und Systeme zuzugreifen. Weitere Informationen finden Sie unter Problembehandlung und Einschränkungen.

Authentifizieren von Aktionen nach der Veröffentlichung

Wenn bei Ihrem Agenten die Authentifizierung zum Ausführen einer Aktion fehlt oder er so konfiguriert ist, dass die Benutzerauthentifizierung angefordert wird, sendet er eine Nachricht an den Benutzenden und fordert ihn zur Eingabe von Anmeldeinformationen auf. 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 Sie möchten, dass Ihr Agent autonom läuft, muss jede Aktion mit einer funktionierenden Authentifizierung konfiguriert werden, die keine Benutzereingabe erfordert. Sie können Ihren Agenten auch anweisen, keine Anmeldeinformationen von Benutzenden anzufordern.

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

Problembehandlung und Einschränkungen

Kontingentgrenzen

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

Administrierende können die Ressourcennutzung über Power Platform überwachen. Sie können auch die Verwendung von Ereignisauslösern in einer Umgebung blockieren.

So vermeiden Sie eine Überschreitung der Kontingentgrenzen:

• Seien Sie vorsichtig, wenn Sie sehr häufige Trigger oder Trigger, die sich auf unbestimmte Zeit wiederholen, hinzufügen. Ein Serientrigger wird z. B. immer dann aktiviert, wenn eine bestimmte Zeitspanne verstrichen ist. Je kürzer die Zeitspanne zwischen den Aktivierungen ist, desto mehr Ressourcen verbraucht der Trigger.
• Verfolgen Sie, wie viele Trigger in einer Umgebung aktiv sind.

Trigger können nur Anmeldeinformationen des Herstellers verwenden

Derzeit können Ereignisauslöser nur die Anmeldeinformationen des Agent-Autors zur Authentifizierung verwenden. Wenn Sie einen Agenten mit authentifizierten Ereignistriggern veröffentlichen oder freigeben, können Benutzende möglicherweise auf Informationen zugreifen oder den Agenten auffordern, Aktionen mit den Anmeldeinformationen des Autors 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 sich dessen bewusst sein, wenn sie Agenten mit Ereignisauslösern freigeben oder veröffentlichen.

Administrierende können Copilot Studio-Benutzende auch daran hindern, Ereignistrigger mit ihren Agenten zu verwenden. Weitere Informationen finden Sie unter Blockieren von Ereignisauslösern.

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

Agenten können als Reaktion auf einen Ereignisauslöser nicht auf einige Wissensquellen verweisen. Für den Zugriff auf einige Wissensquellen ist eine Authentifizierung durch einen Agenten erforderlich, aber Agenten können diese Authentifizierung nicht autonom bereitstellen.

Vermeiden Sie diese Wissensquellen, wenn sie als Reaktion auf einen Ereignisauslöser referenziert werden:

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

Verweisen Sie stattdessen auf diese Wissensquellen als Reaktion auf einen Ereignisauslöser:

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