Aktionen mit benutzerdefinierten Agenten verwenden (Vorschauversion)
Sie können die Funktionen Ihres Agent erweitern, indem Sie eine oder mehrere Aktionen hinzufügen. Aktionen werden von Ihrem Agent verwendet, um Benutzern automatisch zu antworten, indem eine generative Orchestrierung verwendet wird, oder Sie können sie explizit innerhalb eines Thema aufrufen.
Hauptaktionstypen
Wenn Sie die generative Orchestrierung aktivieren, kann Ihr Agent automatisch Auswählen die am besten geeignete Aktion oder Thema ausführen oder im Wissen suchen, um einem Benutzer zu antworten.
Im klassischen Modus (generative Orchestrierung deaktiviert) kann ein Agent nur Themen verwenden, um dem Benutzer zu antworten. Sie können Ihr Agent jedoch weiterhin so gestalten, dass Aktionen explizit innerhalb von Themen aufgerufen werden.
Aktionen basieren auf einem der folgenden Hauptaktionstypen:
- Vorgefertigte Konnektoraktion
- Benutzerdefinierte Konnektoraktion
- Power Automate-Cloud-Flow
- AI Builder-Prompts
- Bot Framework-Fertigkeiten
Jede Kernaktion verfügt über zusätzliche Informationen, die ihren Zweck beschreiben, sodass der Agent Fragen mithilfe generativer KI generieren kann. Diese Fragen sind erforderlich, um die zum Ausführen der Aktion erforderlichen Eingaben vorzunehmen. Deshalb müssen Sie keine Frageknoten manuell erstellen, um alle benötigten Eingaben, wie etwa die Eingaben in einem Flow, zu sammeln. Eingaben werden zur Laufzeit für Sie verarbeitet.
Standardmäßig geben Aktionen im generativen Modus ihre Informationen an Agent zurück, sodass Agent ein kontextbezogenes Antwort zur Abfrage des Benutzers generieren kann. Alternativ können Sie Ihre Aktion anweisen, immer sofort zu antworten, entweder durch Generieren einer Nachricht oder durch Verfassen einer expliziten Nachricht.
Trinkgeld
Wenn Sie aus einer Aktion generierte Fragen verwenden, informieren Sie Ihre Benutzenden darüber, dass ein Teil der Unterhaltung durch KI generiert wird.
Fügen Sie dem Unterhaltung beginnen-Systemthema beispielsweise eine zusätzliche Nachricht hinzu. Dieses Thema bestimmt die Nachricht, die Ihren Benutzern angezeigt wird, wenn eine neue Unterhaltung beginnt.
Aktion hinzufügen
Öffnen Sie Ihr Agent, indem Sie im linken Navigationsbereich Agenten auswählen und Ihr Agent aus der Liste auswählen.
Auswählen Aktionen um Aktionen für Agent anzuzeigen.
Wählen Sie Aktion hinzufügen aus.
Suchen Sie im Assistenten Aktion auswählen nach einer Aktion, die Sie verwenden möchten, und Auswählen Sie sie.
Die angezeigte Standardliste enthält Power Automate-Flows und benutzerdefinierte Connectors, die in Ihrer Umgebung verfügbar sind. Diese Liste enthält häufig verwendete vorgefertigte Konnektoren und Bot Framework Skills, die bei Ihrem Agent registriert sind.
Wichtig
Einige Aktionen, die aus KI-Plug-Ins erstellt wurden, wie z. B. dynamische Prompts und solche, die auf Dataverse-APIs basieren, erfordern eine Authentifizierung.
Je nach Aktion wird, wie im Beispiel gezeigt, Ihre Verbindung automatisch konfiguriert. Andernfalls folgen die Anweisungen des Assistenten zum Konfigurieren der Verbindung. Sobald Ihre Verbindung erfolgreich konfiguriert wurde, wählen Sie Weiter aus.
Überprüfen Sie Ihre Plug-In-Aktion-Konfiguration und nehmen Sie bei Bedarf Änderungen vor .
Wählen Sie Weiter.
Auswählen Fertig , um die Aktion zu Ihrem Agent hinzuzufügen.
Aktion testen
Wenn Sie die generative Orchestrierung aktiviert haben, wird Ihre Aktion in Antwort automatisch bei einer entsprechenden Benutzerabfrage aufgerufen.
Alternativ können Sie eine Aktion explizit innerhalb eines Thema aufrufen.
Ihr Agent wählt Ihre Aktion basierend auf dem Namen und der Beschreibung aus und führt sie aus. Sie können Autor qualitativ hochwertige Beschreibungen verwenden, um mithilfe von Aktivitätenkarte zu sehen, welche Aktionen Ihr Agent auf der Seite Aktionen ausgewählt hat.
In diesem Screenshot können Sie sehen, wie eine Wetteraktion getestet wird:
Änderungen an der Konfiguration von Plug-In-Aktionen vornehmen
Es gibt viele Möglichkeiten, Ihre Aktion zu konfigurieren. Im letzten Schritt des Aktionsassistenten, genannt Überprüfen und fertigstellen, können Sie Änderungen an der Konfiguration Ihrer Aktion vornehmen, indem Sie neben dem entsprechenden Abschnitt auf Bearbeiten klicken. Sie können die Eingabe- und Ausgabeparameter für die Aktion entweder auf dem Bildschirm Ein- und Ausgaben überprüfen im Assistenten oder auf der Detailseite einer Aktion, die bereits Teil Ihres Agent ist, verwalten.
Aktivitätsdetails
Hier können Sie Details zu Ihrer Aktion, einschließlich des Modellanzeigename und der Modellbeschreibung für Ihre Aktion, konfigurieren. Normalerweise werden Name und Beschreibung basierend auf der von Ihnen ausgewählten Aktion vorab für Sie ausgefüllt.
Die Eigenschaften Anzeigename und Beschreibung für jede Eingabe helfen dem Agent, den Zweck der Eingabe zu verstehen, eine geeignete Frage für den Benutzer zu generieren und den richtigen Wert im Antwort eines Benutzers zu erkennen. Nachfolgend sehen Sie beispielsweise den Standardname und die Standardbeschreibung des Standorteingabeparameters für den MSN Wetter-Connector.
- Name: Standort
- Beschreibung: Der Standort der Suchabfrage. Gültige Eingaben sind Ort, Region, Bundesland, Land, Orientierungspunkt, Postleitzahl, Breiten- und Längengrad
Wenn Agent den Benutzer zur Eingabe eines Standorts auffordert, wird eine Frage wie diese generiert: Für welchen Standort möchten Sie das Wetter prüfen? Sie können eine Stadt, eine Region, ein Bundesland, ein Land, Landmark oder eine Postleitzahl eingeben.
Sie können die Option Identifizieren als je nach erfasster Eingabe in einen bestimmten Entitätstyp ändern. Dies kann Agent dabei helfen, einen Wert präzise aus dem Antwort eines Benutzers zu extrahieren.
Eingaben
Standardmäßig ist jede Eingabe auf Dynamisch mit der besten Option füllen eingestellt. Agent versucht, den Wert aus dem verfügbaren Kontext zu extrahieren, beispielsweise aus der Nachricht des Benutzers. Wenn kein passender Wert gefunden wird, wird eine Frage generiert, um den Benutzer nach einem Wert zu fragen. Sie können eine Eingabe mit einem Wert überschreiben, anstatt den Benutzenden zu fragen. Um eine Überschreibung festzulegen, wählen Sie für Wie füllt Agent diese Eingabe aus? Auswählen Als Wert festlegen und geben Sie den gewünschten Wert ein. Dieser Wert kann ein Literalwert, eine vorhandene Variable oder eine Power Fx-Formel sein.
Um das Verhalten Ihres Agent beim Anfordern eines Werts oder beim Validieren einer Benutzerantwort zu steuern, können Sie zusätzliche Einstellungen für Eingaben konfigurieren.
Ausgaben
Standardmäßig ist Ihre Aktion so konfiguriert, dass für einen Benutzenden ausgehend von seiner Abfrage und dem Ergebnis der Aktion automatisch eine kontextbezogene Antwort generiert wird. Wenn ein Benutzer beispielsweise fragt: „Wie hoch ist die aktuelle Temperatur in London?“, wird mithilfe von GPT eine kontextbezogene Antwort generiert, z. B. „Die aktuelle Temperatur in London beträgt 9 Grad Celsius“.
Alternativ können Sie eine bestimmte Antwort verfassen, die von Ihrer Aktion zurückgegeben werden soll. Wie beim Bestätigungseditor können Sie mithilfe der Variablenauswahl Verweise auf Ausgabevariablen von der Aktion einfügen, wie beispielsweise in diesem Beispiel gezeigt.
Rufen Sie eine Aktion innerhalb eines Thema auf
Ähnlich wie beim Aufrufen anderer Aktionstypen wie Power Automate-Flows können Sie eine Aktion explizit aus einem Thema aufrufen. Abhängig von Ihrem Anwendungsfall können Sie Ihren Flow als Teil eines umfassenderen Thema verwenden, das mehr Knoten verwendet. Vielleicht reicht wie im Wetterbeispiel möglicherweise schon das Hinzufügen eines einzelnen Aktionsknotens zu einem Thema.
Um eine Aktion aus einem Thema aufzurufen:
Gehen Sie in Copilot Studio zur Seite Themen für das Agent, das Sie bearbeiten möchten.
Erstellen Sie ein neues Thema und benennen Sie es Wetter abrufen.
Fügen Sie folgende Triggerausdrücke hinzu:
- Wird es regnen
- Prognose für heute
- Wetter abrufen
- Wie ist das Wetter
Wählen Sie Knoten hinzufügen (+) und dann Eine Aktion aufrufen aus. Wechseln Sie zur Registerkarte Plug-in-Aktionen (Vorschau) und wählen Sie dann die zuvor erstellte Aktion Wettervorhersage abrufen aus.
Ihr Knoten Plug-In-Aktion (Vorschau) wird jetzt zu Ihrem Thema hinzugefügt.
Wählen Sie Speichern.
Eingaben überschreiben, wenn eine Aktion von einem Thema aufgerufen wird
Wenn Ihre Aktion ausgeführt wird, generiert Ihr Agent standardmäßig Fragen für den Benutzer, um die erforderlichen Eingaben zu machen. Sie möchten jedoch möglicherweise eine oder mehrere Eingaben außer Kraft setzen und einen expliziten Wert bereitstellen, anstatt den Benutzenden zu fragen. Sie können dies in der Konfiguration der Plug-In-Aktion im Abschnitt Eingaben überschreiben. Alternativ können Sie Werte nur überschreiben, wenn Ihre Aktion von einem bestimmten Thema verwendet wird:
Wählen Sie auf dem Knoten Wert festlegen und die Eingabe aus, die Sie überschreiben möchten.
Geben Sie den Wert für die Eingabe ein, indem Sie einen Wert eingeben, eine Variable auswählen oder eine Formel verwenden.
Da diese Eingabe nun überschrieben ist, fragt Agent den Benutzer nicht mehr nach einem Wert.
Die Authentifizierung bei KI-Aktionen aktivieren
Einige Aktionen, die auf KI-Aktionen basieren, funktionieren nur mit einer Authentifizierung, wie ein dynamischer Prompt oder andere, die eine Dataverse-API aufrufen, korrekt.
Aktionen werden immer in der Laufzeit von Agent im Endbenutzerkontext ausgeführt und können nur ausgeführt werden, wenn die Authentifizierung aktiviert ist. Zwei Typen von Authentifizierungsmethoden werden unterstützt:
Gehen Sie zu den Eigenschaften der Connector-Aktion.
Unter Endbenutzerauthentifizierung, Auswählen Agent Autor-Authentifizierung.
Veröffentlichen und testen Sie das Erlebnis im Testbereich Agent oder in einem gewünschten Kanal.
Flow-Aktionen mit Anmeldeinformationen von Endbenutzenden verwenden
Flow-Aktionen können so konfiguriert werden, dass sie die Anmeldeinformationen der Endbenutzenden verwenden. Die Verwendung eines Flows in einem unterstützten Kanal erfordert keine spezielle Konfiguration in Ihrem Agent-Dialog und Benutzer können ihre Verbindungen für einen bestimmten Flow in einer bereitgestellten Erfahrung verwalten.
Authentifizierung für Aktionen basierend auf Plug-Ins in Ihrer Bibliothek
Wenn Aktionen auf Basis von KI-Plug-Ins erstellt werden, ist eine Authentifizierung erforderlich, damit sie ordnungsgemäß funktionieren. Dies ist am häufigsten bei Aktionen zu beobachten, die auf Prompts basieren, oder anderen, die Dataverse-APIs aufrufen. Auf Plug-Ins basierende Aktionen werden immer im Benutzerkontext ausgeführt und können nur ausgeführt werden, wenn die Authentifizierung aktiviert ist. Zwei Typen von Authentifizierungsmethoden werden unterstützt:
Integrierte Authentifizierung (Teams und Power Apps) : Sie können diese Authentifizierungsmethode verwenden, wenn Sie Ihr Agent in einem Teams-Kanal veröffentlichen möchten. Diese Methode funktioniert auch für Agenten, die in beliebige Power Platform App, die mit dem PPAPI-Standard erstellte Token verwendet.
Manuelle Authentifizierung (Agenten von Drittanbietern): Bei dieser Authentifizierungsmethode wird eine Microsoft Entra ID-Verbindung eingerichtet.
Erstellen Sie eine Verbindung zur manuellen Authentifizierung:
Richten Sie eine Microsoft Entra ID-App ein.
Richten Sie eine manuelle Authentifizierung für Ihr Agent ein.
Erlauben Sie Ihrer App, die Delegation zu verwenden, um ein Token im Auftrag des Benutzenden abzurufen. Stellen Sie sicher, dass Sie alle erforderlichen Bereiche hinzufügen.
