Microsoft 365 Copilot oder Copilot-Agenten mit Connector-Aktionen erweitern (Vorschauversion)

Mit Konnektoraktionen können Sie Connectors festlegen, die von KI-Oberflächen in Power Platform aufgerufen werden können. Für Konnektoraktionen müssen Sie die für die Verwendung im Copiloten aktivierten Aktionen angeben. Sie können auch die Informationen erfassen, die große Sprachmodelle benötigen, um das Plug-In effektiv zu identifizieren und zu nutzen, z. B. Zusammenfassungs- und Beschreibungsfelder.

Anforderungen

Um Copilot-Erfahrungen der Marke Microsoft mit Konnektoraktionen zu erweitern, müssen einige Voraussetzungen erfüllt sein.

Allgemeine Voraussetzungen

Sie müssen für alle Copilot-Typen über Anmeldeinformationen auf Erstellenden-Ebene, eine Copilot-Lizenz und eine Microsoft Teams-Lizenz verfügen.

[! HINWEIS] Aktionen wurden früher auch als Plugins bezeichnet. Diese Aktionen können in Agenten verwendet werden. Zuvor erstellte Plug-Ins haben sich nun zu Agenten weiterentwickelt. Weitere Informationen finden Sie im Microsoft 365 Copilot-Blog.

Microsoft 365 Copilot Vertrieb Agent und Microsoft 365 Copilot Service Agent Voraussetzungen

Für Microsoft 365 Copilot-Service-Agenten und Microsoft 365 Copilot-Vertriebsagenten müssen Sie bei einer Umgebung angemeldet sein, die den Agenten enthält, den Sie erweitern möchten.

Voraussetzungen für einen Microsoft 365 Copilot-Vertriebsagenten

• Salesforce-Kundschaft muss bei ihrer Dataverse-Umgebung angemeldet sein. Diese Umgebung wird in der Regel msdyn_viva genannt.
• Sie müssen sich vor der Erweiterung bereits mindestens einmal über Outlook bei dem Microsoft 365 Copilot-Vertriebsagenten in der Umgebung angemeldet haben, den Sie erweitern möchten.

Konnektoraktion hinzufügen

Um eine Konnektoraktion zu einem Copiloten der Marke Microsoft hinzugefügt zu werden, müssen einige Schritte ausgeführt werden. Die folgenden Abschnitte enthalten Anleitungen zum Hinzufügen einer Connector-Aktion zu Microsoft 365 Copilot, Microsoft 365 Copilot für Vertrieb und Microsoft 365 Copilot für den Service.

Den Agenten und die Connector-Aktion auswählen

1. Wählen Sie auf der Startseite Agenten aus.

   

2. Wählen Sie in der Liste der Agenten in der linken Navigation den Copilot-Agenten aus, den Sie erweitern möchten.

   

   Die Übersichtsseite für den Agenten wird angezeigt.

3. Wählen Sie die Registerkarte Aktionen aus, um eine Liste der bereits im Copilot vorhandenen Aktionen anzuzeigen.

4. Wählen Sie als Nächstes + Aktion hinzufügen aus.

   Sie erhalten eine Liste aller unterstützten Aktionstypen für den Copilot-Agenten.

   

5. Wählen Sie Connector zum Erweitern mit einer Konnektoraktion aus.

   Die Seite Ihren Connector auswählen wird angezeigt. Ihnen wird eine Liste verfügbarer Connector-Typen zur Auswahl angezeigt.

   Konnektoren verbinden Copiloten mit verschiedenen Services. Die Liste umfasst alle von Microsoft angebotenen zertifizierten Connectors.

   Je nach Copilot kann die Liste auch benutzerdefinierte Connectors enthalten, die in der aktuellen Umgebung vorhanden sind. Mithilfe einer Suchleiste können Sie den Connector, den Sie verwenden möchten, leichter finden.

   Anmerkung

   Derzeit können keine benutzerdefinierten Connectors zu Microsoft 365 Copilot-Service-Agenten hinzufügen.

Wählen Sie den Connector-Typ und dann eine Lösung aus

1. Suchen Sie Ihren Konnektor mithilfe der Suchleiste und wählen Sie ihn aus.

   

   Die Seite Eine benutzerdefinierte KI-Aktion mit Ihrem Connector erstellen wird angezeigt.

