Copilot Studio Kit installieren

Copilot Studio Kit ist ein Open-Source-Toolkit zum Testen und Bewerten von Copilot Studio-Agenten. Zum Beispiel hilft es Ihnen, Testfälle zu definieren, Benutzeranfragen zu simulieren und Agentenantworten zu validieren. Dieser Artikel bietet Schritt-für-Schritt-Anleitungen zur Installation des Kits aus dem MarketplaceoderGitHub, sowie zu Schritten nach der Bereitstellung und Konfigurationsoptionen.

Anmerkung

Bevor Sie das Copilot Studio Kit herunterladen und installieren, stellen Sie sicher, dass Sie alle Voraussetzungen erfüllen.

Copilot Studio Kit von Marketplace installieren

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

Bereitstellung über den Marketplace

Um Copilot Studio Kit aus dem Marketplace bereitzustellen, folgen Sie diesen Schritten:

1. Navigieren Sie zum Copilot Studio Kit im Marketplace.
2. Wählen Sie Jetzt abrufen.
3. Melden Sie sich bei Bedarf an.
4. Wählen Sie in der Ansicht Copilot Studio Kit installieren die Umgebung aus, in der Sie das Copilot Studio Kit bereitstellen möchten.
5. Überprüfen Sie die Bedingungen und Erklärungen. Wenn Sie zustimmen, markieren Sie die Kästchen und wählen Installieren.

Die Installation des Copilot Studio Kits beginnt.

Schritte nach der Bereitstellung (Marktplatz)

Führen Sie die folgenden Schritte nach der Installation 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 Verbindungsreferenzen aus.
5. Lokalisieren Sie Copilot Studio Kit - Dataverse und öffnen Sie es zur Bearbeitung.
6. Stellen Sie sicher, dass alle erforderlichen Felder ausgefüllt sind und die ausgewählte Verbindung gültig ist. Erstellen Sie bei Bedarf eine neue Verbindung zu Dataverse.
7. Wählen Sie Speichern aus.
8. Führen Sie weitere und optionale Konfigurationsschritte durch.

Copilot Studio Kit von GitHub installieren

Befolgen Sie diese Schritte, um Copilot Studio Kit von GitHub zu installieren. Wenn Sie die Installation über den Marktplatz bevorzugen, gehen Sie zu Copilot Studio Kit aus dem Marktplatz installieren.

Die neueste Version von GitHub herunterladen

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

Installieren Sie die verwaltete CopilotStudioKit ZIP-Datei

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

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie Copilot Studio Kit installieren möchten.
3. Gehen Sie zu Lösungen.
4. Wählen Sie Lösung importieren aus.
5. Wählen Sie Suchen aus.
6. Wählen Sie die Datei CopilotStudioKit*_managed.zip aus.
7. Wählen Sie Weiter aus.
8. Nach der Überprüfung der Lösungsinformation wählen Sie Weiter aus.
9. Wenn Sie dazu aufgefordert werden, erstellen Sie die erforderlichen Verbindungen und wählen Sie Import aus.
10. Lassen Sie Unterhaltungs-KPI-Bericht Werte vorerst unverändert. Sie können diese Werte später aktualisieren.
11. Warten Sie, bis der Import-Vorgang abgeschlossen ist.

Upgrade der bestehenden Lösung (GitHub)

Wenn Sie eine frühere Version des Copilot Studio Kit installiert haben und auf die neueste Version aktualisieren möchten, folgen Sie diesen Schritten:

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie Copilot Studio Kit aktualisieren möchten.
3. Gehen Sie zu Lösungen.
4. Wählen Sie Lösung importieren aus.
5. Wählen Sie Suchen aus.
6. Wählen Sie CopilotStudioKit*_managed.zip aus.
7. Wählen Sie Weiter aus. Power Apps erkennt, dass dieses Upgrade eine bestehende verwaltete Lösung ist.
8. Bestätigen Sie, dass Sie die bestehende Lösung aktualisieren möchten, indem Sie Weiter auswählen.
9. Lassen Sie Unterhaltungs-KPI-Bericht Werte vorerst unverändert. Sie können diese Werte später aktualisieren.
10. Wählen Sie Importieren aus.

Anmerkung

Beim Upgrade des Copilot Studio Kits kann es zu folgendem Fehler kommen: Lösung „Power CAT Copilot Studio Kit“ konnte nicht importiert werden: ImportAsHolding schlug mit einer Ausnahme fehl: Attribut: cat_copilottestrunid aus Entität: cat_CopilotTestRun kann nicht gelöscht werden, da das Attribut kein benutzerdefiniertes Feld ist.

