Plug-In-Aktionen in Copilot Studio verwenden (Vorschau)

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Sie können die Fähigkeiten Ihres Copilot erweitern, indem Sie eine oder mehrere Plug-In-Aktionen hinzufügen. Plug-In-Aktionen werden von Ihrem Copilot verwendet, um mithilfe von generativen Aktionen automatisch auf Benutzer zu reagieren, oder Sie können sie explizit aus einem Thema heraus aufrufen.

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

Aktionstypen für das Kern-Plug-In

Plug-In-Aktionen basieren auf einem der folgenden Kernaktionstypen:

• Vorgefertigte Konnektoraktion
• Benutzerdefinierte Konnektoraktion
• Power Automate-Cloud-Flow
• Bot Framework-Skill

Wichtig

Sie können Konversations-Plug-Ins, die Sie in Copilot Studio erstellt haben als Plug-In-Aktionen verwenden.

Jede Kernaktion verfügt über zusätzliche Informationen, die ihren Zweck beschreiben, sodass der Copilot GPT zum Generieren von Fragen verwenden kann. Diese Fragen sind erforderlich, um die für die Durchführung der Aktion erforderlichen Eingaben auszufüllen. 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 Runtime für Sie erledigt.

Plugin-Aktionen können mithilfe der Ergebnisse der Aktion eine kontextbezogene Antwort auf die Anfrage eines Benutzers generieren. Alternativ können Sie explizit eine Antwort für die Plugin-Aktion verfassen.

Tipp

Wenn Sie generierte Fragen aus einer Plugin-Aktion verwenden, informieren Sie Ihre Benutzer darüber, dass ein Teil der Unterhaltung von 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.

Plug-In-Aktion hinzufügen

1. Öffnen Sie Ihren Copiloten, und wählen Sie im Navigationsbereich Themen und Plugins aus.

2. Wählen Sie + Erstellen aus.

3. Wählen Sie Plug-In-Aktion (Vorschauversion) aus.

   

4. Suchen Sie im jetzt Assistenten Aktion hinzufügen (Vorschau) nach einer Plug-In-Aktion, die Sie verwenden und auswählen möchten.

   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 Copilot registriert sind. Weitere Informationen finden Sie unter KI-Plug-Ins für Microsoft Copilot erstellen (Vorschau).

   

   Wichtig

   Einige aus KI-Plugins erstellte Plugin-Aktionen, wie z. B. dynamische Eingabeaufforderungen und solche, die auf Dataverse-APIs basieren, erfordern eine Authentifizierung.

5. Konfigurieren Sie die Verbindung für die Aktion.

   Je nach Plug-In wird Ihre Verbindung automatisch konfiguriert, wie im Beispiel gezeigt. Alternativ müssen Sie die Verbindung konfigurieren, wenn der Assistent Anweisungen dazu gibt. Sobald Ihre Verbindung erfolgreich konfiguriert wurde, wählen Sie Weiter aus.

   

6. Sie können jetzt Ihre Plugin-Aktionskonfiguration überprüfen und bei Bedarf Änderungen vornehmen. Wählen Sie Fertigstellen, um die Plug-In-Aktion zu Ihrem Copilot hinzuzufügen.

   

Plug-In-Aktion aufrufen

Wenn Sie generative Aktionen aktiviert haben, kann Ihre Plug-In-Aktion automatisch aufgerufen werden, um auf eine relevante Benutzeranfrage zu antworten.

Alternativ können Sie eine Plugin-Aktion explizit aus einem Thema heraus aufrufen.

Plug-In-Aktion testen

Stellen Sie Ihrem Copilot im Testchat eine relevante Frage. Sie können die Ansicht für den Chatbereich unten im Navigationsmenü umschalten (ein- oder ausblenden).

Ihr Copilot wählt Ihre Plug-In-Aktion basierend auf dem Namen und der Beschreibung aus und führt diese aus. Sie können hochwertige Beschreibungen verfassen und den dedizierten Ablaufverfolgungsmodus verwenden, um zu sehen, welche Plug-In-Aktionen Ihr Copilot ausgewählt hat, finden Sie auf der Seite Generative Aktionen.

Wenn Sie eine Plug-In-Aktion zu einem Thema hinzugefügt haben, können Sie diese alternativ testen, indem Sie eine Nachricht eingeben, die einer der Triggerausdrücke für dieses Thema ähnelt.

In diesem Screenshot können Sie sehen, wie eine Wetter-Plugin-Aktion getestet wird:

GPT-gesteuerte Unterhaltungen können flüssiger sein als traditionell verfasste Fragen. Benutzende können mehr als eine Frage auf einmal beantworten oder zuvor eingegebene Werte korrigieren.

In diesem Beispiel sehen Sie, dass der Copilot-Benutzende zunächst das Wetter für Orlando, FL überprüfen wollte, dann aber in der Bestätigungsphase angab, dass er seinen Standort in Seattle ändern wollte. Diese Änderung des Eingabewerts kann jederzeit erfolgen, nicht nur in der Bestätigungsphase.

Änderungen an der Konfiguration von Plug-In-Aktionen vornehmen

Es gibt viele Möglichkeiten, Ihre Plugin-Aktion zu konfigurieren. Im letzten Schritt des Plugin-Aktionsassistenten, Überprüfen und fertigstellen genannt, können Sie durch Klicken auf Bearbeiten neben dem entsprechenden Abschnitt Änderungen an der Konfiguration Ihrer Plug-In-Aktion vornehmen.

Aktivitätsdetails

Hier können Sie Details zu Ihrer Aktion konfigurieren, einschließlich Modell-Anzeigename und Modellbeschreibung für Ihre Plugin-Aktion. Normalerweise werden Name und Beschreibung basierend auf der von Ihnen ausgewählten Aktion vorab für Sie ausgefüllt.

