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 aus dem Marketplace oder GitHub, sowie zu Schritten nach der Bereitstellung und Konfigurationsoptionen.

Copilot-Agent-Kit von Marketplace installieren

Wenn Sie das Copilot-Agent-Kit von GitHub installieren möchten, gehen Sie zu Copilot-Agent-Kit aus GitHub installieren.

Vom Marktplatz aus deployen

Gehen Sie wie folgt vor, um das Copilot Agent Kit über den Marketplace bereitzustellen:

1. Rufen Sie das Copilot-Agent-Kit im Marketplace auf.
2. Wählen Sie "Jetzt abrufen" aus.
3. Melden Sie sich bei Bedarf an.
4. Wählen Sie in der Ansicht Copilot-Agent-Kit installieren die Umgebung aus, in der Sie das Copilot-Agent-Kit bereitstellen 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 des Copilot-Agent-Kits 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.

Copilot-Agent-Kit von GitHub installieren

Befolgen Sie diese Schritte, um Copilot-Agent-Kit von GitHub zu installieren. Wenn Sie die Installation über den Marktplatz bevorzugen, gehen Sie zu Copilot-Agent-Kit aus dem Marktplatz 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 Copilot-Agent-Kit ZIP-Datei

Um die verwaltete Copilot-Agent-Kit-Lösung zu installieren:

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie 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.
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 Copilot-Agent-Kit aktualisieren möchten.
3. Gehen Sie zu Lösungen.
4. Wählen Sie "Lösung importieren" aus.
5. Wählen Sie Durchsuchen.
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 unabhängig davon, ob Sie das Copilot-Agent-Kit vom Marketplace oder von GitHub installiert haben.

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 wie Sie einen neuen Agenten für die Dateisynchronisation konfigurieren.

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.

Nachdem die Verbindungsreferenzen eingerichtet sind, konfigurieren Sie den Umgebungsumfang, Agententypen, Umweltgruppen, Inventaroptionen und den Synchronisationsplan aus dem Agenteninventar heraus. Weitere Informationen finden Sie unter Konfigurieren des Agentinventars.

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

1. Installieren Sie das Copilot-Agent-Kit, das zuvor in diesem Artikel beschrieben wurde.
2. Melden Sie sich bei Power Automate an.
3. Stellen Sie 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.
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 den Compliance Hub einzurichten, befolgen Sie die Schritte in Copilot-Agent-Kit Compliance Hub einrichten und konfigurieren. 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 Sie Conversation.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, 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

Um auf die Copilot-Agent-Kit App zuzugreifen:

1. Melden Sie sich bei Power Apps an und wählen Sie die Umgebung, 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

Teilen Sie die Copilot-Agent-Kit App

Nachdem überprüft wurde, dass die App erfolgreich gestartet wird, muss der Eigentümer (oder der 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. Suchen Sie nach „Copilot-Agent-Kit“ und wählen Sie die Version mit dem Typ Code aus (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