2. Geben Sie einen Namen und eine Beschreibung für Ihren Konnektor ein.

   Der Konnektorname muss eindeutig sein. Standardmäßig wird der Name des ausgewählten Konnektortyps übernommen. Sie sollten weitere definierende Informationen hinzufügen, um sicherzustellen, dass sowohl der Name eindeutig als auch für zukünftige Benutzende leicht zu erkennen ist, was die Aktion tut. Erwägen Sie, in die Beschreibung die zulässigen Aktionstypen aufzunehmen, z. B. „Mail-Dienst – ermöglicht das Abrufen und Erstellen von Nachrichten“.

   

   Die Beschreibung wird möglicherweise bereitgestellt, wenn sie in dem von Ihnen ausgewählten Connector vorhanden ist. Die Beschreibung wird von Copilot-Agent verwendet, um anzugeben, wann die Aktion verwendet werden kann, um Antworten auf die Benutzeranforderung zu erhalten. Gestalten Sie die Beschreibung so detailliert und beschreibend wie möglich. Geben Sie spezifische Details an und verwenden Sie dabei die Begriffe, welche die Benutzenden Ihrer Erwartung nach beim Aufrufen der Aktion verwenden. Um mit dem Beispiel für den E-Mail-Dienst fortzufahren, könnten Sie Folgendes einfügen:

   „Der Mail-Dienst bietet die Möglichkeit, Listen vorhandener Nachrichten zu erstellen, Ordner abzurufen, in denen Nachrichten gespeichert sind, Titel von Nachrichten und Ordnern auflisten zu lassen, Nachrichten abzurufen, Nachrichtentitel und -texte zu aktualisieren und Prioritäten für Nachrichten festzulegen.“

   Die Beschreibung teilt dem Copilot-Agent mit, dass er die Aktion verwenden soll, ohne explizit angewiesen zu werden, was eine natürlichere Spracherfahrung ermöglicht.

3. In der Dropdownliste sind alle in der aktuellen Umgebung verfügbaren Lösungen aufgelistet. Wählen Sie die Lösung aus, die Sie nutzen möchten. Weitere Informationen dazu, was bestimmte Lösungen sind und welche Vorteile sie Ihnen bieten, finden Sie unter Lösungskonzepte.

   

   Wenn Sie eine bevorzugte Lösung haben oder der ausgewählte Connector bereits in der Lösung enthalten ist, wird diese Lösung automatisch ausgewählt. Sie können entweder eine Lösung auswählen oder das Feld leer lassen. Wenn Sie die Lösung leer lassen, wird für Sie eine Lösung mit Aktionsname und Standardherausgeber erstellt. Wenn Sie Ihre Aktion in einer Lösung speichern, können Sie sie problemlos zwischen Umgebungen verschieben.

   Anmerkung

   Die Standardlösung oder CDS-Standardlösung wird Ihnen in diesem Fall nicht als Option angezeigt, da wir zur einfacheren Handhabung eine benutzerdefinierte Lösung empfehlen. Weitere Informationen finden Sie unter Standardlösung vs. benutzerdefinierte Lösung.

4. Wählen Sie eine Lösung und dann Weiter aus.

   Die Seite Ihre Plug-In-Aktion auswählen und konfigurieren wird angezeigt. Auf dieser Seite werden alle Aktionen angezeigt, die dem Konnektor hinzugefügt werden können. Sie können jede Aktionen auswählen und konfigurieren, die Ihr Copilot unterstützen soll, allerdings immer nur eine auf einmal. Mithilfe einer Suchleiste können Sie die Aktion, die Sie auswählen möchten, leichter finden. Die Anzahl der Aktionen, die Sie für den Connector auswählen können, ist nicht begrenzt.

   

Aktionen zum Connector hinzufügen

Als Nächstes müssen Sie aus den verfügbaren Aktionen diejenigen auswählen, die Sie dem Connector hinzufügen möchten.

1. Wählen Sie, um fortzufahren, eine Aktion aus. Die Seite Ihre Plug-In-Aktion konfigurieren wird für die ausgewählte Aktion angezeigt.

   

