Copilot Agent Kit installieren

Copilot Agent Kit ist ein Open-Source-Toolkit zum Testen und Bewerten von Copilot Studio-Agenten. So können Sie beispielsweise Testfälle definieren, Benutzerabfragen simulieren und Agentantworten überprüfen. Dieser Artikel bietet Schritt-für-Schritt-Anleitungen zur Installation des Kits über Marketplace oder GitHub sowie Schritte nach der Bereitstellung und Konfigurationsoptionen.

Installieren Sie das Copilot Agent Kit aus dem Marktplatz

Wenn Sie Copilot Agent Kit von GitHub installieren möchten, springen Sie zu Install Copilot Agent Kit von GitHub.

Vom Marktplatz aus deployen

Um Copilot Agent Kit über den Marktplatz zu installieren, folgen Sie diesen Schritten:

1. Geh zum Copilot Agent Kit im Marketplace.
2. Wählen Sie "Jetzt abrufen" aus.
3. Melden Sie sich bei Bedarf an.
4. In der Ansicht "Copilot Agent Kit installieren" wählen Sie die Umgebung aus, in der Sie das Copilot Agent Kit einsetzen möchten.
5. Überprüfen Sie die Begriffe und Aussagen. Wenn Sie zustimmen, aktivieren Sie die Kontrollkästchen, und wählen Sie "Installieren" aus.

Die Installation von Copilot Agent Kit beginnt.

Schritte nach der Bereitstellung (Marktplatz)

Führen Sie nach Abschluss der Installation die folgenden Nachbereitungsmaßnahmen aus:

1. Melden Sie sich bei Power Apps an.
2. Gehen Sie zu Lösungen.
3. Wählen Sie Standardlösung aus.
4. Wählen Sie Verbindungsverweise aus.
5. Finde Copilot Agent Kit - Dataverse und öffne es zum Bearbeiten.
6. Stellen Sie sicher, dass alle erforderlichen Felder ausgefüllt sind und die ausgewählte Verbindung gültig ist. Erstellen Sie nach Bedarf eine neue Verbindung mit Dataverse.
7. Wählen Sie "Speichern" aus.
8. Führen Sie weitere und optionale Konfigurationsschritte aus.

Installiere Copilot Agent Kit von GitHub

Befolgen Sie diese Schritte, um das Copilot Agent Kit von GitHub zu installieren. Wenn Sie lieber über den Marktplatz installieren möchten, gehen Sie im Marktplatz zu "Copilot Agent Kit installieren".

Herunterladen der neuesten GitHub-Version

Laden Sie die neueste Version der verwalteten Lösung für das Power CAT Copilot Agent Kit herunter.

Installieren Sie die verwaltete ZIP-Datei des Copilot Agent Kit

Zur Installation der von Copilot Agent Kit verwalteten Lösung:

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie das Copilot Agent Kit installieren möchten.
3. Gehen Sie zu Lösungen.
4. Wählen Sie "Lösung importieren" aus.
5. Wählen Sie Durchsuchen aus.
6. Wählen Sie die Datei "CopilotStudioKit*_managed.zip " aus.
7. Wählen Sie Weiteraus.
8. Nachdem Sie die Lösungsinformationen überprüft haben, wählen Sie "Weiter" aus.
9. Wenn Sie dazu aufgefordert werden, erstellen Sie die erforderlichen Verbindungen, und wählen Sie "Importieren" aus.
10. Lassen Sie die Conversation KPIs report-Werte unverändert. Sie können diese Werte später aktualisieren.
11. Warten Sie, bis der Importvorgang abgeschlossen ist.

Upgrade vorhandener Lösung (GitHub)

Um auf die neueste Version des Copilot Agent Kit aufzurüsten, folgen Sie diesen Schritten:

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie das Copilot Agent Kit aufrüsten möchten.
3. Gehen Sie zu Lösungen.
4. Wählen Sie "Lösung importieren" aus.
5. Wählen Sie Durchsuchen aus.
6. Wählen Sie CopilotStudioKit*_managed.zipaus.
7. Wählen Sie Weiteraus. Power Apps erkennt, dass es sich bei diesem Upgrade um eine vorhandene verwaltete Lösung handelt.
8. Vergewissern Sie sich, dass Sie die vorhandene Lösung aktualisieren möchten, indem Sie "Weiter" auswählen.
9. Lassen Sie die Conversation KPIs report-Werte unverändert. Sie können diese Werte später aktualisieren.
10. Klicken Sie auf Importieren.

Weitere und optionale Konfigurationsschritte

Diese Konfigurationsschritte gelten, egal ob du das Copilot Agent Kit über Marketplace oder GitHub installiert hast.

Konfigurieren der SharePoint-Synchronisierung