Dies ist ein bekanntes Problem und wird untersucht. Stellen Sie als Problemumgehung das Upgrade bereit, bevor Sie es anwenden. Weitere Informationen unter Upgraden oder Aktualisieren einer Lösung.

Weitere optionale Konfigurationsschritte

Diese Konfigurationsschritte gelten unabhängig davon, ob Sie das Copilot Studio Kit vom Marketplace oder von GitHub installiert haben.

Trinkgeld

Copilot Studio Kit enthält einen Setup-Assistant, mit dem Sie Verbindungsreferenzen, Umgebungsvariablen und Cloud-Flows konfigurieren können. Erfahren Sie mehr über die Verwendung des Setup-Assistant.

SharePoint-Synchronisation konfigurieren

Die folgenden Schritte sind optional und nur erforderlich, wenn Sie die SharePoint-Synchronisationsfunktion verwenden möchten. Sie können diese Werte jederzeit festlegen, bevor Sie die Funktion verwenden.

Weisen Sie die SharePoint-Verbindung der Quellseite von SharePoint zu. 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 diese Schritte befolgen oder den Setup-Assistant verwenden, um die SharePoint-Verbindungsreferenz zu konfigurieren.

Um die SharePoint-Synchronisationsfunktion zu nutzen:

1. Installieren Sie das Copilot Studio 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 Verbindungsreferenzen aus.
6. Suchen Sie die Copilot Studio 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. Richten Sie bei Bedarf eine neue Verbindung zu SharePoint ein.
8. Wählen Sie Speichern aus.

Weitere Informationen: Erfahren Sie mehr über die Konfiguration von Agenten im Copilot Studio Kit, einschließlich wie Sie einen neuen Agenten für die Dateisynchronisation konfigurieren.

Agenteninventar konfigurieren

Die folgenden Schritte sind optional und nur erforderlich, wenn Sie die Agentinventar Funktion verwenden möchten. Sie können diese Werte jederzeit festlegen, bevor Sie die Funktion verwenden.

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

• Copilot Studio Kit – Power Platform for Admins ruft die Liste der Umgebungen im Mandant ab. Erfordert Power Platform-Administratorberechtigungen.
• Copilot Studio Kit - Dataverse sammelt die Agenteninformationen aus den Umgebungen. Benötigt Systemadministrator-Berechtigungen für alle Umgebungen.

Sie können diese Schritte befolgen oder den Setup-Assistant verwenden, um die Verbindungsreferenzen für das Agenten-Inventar zu konfigurieren.

Um die Funktion Agent-Bestand zu nutzen:

1. Installieren Sie das Copilot Studio 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 Verbindungsreferenzen aus.
6. Suchen Sie die Copilot Studio Kit – Power Platform for Admins-Verbindungsreferenz und öffnen Sie 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. Suchen Sie die Copilot Studio 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.

Metriknutzung aktivieren

Um optionale Nutzungsmetriken im Agenteninventar zu aktivieren, führen Sie die folgenden Schritte aus:

1. Stellen Sie sicher, dass der Connector HTTP mit Microsoft Entra ID (vorautorisiert) in Ihrer Umgebung erlaubt ist.
2. Importieren Sie die Datei _AgentInventoryUsage*managed.zip aus dem Power CAT Copilot Studio Kit GitHub-Repository.
3. Während des Importprozesses wird eine Verbindung mit der Lizenz-Host-URL erstellt: https://licensing.powerplatform.microsoft.com/

Flows aktivieren

Anmerkung

Wenn Sie planen, die SharePoint-Synchronisation zu nutzen, Konfigurieren sie die SharePoint-Synchronisierung bevor die betreffenden Flows. aktiviert werden (Namen beginnen mit SharePoint-Synchronisierung).

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

1. Installieren Sie das Copilot Studio Kit, das zuvor in diesem Artikel beschrieben wurde.
2. Anmelden bei Power Automate.
3. Stellen Sie sicher, dass die Umgebung mit dem Copilot Studio-Kit ausgewählt ist.
4. Wählen Sie Lösungen aus.
5. Wählen Sie Copilot Studio-Kit.
6. Wählen Sie Cloud-Flows aus.
7. Stellen Sie sicher, dass alle Flows aktiviert sind („Status = Ein“).
8. Aktivieren Sie alle Flows, die nicht aktiviert sind, in folgender Reihenfolge:
   1. Flows, die mit Grandchild (zwei Ebenen untergeordnet) enden.
   2. Flows, die mit untergeordnet enden.
   3. Aktivieren Sie die übrigen Flows bei Bedarf, in beliebiger Reihenfolge.

