Installieren Sie das 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 MarketplaceorGitHub sowie Konfigurationsoptionen nach der Bereitstellung.

Installieren von Copilot Studio Kit über Marketplace

Wenn Sie lieber Copilot Studio Kit aus GitHub installieren möchten, fahren Sie mit Installieren Sie Copilot Studio Kit von GitHub aus.

Vom Marktplatz aus deployen

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

1. Navigieren Sie in Marketplace zum Copilot Studio Kit.
2. Wählen Sie Jetzt anfordern aus.
3. Melden Sie sich bei Bedarf an.
4. Wählen Sie in der Ansicht Install Copilot Studio Kit 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 von Copilot Studio 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. 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 von Copilot Studio Kit aus GitHub

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

Herunterladen der neuesten GitHub-Version

Laden Sie die neuesten 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 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. Select CopilotStudioKit*_managed.zip.
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 Studio Kit über Marketplace oder GitHub installiert haben.

Konfigurieren SharePoint Synchronisierung

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

Richten Sie die Verbindung zu SharePoint auf die Quellseite der 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 diese Schritte befolgen oder den Einrichtungs-Assistenten verwenden, um die SharePoint-Verbindungsreferenz zu konfigurieren.

So verwenden Sie das SharePoint-Synchronisierungsfeature:

1. Installieren Sie Copilot Studio Kit, das weiter oben 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. Suchen Sie den Copilot Studio Kit – SharePoint Verbindungsverweis und öffnen Sie ihn 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 zu SharePoint.
8. Wählen Sie Speichern aus.

Mehr Informationen: Erfahren Sie mehr über configuring agents in 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 for Admins ruft die Liste der Umgebungen im Mandanten 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, das weiter oben 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. Suchen Sie den Copilot Studio Kit – Power Platform für Administratoren Verbindungsverweis, und öffnen Sie ihn 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 With Microsoft Entra ID (preauthorized) in Ihrer Umgebung zulässig ist.
2. Importieren Sie 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

Um die Cloudflüsse des Copilot Studio Kits zu aktivieren, führen Sie entweder die folgenden Schritte aus oder verwenden Sie den Setup-Assistenten .

1. Installieren Sie Copilot Studio Kit, das weiter oben in diesem Artikel beschrieben wurde.
2. Melden Sie sich bei Power Automate an.
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 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

Führen Sie zum Einrichten des Compliance Hub die Schritte in Setup aus, und konfigurieren Sie 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, das weiter oben in diesem Artikel beschrieben wurde.

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

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

4. Öffnen Sie die Datei Conversation KPIs.pbit in der Power BI Desktopanwendung.

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.

Mehr Informationen: Erfahren Sie mehr über die Konfiguration von Agents im Copilot Studio Kit, einschließlich der Konfiguration eines neuen Agents 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 Und wählen Sie Power CAT Copilot Studio Kit aus.
4. Wähle Spielen aus.
5. (Optional) App als Lesezeichen verwenden

Nächster Schritt