2. Geben Sie einen Namen und eine Beschreibung für Ihre Aktion an. In diesem Fall muss der Name nicht eindeutig sein. Diese Werte werden höchstwahrscheinlich vom Connector für Sie ausgefüllt. Wie bei der Beschreibung des Connectors sollten Sie jedoch eine detaillierte Beschreibung bereitstellen, damit der Agent weiß, wann die jeweilige Aktion aufgerufen werden muss. Dank der Beschreibung kann bei der Auswahl der auszuführenden Aktion mit natürlicher Sprache gearbeitet werden. Wenn die Aktion beispielsweise „Nachrichtenordner auflisten“ lautet, könnten Sie Folgendes verwenden:

   „Mit ‚Nachrichtenordner auflisten‘ können Sie vom E-Mail-Dienst eine Liste aller verfügbaren Nachrichtenordner abrufen. Diese Aktion ruft alle Ordner ab, legt sie in die Listenansicht und gibt sie an Sie zurück.“

   Die Aktionsbeschreibung liefert die Kontexthinweise „Nachrichtenordner auflisten“, „abrufen“, „alle“, „auflisten“, „Mail-Dienst“, „zurückgeben“, „Ordner“ und „anzeigen“. Anhand dieser Kontexthinweise kann Ihr Copilot erkennen, wann die Aktion für eine Benutzeranforderung die richtige ist.

3. Nachdem Sie diese Seite ausgefüllt haben, wählen Sie Weiter aus. Die Seite Parameter Ihrer Aktion überprüfen wird angezeigt.

4. Klicken Sie dazu auf Weiter.

   Mit dieser Aktion gelangen Sie zurück zur Seite Ihre Plug-In-Aktion auswählen und konfigurieren. Die neue Aktion, die Sie ausgewählt haben, wird angezeigt.

   

5. Wählen Sie eine andere Aktion aus und wiederholen Sie bei Bedarf die vorherigen Schritte zur Aktionskonfiguration.

   Wählen Sie alternativ Weiter aus. Die Anzeige Überprüfen, testen und veröffentlichen Sie Ihre Aktion wird angezeigt.

   

   Auf der Seite Aktion testen, überprüfen und veröffentlichen werden die Details aller bisherigen Konfigurationsschritte angezeigt. Sie können sie überprüfen und Ihre Aktion dann vor der Veröffentlichung testen.

Test

Nachdem Sie die Konnektoraktion konfiguriert haben, können Sie sie jetzt testen.

1. Wählen Sie Ihre bestehende Verbindung aus der Dropdownliste aus oder erstellen Sie eine + Neue Verbindung, wenn Sie keine Verbindung haben.

   Wenn Sie + Neue Verbindung auswählen, öffnet sich ein Assistent, in dem Sie Details eingeben können, um die Verbindung herzustellen. Wenn Sie fertig sind, können Sie die neue Verbindung aus der Dropdownliste auswählen.

2. Wenn Sie eine Verbindung ausgewählt haben, wählen Sie Aktion testen.

3. Wenn Sie eine Meldung sehen, dass die Aktion zum Testen bereit ist, wählen Sie Zum Testen öffnen aus, um den Copilot-Chat in einem neuen Fenster zu öffnen. Öffnen Sie das Flyout, um die Aktion anzuzeigen und zu aktivieren.

   Die Aktion wird mit einem Becherglassymbol unter dem ausgewählten Connector im Format Testen-Aktionsname angezeigt.

4. Sie können das Plug-In jetzt testen, indem Sie die Prompts ausprobieren, die Benutzende voraussichtlich verwenden. Sie können auch den Befehl –developer on verwenden, um bei der Prompt-Ausführung weitere Informationen zu erhalten. Wenn Sie mit den Ergebnissen zufrieden sind, kehren Sie zum Copilot Studio-Fenster zurück.

Veröffentlichen

1. Wenn Sie mit dem Testen fertig sind, wählen Sie Veröffentlichen.

   Es erscheint eine Seite, die anzeigt, dass Ihr Konnektor gerade veröffentlicht wird. Anschließend wird eine Seite angezeigt, die angibt, dass Konnektor veröffentlicht wurde.

2. Wählen Sie Zur Seite „Details“ wechseln aus, um die Details des veröffentlichten Konnektors anzuzeigen.

   Anmerkung

   Nachdem Ihr Connector veröffentlicht wurde, muss es durch eine Administrationsfachkraft aktiviert werden, bevor es im Copiloten verwendet werden kann. Wenn der Connector nicht im Copilot angezeigt wird, stellen Sie sicher, dass der Connector über das Microsoft Admin Center oder die Copilot-Agents-Seite aktiviert ist. Nach der ordnungsgemäßen Aktivierung wird der Connector im Flyout angezeigt. Bei diesem Schritt kann bei der ersten Ausführung eine Verzögerung von bis zu 24 Stunden auftreten.