Compliance-Hub einrichten

Um den Compliance Hub einzurichten, befolgen Sie die Schritte in Copilot Studio Kit Compliance Hub einrichten und konfigurieren. Compliance Hub benötigt Agent-Bestand.

Das eingebettete Unterhaltungs-KPI-Dashboard konfigurieren

Befolgen Sie diese Schritte nur, wenn Sie das eingebettete Conversation KPIs-Dashboard verwenden möchten.

Notieren Sie während der Schritte die folgenden Werte:

• Arbeitsbereichsname
• GUID-Arbeitsbereich
• Berichtsname
• GUID-Bericht

Den Bericht veröffentlichen

Veröffentlichung des Unterhaltungs-KPIs-Berichts:

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

2. Laden Sie Conversation.KPIs.zip aus dem Power CAT Copilot Studio Kit GitHub-Repository herunter.

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

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

5. Geben Sie die Dataverse-URL als Umgebungs-URL im erscheinenden Dialogfeld ein und wählen Sie Laden aus (zum Beispiel org3c23948.crm.dynamics.com, ohne das https:// Präfix).

   Wenn das Dialogfeld nicht angezeigt wird, geben Sie die Umgebungs-URL in Start>Daten transformieren>Parameter bearbeiten ein.

6. Aktualisieren Sie die Daten und melden Sie sich bei Bedarf an.

7. Speichern und veröffentlichen Sie in einem Arbeitsbereich.

8. Notieren Sie sich den Berichtsname und den Arbeitsbereichsnamen.

9. Melden Sie sich bei Power BI an.

10. Öffnen Sie den von Ihnen veröffentlichten Bericht und notieren Sie die Arbeitsbereich-GUID sowie die Berichts-GUID in der URL.

    Wenn Sie in „Mein Arbeitsbereich“ publizieren, lautet die Arbeitsbereich-GUID 00000000-0000-0000-0000-000000000000.

11. Wählen Sie die drei Punkte (...) und dann Semantikmodell anzeigen aus.

12. Öffnen Sie Datei>Einstellungen.

13. Stellen Sie sicher, dass Datenquellen-Zugangsdaten keine Probleme aufweisen. Melden Sie sich an, um Probleme zu beheben.

14. Navigieren Sie zu Aktualisieren und legen Sie den Aktualisierungszeitplan fest.

Aktualisieren Sie die Bericht-Umgebungsvariablen

Um das eingebettete Unterhaltungs KPIs-Dashboard einzurichten, aktualisieren Sie die zugehörige Umgebungsvariable mit den richtigen Identifikatoren. Sie können entweder diese Schritte befolgen oder den Setup-Assistant verwenden.

1. Melden Sie sich bei Power Apps an und wählen Sie die Umgebung, in der Sie Copilot Studio 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 Arbeitsbereich-Name, Arbeitsbereich-GUID, Berichtname und Bericht-GUID Werte, die Sie während des Veröffentlichungsprozesses notiert haben.
6. Wählen Sie Speichern aus.

Erfahren Sie mehr zur Konfiguration von Agenten in Copilot Studio Kit, einschließlich der Konfiguration eines neuen Agenten für Unterhaltungs-KPIs.

Greifen Sie auf die Copilot Studio Kit App zu

Um auf die Copilot Studio Kit App zuzugreifen:

1. Melden Sie sich bei Power Apps an und wählen Sie die Umgebung, in der Sie Copilot Studio Kit installiert haben.
2. Gehen Sie zu Apps.
3. Suchen und wählen Sie Power CAT Copilot Studio Kit.
4. Wählen Sie Abspielen.
5. (Optional) Textmarke in der App setzen.

Teilen Sie die Copilot Studio 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 Studio 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 Studio Kit“ und wählen Sie die Version mit dem Typ Code aus (nicht die modellgesteuerte App).
4. Wählen Sie die drei Auslassungspunkte(...) und wählen Sie dann Freigeben neben dem App-Namen aus.
5. Suchen Sie nach den Benutzern oder Sicherheitsgruppen, die Zugriff benötigen, und fügen Sie sie hinzu.
6. Wählen Sie zur Bestätigung Freigeben aus.

Erfahren Sie mehr unter Eine Canvas-App mit Ihrer Organisation teilen.

Nächster Schritt

Benutzer und Teams konfigurieren