Die folgenden Schritte sind optional und nur erforderlich, wenn Sie beabsichtigen, das SharePoint-Synchronisierungsfeature zu verwenden. Sie können diese Werte jederzeit festlegen, bevor Sie das Feature verwenden.

Verweisen Sie die Verbindung zu SharePoint auf die Quell-SharePoint-Website. Weisen Sie die Dataverse-URL der Dataverse-Instanz zu, die für die bestimmten benutzerdefinierten Zielagenten vorgesehen ist, wo der Inhalt synchronisiert wird.

Sie können diesen Schritten folgen oder den Setup-Assistenten verwenden, um die SharePoint-Verbindungsreferenz zu konfigurieren.

So verwenden Sie das SharePoint-Synchronisierungsfeature:

1. Installieren Sie das Copilot Agent Kit, das zuvor in diesem Artikel beschrieben wurde.
2. Melden Sie sich bei Power Apps an.
3. Gehen Sie zu Lösungen.
4. Wählen Sie Standardlösung aus.
5. Wählen Sie Verbindungsverweise aus.
6. Finden Sie die Copilot Agent Kit - SharePoint-Verbindungsreferenz und öffnen Sie sie zum Bearbeiten.
7. Stellen Sie sicher, dass alle erforderlichen Felder ausgefüllt sind und die ausgewählte Verbindung gültig ist. Erstellen Sie nach Bedarf eine neue Verbindung mit SharePoint.
8. Wählen Sie "Speichern" aus.

Weitere Informationen: Erfahren Sie mehr über die Konfiguration von Agenten im Copilot Agent Kit, einschließlich der Konfiguration eines neuen Agenten für die Dateisynchronisation.

Konfigurieren des Agentinventars

Die folgenden Schritte sind optional und nur erforderlich, wenn Sie beabsichtigen, das Feature "Agentinventar " zu verwenden. Sie können diese Werte jederzeit festlegen, bevor Sie das Feature verwenden.

Die Verbindungsverweise in der Lösung steuern die Sichtbarkeit der Agents. Obwohl Sie andere Konten verwenden können, verwenden Sie diese Berechtigungen, um vollständige Sichtbarkeit zu erhalten.

• Copilot Agent Kit – Power Platform for Admins ruft die Liste der Umgebungen im Tenant ab. Erfordert Berechtigungen auf Power Platform-Administratorebene.
• Copilot Agent Kit - Dataverse sammelt die Agenteninformationen aus den Umgebungen. Erfordert Berechtigungen auf Systemadministratorebene für alle Umgebungen.

Sie können diese Schritte befolgen oder den Setup-Wizard verwenden, um die Agenten-Inventar-Verbindungsreferenzen zu konfigurieren.

So nutzen Sie die Funktion "Agentinventar":

1. Installieren Sie das Copilot Agent Kit, das zuvor in diesem Artikel beschrieben wurde.
2. Melden Sie sich bei Power Apps an.
3. Gehen Sie zu Lösungen.
4. Wählen Sie Standardlösung aus.
5. Wählen Sie Verbindungsverweise aus.
6. Finde die Copilot Agent Kit - Power Platform for Admins Verbindungsreferenz und öffne sie zur Bearbeitung.
7. Stellen Sie sicher, dass alle erforderlichen Felder ausgefüllt sind und die ausgewählte Verbindung gültig ist.
8. Wählen Sie "Speichern" aus.
9. Finden Sie die Copilot Agent Kit - Dataverse-Verbindungsreferenz und öffnen Sie sie zur Bearbeitung.
10. Stellen Sie sicher, dass alle erforderlichen Felder ausgefüllt sind und die ausgewählte Verbindung gültig ist.
11. Wählen Sie "Speichern" aus.

Aktivieren von Flüssen

Um die im Copilot Agent Kit enthaltenen Cloud-Flows zu aktivieren, befolgen Sie entweder diese Schritte oder verwenden Sie den Setup-Assistenten.

1. Installieren Sie das Copilot Agent Kit, das zuvor in diesem Artikel beschrieben wurde.
2. Melden Sie sich bei Power Automate an.
3. Stelle sicher, dass die Umgebung mit dem Copilot Agent Kit ausgewählt ist.
4. Wählen Sie Lösungen aus.
5. Wählen Sie Copilot Agent Kit aus.
6. Wählen Sie Cloud-Flows aus.
7. Stellen Sie sicher, dass alle Abläufe aktiviert sind (Status = Ein).
8. Aktivieren Sie alle Flüsse, die nicht aktiviert sind, in der folgenden Reihenfolge:
   1. Flows, die mit Grandchild enden.
   2. Flows, die mit Child enden.
   3. Restliche Abläufe nach Bedarf in beliebiger Reihenfolge.

Einrichtung des Compliance-Hubs

Um das Compliance Hub einzurichten, folgen Sie den Schritten in Einrichtung und Konfiguration des Copilot Agent Kit Compliance Hub. Der Compliance Hub benötigt Agenteninventar.