3. Sie können eine Aktion mithilfe eines Konnektors auch problemlos von einer Umgebung in eine andere verschieben. Wählen Sie dazu auf der Seite „Details“ Lösung exportieren aus. Durch das Exportieren der Lösung können Sie den Konnektor exportieren.

   

4. Ändern Sie bei Bedarf die Versionsnummer und wählen Sie aus, ob die Lösung Verwaltet oder Nicht verwaltet werden soll.

   • Verwaltet bedeutet, dass Sie voraussichtlich keine weiteren Änderungen an der Lösung vornehmen müssen.
   • Nicht verwaltet bedeutet, dass Sie Änderungen an der Lösung in der Zielumgebung vornehmen möchten.

5. Nach Abschluss wird eine grüne Meldung mit der Option zum Herunterladen der Lösung angezeigt, die dann als ZIP-Datei in Ihrem System gespeichert wird.

   Anmerkung

   Sie müssen im Lösungsbereich nicht die Option Veröffentlichen auswählen.

6. Kehren Sie zur Seite Aktionen des Agenten in Copilot Studio zurück und wählen Sie Lösung importieren in der Zielumgebung aus.

   

7. Navigieren Sie zum Auswählen zu der ZIP-Datei für Ihre exportierte Lösung und wählen Sie Weiter, um fortzufahren. Der Connector wird in der Liste Aktionen angezeigt.

Konnektoraktion löschen

Wenn Sie eine Konnektoraktion löschen müssen, gehen Sie wie folgt vor.

Von der Konnektoraktion verwendete Lösung suchen

Das Verfahren zum Löschen einer Konnektoraktion wird im Power Apps Maker Portal durchgeführt. Sie benötigen jedoch die Lösung, die für die Konnektoraktion verwendet wird, in Copilot Studio.

1. Öffnen Sie Copilot Studio.

2. Wählen Sie die Umgebung aus, die zum Erstellen der Konnektoraktion verwendet wird.

3. Wählen Sie unter Agenten den Agenten aus, in dem die Connector-Aktion erstellt wurde.

4. Wählen Sie die Registerkarte Aktionen aus, um die Liste der Aktionen anzuzeigen, die dem Agent zugeordnet sind.

5. Wählen Sie die Aktion aus, die Sie löschen möchten, und notieren Sie sich den Namen der Lösung.

   

Konnektor im Power Apps Maker Portal löschen

1. Wechseln Sie zum Maker Portal (https://make.powerapps.com), und wählen Sie die Umgebung aus, die Sie in Copilot Studio zum Erstellen von Aktionen verwendet haben.

2. Wählen Sie im Navigationsbereich Lösungen aus, um die Liste der Lösungen in der Umgebung anzuzeigen.

3. Suchen Sie die Lösung, die Sie zum Erstellen der Aktion verwendet haben, und wählen Sie sie aus.

   Eine Liste der Objekte, die der Lösung zugeordnet sind, wird angezeigt.

4. Suchen Sie die Konnektoraktion, die Sie löschen möchten. Die Aktion hat den Typ AIPlugin.

   Tipp

   Wenn Sie Ihre Aktion nicht in der Lösung sehen, verschieben Sie die Aktion vom Status Entwurf in den Status Bereit, indem Sie sie veröffentlichen.

5. Bevor Sie die Aktion löschen, müssen Sie die Abhängigkeit von der AICopilot_AIPlugin-Tabelle löschen. Wählen Sie zunächst Erweitert>Abhängigkeiten anzeigen aus.

   

   Die Abhängigkeiten für die Konnektoraktion werden angezeigt.

6. Wählen Sie für den Eintrag AICopilot_AIPlugin in der Abhängigkeitsliste Löschen aus.

   

7. Kehren Sie zur Liste der Objekte zurück, und löschen Sie die Aktion, indem Sie Entfernen>Aus dieser Umgebung löschen auswählen.

   

8. Löschen Sie alle Vorgänge des Typs AIPluginOperation in der Tabelle, indem Sie Entfernen>Aus dieser Umgebung löschen auswählen.

   

9. Kehren Sie zu Copilot Studio zurück, um zu überprüfen, ob die Aktion aus der Ansicht Aktionen für den Copilot-Agent entfernt wurde.