Auf dieser Seite können Sie das Kontrollkästchen Benutzer vor Ausführung dieser Aktion fragen aktivieren. Dies ist nützlich für Aktionen, die Änderungen für einen Benutzenden vornehmen, wie etwa das Einfügen oder Aktualisieren eines Datensatzes in einer Tabelle.

Eingaben

Im Abschnitt Eingaben können Sie den Anzeigename und die Beschreibung für jede Eingabe Ihrer Aktion verwalten. Der Name und die Beschreibung helfen dem Copilot, eine Frage an den Benutzenden zu stellen. Eine generierte Frage für die im Beispiel gezeigte Standorteingabe könnte lauten: Für welchen Standort möchten Sie das Wetter abrufen? Sie können eine Stadt, eine Region, ein Bundesland, eine Land, eine Landmark oder eine Postleitzahl eingeben

Sie können die Option Identifizieren als für einen bestimmten Entitätstyp ändern, abhängig von der erfassten Eingabe, die dem Copilot dabei helfen kann, aus der Antwort eines Benutzenden einen Wert akurat zu extrahieren.

Standardmäßig ist jede Eingabe auf Dynamisch mit der besten Option füllen eingestellt. Der Copilot versucht, den Wert aus dem verfügbaren Kontext zu füllen, indem er beispielsweise einen Wert aus der Nachricht des Benutzenden extrahiert. 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. Ändern Sie zum Überschreiben das Dropdownmenü Wie füllt der Copilot diese Eingabe aus? in Als Wert festlegen und geben Sie dann einen Wert ein. Dieser Wert kann ein Literalwert, eine vorhandene Variable oder eine Power Fx-Formel sein.

Ausgaben

Standardmäßig ist Ihre Plugin-Aktion so konfiguriert, dass sie automatisch eine kontextbezogene Antwort für einen Benutzer generiert, basierend auf seiner Anfrage und dem Ergebnis der Aktion. 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 Ihre Plugin-Aktion zurückgeben 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.

Eine Plug-In-Aktion aus einem Thema aufrufen

Sie können eine Plug-In-Aktion explizit innerhalb eines Thema aufrufen, genau wie beim Aufrufen anderer Aktionstypen, z. B. Power Automate-Flows. Abhängig von Ihrem Anwendungsfall können Sie Ihren Flow als Teil eines umfassenderen Thema verwenden, das mehr Knoten verwendet. Oder, wie im Wetterbeispiel, könnte das Hinzufügen eines einzelnen Plug-In-Aktionsknotens zu einem Thema alles sein, was Sie brauchen.

So rufen Sie eine Plugin-Aktion aus einem Thema heraus auf:

1. Wechseln Sie in Microsoft Copilot Studio zur Themenseite für den Copilot, den Sie bearbeiten möchten.

2. Erstellen Sie ein neues Thema und benennen Sie es Wetter abrufen.

3. Fügen Sie folgende Triggerausdrücke hinzu:

   • Wird es regnen
   • Heutige Vorhersage
   • Wetter abrufen
   • Wie ist das Wetter

   

4. 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 Plug-In-Aktion Wettervorhersage abrufen aus.

   

5. Ihr Knoten Plug-In-Aktion (Vorschau) wird jetzt zu Ihrem Thema hinzugefügt.

   

6. Wählen Sie Speichern.

Eingaben überschreiben, wenn eine Plug-In-Aktion von einem Thema aufgerufen wird

Wenn Ihre Plug-In-Aktion ausgeführt wird, generiert Ihr Copilot standardmäßig Fragen für Benutzende, um die erforderlichen Eingaben auszufüllen. 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 Plug-In-Aktionskonfiguration im Abschnitt Eingaben überschreiben. Oder Sie überschreiben Werte möglicherweise nur, wenn Ihre Plug-In-Aktion von einem bestimmten Thema verwendet wird:

1. Wählen Sie auf dem Knoten Wert festlegen und die Eingabe aus, die Sie überschreiben möchten.

   

2. Geben Sie den Wert für die Eingabe ein, indem Sie einen Wert eingeben, eine Variable auswählen oder eine Formel verwenden.

   

Nachdem diese Eingabe nun außer Kraft gesetzt wurde, fragt der Copilot Benutzende nicht mehr nach einem Wert.

Authentifizierung für KI-Plug-Ins aktivieren

Einige aus KI-Plug-Ins erstellte Plug-In-Aktionen erfordern eine Authentifizierung, um ordnungsgemäß zu funktionieren, wie z. B. die dynamische Eingabeaufforderung, oder andere, bei denen eine Dataverse-API aufgerufen wird.

Plug-Ins werden immer in der Microsoft Copilot-Runtime im Endbenutzerkontext ausgeführt und können nur dann ausgeführt werden, wenn die Authentifizierung aktiviert wird. Zwei Typen von Authentifizierungsmethoden werden unterstützt:

• Integrierte Authentifizierung (Teams und Power Apps): Dieses Authentifizierungssetup kann verwendet werden, wenn sich Ihr Copilot im Teams-Kanal befindet. Das Setup funktioniert auch mit eingebetteten Copiloten in jeder Power Platform-App, die mit dem PPAPI-Standard erstellte Token verwendet.

• Manuelle Authentifizierung (Drittanbieter-Copilkoten): Zu dieser Authentifizierungsmethode gehört die Einrichtung einer Entra-ID-Verbindung.

Erstellen Sie eine Verbindung zur manuellen Authentifizierung:

1. Richten Seine eine Entra-ID-App ein.

2. Richten Sie die manuelle Authentifizierung auf Ihrem Copilot Studio-Copiloten ein.

3. 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.