Konfigurieren des eingebetteten KPI-Dashboards für Unterhaltungen

Führen Sie diese Schritte nur aus, wenn Sie das eingebettete KPIs-Dashboard für Unterhaltungen verwenden möchten.

Notieren Sie sich während der Schritte die folgenden Werte:

• Arbeitsbereichsname
• GUID-Arbeitsbereich
• Berichtsname
• Bericht GUID

Den Bericht veröffentlichen

Veröffentlichung des Unterhaltungs-KPIs-Berichts:

1. Installieren Sie das Copilot Agent Kit, das zuvor in diesem Artikel beschrieben wurde.

2. Laden SieConversation.KPIs.zip aus dem Power CAT Copilot Agent Kit GitHub Repository herunter.

3. Extrahieren Sie den Inhalt der .zip-Datei.

4. Öffnen Sie die Datei "Conversation KPIs.pbit " in der Power BI Desktop-Anwendung.

5. Geben Sie die Dataverse-URL als Umgebungs-URL in das daraufhin angezeigte Dialogfeld ein und wählen Sie Laden aus (z.B. org3c23948.crm.dynamics.com, ohne Präfix https://).

   Wenn das Dialogfeld nicht erscheint, geben Sie die Umgebungs-URL in Home>Daten transformieren>Parameter bearbeiten ein.

6. Aktualisieren Sie Daten, und melden Sie sich nach Bedarf an.

7. Speichern und Veröffentlichen in einem Arbeitsbereich.

8. Notieren Sie sich den Namen des Berichts und den Arbeitsbereichsnamen.

9. Melden Sie sich bei Power BI an.

10. Öffnen Sie den veröffentlichten Bericht, und notieren Sie die Arbeitsbereichs-GUID und berichts-GUID in der URL.

    Wenn Sie in "Mein Arbeitsbereich" veröffentlichen, lautet die Arbeitsbereich-GUID 00000000-0000-0000-0000-000000000000.

11. Wähle die drei Punkte (...) und dann Semantic Model anzeigen.

12. Öffnen Sie die Dateieinstellungen>.

13. Überprüfen Sie, ob die Anmeldeinformationen der Datenquelle keine Probleme haben. Melden Sie sich an, um Probleme zu beheben.

14. Wechseln Sie zu "Aktualisieren" , und legen Sie den Aktualisierungszeitplan fest.

Aktualisieren der Berichtsumgebungsvariable

Um das eingebettete KPIs-Dashboard für Unterhaltungen einzurichten, aktualisieren Sie die zugehörige Umgebungsvariable mit den richtigen Bezeichnern. Du kannst entweder diese Schritte befolgen oder den Setup-Assistenten verwenden.

1. Melden Sie sich bei Power Apps an und wählen Sie die Umgebung aus, in der Sie Copilot Agent Kit installiert haben.
2. Wählen Sie Lösungen>Standardlösung.
3. Wählen Sie Umgebungsvariablen.
4. Suchen und wählen Sie Unterhaltungs-KPIs-Bericht aus.
5. Ersetzen Sie die Platzhalter im Standardwert durch den Arbeitsbereichsnamen, die Arbeitsbereichs-GUID, den Berichtsnamen und die Berichts-GUID-Werte , die Sie während des Veröffentlichungsprozesses angegeben haben.
6. Wählen Sie "Speichern" aus.

Erfahren Sie mehr über die Konfiguration von Agenten im Copilot Agent Kit, einschließlich der Konfiguration eines neuen Agenten für Konversations-KPIs.

Greifen Sie auf die Copilot Agent Kit App zu.

Zum Zugriff auf die Copilot Agent Kit App:

1. Melden Sie sich bei Power Apps an und wählen Sie die Umgebung aus, in der Sie Copilot Agent Kit installiert haben.
2. Wechseln Sie zu Apps.
3. Finden und wählen Sie Power CAT Copilot Agent Kit aus.
4. Wählen Sie Wiedergabe aus.
5. (Optional) App als Lesezeichen verwenden

Teile die Copilot Agent Kit App

Nachdem überprüft wurde, dass die App erfolgreich startet, muss der Besitzer (oder Systemadministrator, der das Kit installiert hat) die Copilot Agent Kit App mit dem Team teilen.

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie Apps aus.
3. Suche nach "Copilot Agent Kit" und finde das mit dem Typ Code (nicht die modellgesteuerte App).
4. Wählen Sie die drei Punkte (...) und dann "Teilen " neben dem App-Namen aus.
5. Suchen und hinzufügen Sie die Benutzer oder Sicherheitsgruppen, die Zugriff benötigen.
6. Wählen Sie "Freigeben" aus, um dies zu bestätigen.

Weitere Informationen finden Sie in der Freigabe einer Canvas-App für Ihre Organisation.

Nächster Schritt