Installieren des Copilot Studio Kit

Copilot Studio Kit ist ein Open-Source-Toolkit zum Testen und Auswerten von Copilot Studio-Agents. So können Sie beispielsweise Testfälle definieren, Benutzerabfragen simulieren und Agentantworten überprüfen. Dieser Artikel enthält schrittweise Anleitungen zum Installieren des Kits aus AppSourceoderGitHub sowie Schritte nach der Bereitstellung und Konfigurationsoptionen.

Hinweis

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

Installieren des Copilot Studio Kit von AppSource

Wenn Sie Copilot Studio Kit lieber von GitHub installieren möchten, springen Sie zu Installieren von Copilot Studio Kit von GitHub.

Bereitstellen aus AppSource

Führen Sie die folgenden Schritte aus, um Copilot Studio Kit aus AppSource bereitzustellen:

1. Navigieren Sie zum Copilot Studio Kit in AppSource.
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 Begriffe und Aussagen. Wenn Sie zustimmen, aktivieren Sie die Kontrollkästchen, und wählen Sie "Installieren" aus.

Die Installation des Copilot Studio Kit beginnt.

Schritte nach der Bereitstellung (AppSource)

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. Suchen 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 nach Bedarf eine neue Verbindung mit Dataverse.
7. Wählen Sie Speichern aus.
8. Führen Sie weitere und optionale Konfigurationsschritte aus.

Installieren des Copilot Studio Kit von GitHub

Führen Sie die folgenden Schritte aus, um Copilot Studio Kit von GitHub zu installieren. Wenn Sie die Installation von AppSource bevorzugen, wechseln Sie zu "Copilot Studio Kit installieren" von AppSource.

Herunterladen der neuesten GitHub-Version

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

Installieren der von CopilotStudioKit verwalteten ZIP-Datei

So installieren Sie die verwaltete Copilot Studio Kit-Lösung:

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 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)

Wenn Sie eine frühere Version des Copilot Studio Kit installiert haben und ein Upgrade auf die neueste Version durchführen möchten, führen Sie die folgenden Schritte aus:

1. Melden Sie sich bei Power Apps an.
2. Wählen Sie die Umgebung aus, in der Sie das Copilot Studio Kit aktualisieren 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.

Hinweis

Beim Upgrade des Copilot Studio Kit tritt möglicherweise der folgende Fehler auf: "Lösung "Power CAT Copilot Studio Kit" konnte nicht importiert werden: ImportAsHolding ist mit Ausnahme fehlgeschlagen: Attribut kann nicht gelöscht werden: cat_copilottestrunid von Entity: cat_CopilotTestRun da das Attribut kein benutzerdefiniertes Feld ist."

Dieses Problem ist bekannt und wird untersucht. Stellen Sie als Problemumgehung das Upgrade bereit, bevor Sie es anwenden. Weitere Informationen finden Sie unter Upgrade oder Aktualisieren einer Lösung.

Weitere und optionale Konfigurationsschritte

Diese Konfigurationsschritte gelten für die Installation des Copilot Studio Kit aus AppSource oder GitHub.

Tipp

Copilot Studio Kit enthält einen Setup-Assistenten zur Konfiguration von Verbindungsreferenzen, Umweltvariablen und Cloud-Flows. Erfahren Sie mehr über die Nutzung des Setup-Assistenten.

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.

Zeigen Sie die Verbindung mit SharePoint auf die SharePoint-Quellwebsite. 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-Assistenten verwenden, um die SharePoint-Verbindungsreferenz zu konfigurieren.

So verwenden Sie das SharePoint-Synchronisierungsfeature:

1. Installieren Sie Copilot Studio Kit, wie weiter oben in diesem Artikel beschrieben.
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. Suchen Sie die Copilot Studio Kit – SharePoint-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. Erstellen Sie nach Bedarf eine neue Verbindung mit SharePoint.
8. Wählen Sie Speichern aus.

Weitere Informationen: Erfahren Sie mehr über das Konfigurieren von Agents im Copilot Studio Kit, einschließlich der Konfiguration eines neuen Agents für die Dateisynchronisierung.

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 Studio Kit – Power Platform für Administratoren ruft die Liste der Umgebungen im Tenant ab. Erfordert Berechtigungen auf Power Platform-Administratorebene.
• Copilot Studio Kit – Dataverse sammelt die Agentinformationen 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 Copilot Studio Kit, wie weiter oben in diesem Artikel beschrieben.
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. Suchen Sie die Verbindungsreferenz für das Copilot Studio Kit – Power Platform für Admins 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 den Copilot Studio Kit - Dataverse-Verbindungsverweis , und öffnen Sie ihn 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 Nutzungsmetriken

Führen Sie die folgenden Schritte aus, um optionale Nutzungsmetriken im Agentinventar zu aktivieren:

1. Stellen Sie sicher, dass der Connector HTTP mit Microsoft Entra-ID (vorautorisiert) in Ihrer Umgebung zulässig ist.
2. Importiere die Datei AgentInventoryUsage*_managed.zip aus dem Power CAT Copilot Studio Kit GitHub Repository.
3. Erstellen Sie während des Importvorgangs eine Verbindung mit der Lizenzierungshost-URL: https://licensing.powerplatform.microsoft.com/

Aktivieren von Flüssen

Hinweis

Wenn Sie die SharePoint-Synchronisierung verwenden möchten, konfigurieren Sie die SharePoint-Synchronisierung , bevor Sie die zugehörigen Flüsse aktivieren (Namen beginnen mit der SharePoint-Synchronisierung).

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

1. Installieren Sie Copilot Studio Kit, wie weiter oben in diesem Artikel beschrieben.
2. Anmelden bei Power Automate.
3. Stellen Sie sicher, dass die Umgebung, die das Copilot Studio Kit enthält, ausgewählt ist.
4. Wählen Sie Lösungen aus.
5. Wählen Sie "Copilot Studio Kit" aus.
6. Wählen Sie Cloud-Flows.
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, folgen Sie den Schritten unter Einrichten und Konfigurieren des Copilot Studio Kit Compliance Hub. Der Compliance Hub benötigt Agenteninventar.

Konfigurieren des eingebetteten KPI-Dashboards für Unterhaltungen

Diese Schritte sind nur erforderlich, wenn Sie das eingebettete KPIs-Dashboard für Unterhaltungen verwenden möchten.

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

• Arbeitsbereichname
• GUID-Arbeitsbereich
• Berichtsname
• Bericht GUID

Veröffentlichen des Berichts

Veröffentlichung des Unterhaltungs-KPIs-Berichts:

1. Installieren Sie Copilot Studio Kit, wie weiter oben in diesem Artikel beschrieben.

2. Laden Sie Conversation.KPIs.zip aus dem GitHub-Repository des Power CAT Copilot Studio Kit 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 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 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.

Weitere Informationen: Erfahren Sie mehr über das Konfigurieren von Agenten im Copilot Studio Kit, einschließlich der Einrichtung eines neuen Agenten für Konversations-KPIs.

Zugreifen auf die Copilot Studio Kit-App

So greifen Sie auf die Copilot Studio Kit-App zu:

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

Nächster Schritt

Konfigurieren von Benutzern und Teams