Aktionen mit benutzerdefinierten Copiloten in Copilot Studio verwenden (Vorschauversion)

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 Copiloten durch das Hinzufügen einer oder mehrerer Aktionen erweitern. Ihr Copilot verwenden Aktionen, um Benutzenden automatisch zu antworten. Dazu werden generative Aktionen verwendet oder Sie können sie explizit aus einem Thema heraus aufrufen.

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

Hauptaktionstypen

Wenn Sie den generativen Modus aktivieren, kann Ihr Copilot automatisch die am besten geeignete Aktion oder das passendste Thema auswählen, um Benutzenden zur Laufzeit zu antworten.

Im klassischen Modus kann ein Copilot nur Themen verwenden, um Benutzenden zu antworten. Sie können Ihren Copiloten jedoch weiterhin so gestalten, dass er Aktionen explizit aus Themen aufruft.

Aktionen basieren auf einem der folgenden Hauptaktionstypen:

• Vorgefertigte Konnektoraktion
• Benutzerdefinierte Konnektoraktion
• Power Automate-Cloud-Flow
• AI Builder-Prompts
• Bot Framework-Fertigkeiten

Wichtig

Sie können in Copilot Studio erstellte Unterhaltungsaktionen bei benutzerdefinierten Copiloten nicht als Aktionen verwenden.

Zu jeder Hauptaktion gibt es zusätzliche Informationen, die ihren Zweck beschreiben, sodass der Copilot mithilfe generativer KI Fragen generieren 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.

Aktionen können mithilfe der Ergebnisse der Aktion eine kontextbezogene Antwort auf die Abfragen von Benutzenden generieren. Alternativ können Sie explizit eine Antwort für die Aktion verfassen.

Tipp

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

1. Öffnen Sie Ihren benutzerdefinierten Copiloten durch Auswahl von Copiloten im linken Navigationsbereich und wählen Sie Ihren Copiloten aus der Liste aus.

2. Wählen Sie Aktionen, um Aktionen für den Copiloten anzuzeigen.

3. Wählen Sie + Aktion hinzufügen

4. Suchen Sie im Assistenten Eine Aktion auswählen (Vorschau) nach der gewünschten Aktion und wählen Sie sie aus.

   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.

   

   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. Alternativ müssen Sie die Verbindung konfigurieren, wenn der Assistent Anweisungen dazu gibt. Sobald Ihre Verbindung erfolgreich konfiguriert wurde, wählen Sie Weiter aus.

   

5. Sie können jetzt Ihre Plugin-Aktionskonfiguration überprüfen und bei Bedarf Änderungen vornehmen. Wählen Sie Fertigstellen aus, um die Aktion Ihrem Copiloten hinzuzufügen.

   Wählen Sie Weiter.

Eine Aktion aufrufen

Wenn Sie generative Aktionen aktiviert haben, wird Ihre Aktion automatisch als Antwort auf eine entsprechende Benutzerabfrage aufgerufen.

Alternativ können Sie eine Aktion explizit von einem Thema aus aufrufen.

Aktion testen

Eine Aktion aufrufen

Ihr Copilot wählt Ihre Aktion anhand des Namens und der Beschreibung aus und führt sie aus. Sie können qualitativ hochwertige Beschreibungen verfassen und den speziellen Nachverfolgungsmodus verwenden, um zu sehen, welche Aktionen Ihr Copilot von der Seite Generative Aktionen ausgewählt hat.

Alternativ können Sie sie, wenn Sie eine zu einem Thema hinzugefügt haben, testen, indem Sie eine Nachricht eingeben, die einen der Triggerausdrücke für dieses Thema ähnelt.

In diesem Screenshot können Sie sehen, wie eine Wetteraktion getestet wird:

Wenn Sie alternativ einem Thema eine Aktion hinzugefügt haben, können Sie es testen, indem Sie Ihr Thema mit einem geeigneten Triggerausdruck auslösen.

Ein- und Ausgaben für eine Aktion konfigurieren

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

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 die einzelnen Eingaben helfen dem Copiloten, den Zweck der Eingabe zu verstehen, eine geeignete Frage für Benutzende zu generieren und den richtigen Wert in der Antwort von Benutzenden 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 der Copilot die Benutzenden nach einem Standort fragt, generiert er eine Frage wie diese: Für welchen Standort möchten Sie das Wetter wissen? Sie können eine Stadt, eine Region, ein Bundesland, ein Land, einen Orientierungspunkt 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.

Um das Verhalten Ihres Copiloten bei der Abfrage eines Werts oder der Validierung einer Benutzerantwort zu steuern, können Sie zusätzliche Eigenschaften 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.

Eine Aktion aus einem Thema aufrufen

Ä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:

1. Gehen Sie in Copilot Studio zur Themenseite für den Copiloten, 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 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 Aktion von einem Thema aufgerufen wird

Wenn Ihre Aktion ausgeführt wird, generiert Ihr Copilot standardmäßig Fragen für die Benutzenden, um die erforderlichen Eingaben vorzunehmen. 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:

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.

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 Microsoft Copilot-Laufzeit im Endbenutzerkontext ausgeführt und können nur ausgeführt werden, wenn die Authentifizierung aktiviert ist. Zwei Typen von Authentifizierungsmethoden werden unterstützt:

1. Gehen Sie zu den Eigenschaften der Connector-Aktion.

2. Wählen Sie unter Endbenutzerauthentifizierung die Option Copilot-Autorenauthentifizierung aus.

3. Veröffentlichen und testen Sie die Erfahrung im Copilot-Testbereich 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. Wenn Sie den Flow in einem unterstützten Kanal verwenden, ist in Ihrem Copilot-Dialog keine spezielle Konfiguration erforderlich und Endbenutzende können ihre Verbindungen für einen bestimmten Flow in einer bereitgestellten Umgebung 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 Endbenutzerkontext 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 Ihren Copiloten in einem Teams-Kanal veröffentlichen möchten. Diese Methode funktioniert auch für Copiloten, die in eine beliebige Power Platform App eingebettet sind, die mit dem PPAPI-Standard erstellte Token verwendet.

• Manuelle Authentifizierung (Drittanbieter-Copiloten): Bei dieser Authentifizierungsmethode wird eine Microsoft Entra ID-Verbindung eingerichtet.

Erstellen Sie eine Verbindung zur manuellen Authentifizierung:

1. Richten Sie eine Microsoft Entra ID-App ein.

2. Richten Sie die manuelle Authentifizierung für Ihren Copilot Studio-Copiloten.

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.