Copilot Studio Kit installeren

Copilot Studio Kit is een opensource-toolkit voor het testen en evalueren van Copilot Studio-agents. Het helpt u bijvoorbeeld testcases te definiëren, gebruikersquery's te simuleren en agentreacties te valideren. Dit artikel bevat stapsgewijze instructies voor het installeren van de kit vanuit MarketplaceorGitHub, samen met stappen na de implementatie en configuratieopties.

Copilot Studio Kit installeren vanuit Marketplace

Als u liever Copilot Studio Kit wilt installeren vanuit GitHub, ga door naar Copilot Studio Kit installeren vanuit GitHub.

Implementeren vanuit Marketplace

Voer de volgende stappen uit om Copilot Studio Kit te implementeren vanuit Marketplace:

1. Navigeer naar de Copilot Studio Kit in Marketplace.
2. Selecteer Nu ophalen.
3. Meld u indien nodig aan.
4. Selecteer in de weergave Copilot Studio Kit installeren de omgeving waarin u de Copilot Studio Kit wilt implementeren.
5. Bekijk de voorwaarden en instructies. Als u akkoord gaat, schakelt u de selectievakjes in en selecteert u Installeren.

De installatie van Copilot Studio Kit begint.

Stappen na de implementatie (Marktplaats)

Nadat de installatie is voltooid, volgt u deze stappen na de implementatie:

1. Aanmelden bij Power Apps.
2. Ga naar Oplossingen.
3. Selecteer Standaardoptie.
4. Selecteer Verbindingsverwijzingen.
5. Zoek Copilot Studio Kit - Dataverse en open deze om te bewerken.
6. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is. Maak indien nodig een nieuwe verbinding met Dataverse.
7. Selecteer Opslaan.
8. Volg extra en optionele configuratiestappen.

Copilot Studio Kit installeren vanuit GitHub

Volg deze stappen om Copilot Studio Kit te installeren vanuit GitHub. Als u liever installeert vanuit Marketplace, gaat u naar Install Copilot Studio Kit vanuit Marketplace.

De nieuwste GitHub-release downloaden

Download de laatste versie van de beheerde oplossing voor de Power CAT Copilot Studio Kit.

CopilotStudioKit beheerd zip-bestand installeren

De beheerde oplossing Copilot Studio Kit installeren:

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waarin u Copilot Studio Kit wilt installeren.
3. Ga naar Oplossingen.
4. Selecteer Oplossing importeren.
5. Selecteer Bladeren.
6. Selecteer het bestand CopilotStudioKit*_managed.zip .
7. Selecteer Volgende.
8. Nadat u de oplossingsgegevens hebt bekeken, selecteert u Volgende.
9. Als u hierom wordt gevraagd, maakt u de vereiste verbindingen en selecteert u Importeren.
10. Laat gespreks-KPI-rapportwaarden voorlopig ongewijzigd. U kunt deze waarden later bijwerken.
11. Wacht totdat de importbewerking is voltooid.

Bestaande oplossing upgraden (GitHub)

Als u een eerdere versie van de Copilot Studio Kit hebt geïnstalleerd en u wilt upgraden naar de nieuwste versie, voert u de volgende stappen uit:

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waar u Copilot Studio Kit wilt upgraden.
3. Ga naar Oplossingen.
4. Selecteer Oplossing importeren.
5. Selecteer Bladeren.
6. Selecteer CopilotStudioKit*_managed.zip.
7. Selecteer Volgende. Power Apps herkent dat deze upgrade een bestaande beheerde oplossing is.
8. Bevestig dat u de bestaande oplossing wilt upgraden door Volgende te selecteren.
9. Laat gespreks-KPI-rapportwaarden voorlopig ongewijzigd. U kunt deze waarden later bijwerken.
10. Selecteer Importeren.

Verdere en optionele configuratiestappen

Deze configuratiestappen zijn van toepassing of u de Copilot Studio Kit hebt geïnstalleerd vanuit Marketplace of GitHub.

SharePoint-synchronisatie configureren

De volgende stappen zijn optioneel en alleen vereist als u van plan bent de SharePoint-synchronisatiefunctie te gebruiken. U kunt deze waarden op elk gewenst moment instellen voordat u de functie gebruikt.

Wijs de verbinding met SharePoint naar de bronsite SharePoint. Wijs de Dataverse-URL naar het Dataverse-exemplaar voor de aangepaste doelagenten waar de inhoud wordt gesynchroniseerd.

U kunt deze stappen volgen of de wizard Setup gebruiken om de SharePoint verbindingsreferentie.

De SharePoint-synchronisatiefunctie gebruiken:

1. Installeer Copilot Studio Kit, zoals eerder in dit artikel is beschreven.
2. Aanmelden bij Power Apps.
3. Ga naar Oplossingen.
4. Selecteer Standaardoptie.
5. Selecteer Verbindingsverwijzingen.
6. Zoek de Copilot Studio Kit - SharePoint verbindingsverwijzing en open deze om te bewerken.
7. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is. Maak indien nodig een nieuwe verbinding met SharePoint.
8. Selecteer Opslaan.

Meer informatie: Meer informatie over het configureren van agents in Copilot Studio Kit, waaronder het configureren van een nieuwe agent voor bestandssynchronisatie.

Agentinventaris configureren

De volgende stappen zijn optioneel en alleen vereist als u van plan bent om de functie Agentinventaris te gebruiken. U kunt deze waarden op elk gewenst moment instellen voordat u de functie gebruikt.

De verbindingsverwijzingen in de oplossing bepalen de zichtbaarheid van de agents. Hoewel u andere accounts kunt gebruiken, kunt u deze machtigingen gebruiken om volledige zichtbaarheid te krijgen.

• Copilot Studio Kit - Power Platform for Admins haalt de lijst met omgevingen in de tenant op. Hiervoor zijn machtigingen op Power Platform-beheerniveau vereist.
• Copilot Studio Kit - Dataverse verzamelt de agentgegevens uit de omgevingen. Hiervoor zijn machtigingen op het niveau van de systeembeheerder vereist voor alle omgevingen.

Je kunt deze stappen volgen of de Setup Wizard gebruiken om de Agent Inventory-verbindingsreferenties te configureren.

De functie Agentinventaris gebruiken:

1. Installeer Copilot Studio Kit, zoals eerder in dit artikel is beschreven.
2. Aanmelden bij Power Apps.
3. Ga naar Oplossingen.
4. Selecteer Standaardoptie.
5. Selecteer Verbindingsverwijzingen.
6. Zoek de Copilot Studio Kit - Power Platform verbindingsreferentie voor beheerders en open deze voor bewerking.
7. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is.
8. Selecteer Opslaan.
9. Zoek de Copilot Studio Kit - Dataverse verbindingsverwijzing en open deze om te bewerken.
10. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is.
11. Selecteer Opslaan.

Metrische gegevens over gebruik inschakelen

Voer de volgende stappen uit om optionele Gebruiksstatistieken in de agentinventarisatie in te schakelen:

1. Zorg ervoor dat de connector HTTP met Microsoft Entra ID (vooraf geverifieerd) is toegestaan in uw omgeving.
2. Importeer het bestand _AgentInventoryUsage*managed.zip uit de opslagplaats Power CAT Copilot Studio Kit GitHub.
3. Maak tijdens het importproces een verbinding met behulp van de URL van de licentiehost: https://licensing.powerplatform.microsoft.com/

Workflows inschakelen

Als u de cloudstromen wilt inschakelen die zijn opgenomen in de Copilot Studio Kit, volgt u gewoon deze stappen of gebruikt u de Setup Wizard.

1. Installeer Copilot Studio Kit, zoals eerder in dit artikel is beschreven.
2. Meld u aan bij Power Automate.
3. Zorg ervoor dat de omgeving met de Copilot Studio Kit is geselecteerd.
4. Selecteer Oplossingen.
5. Kies Copilot Studio Kit.
6. Selecteer Cloudstromen.
7. Zorg ervoor dat alle stromen zijn ingeschakeld (Status = Aan).
8. Schakel stromen in die niet zijn ingeschakeld, in de volgende volgorde:
   1. Flows die eindigen op kleinkind.
   2. Stromen die eindigen op Child.
   3. Rest van de workflows zoals nodig, in elke gewenste volgorde.

Zet Compliance Hub op

Als u de Compliance Hub wilt instellen, volgt u de stappen in Set up and configure Copilot Studio Kit Compliance Hub. Compliance Hub vereist agentenvoorraad.

Het embedded KPI-dashboard voor gesprekken configureren

Volg deze stappen alleen als u van plan bent om het dashboard voor ingesloten gespreks-KPI's te gebruiken.

Noteer tijdens de stappen de volgende waarden:

• Naam van werkruimte
• Werkruimte-GUID
• Rapportnaam
• Rapport-GUID

Het rapport publiceren

Ga als volgt te werk om het rapport gespreks-KPI's te publiceren:

1. Installeer Copilot Studio Kit, zoals eerder in dit artikel is beschreven.

2. Download Conversation.KPIs.zip vanuit de GitHub-opslagplaats van de Power CAT Copilot Studio Kit.

3. Pak de inhoud van het (zip) bestand uit.

4. Open het bestand Conversation KPI's.pbit in de Power BI Desktop-toepassing.

5. Voer de Dataverse-URL in als de omgevings-URL in het dialoogvenster dat wordt weergegeven en selecteer Laden (bijvoorbeeld org3c23948.crm.dynamics.comzonder het https:// voorvoegsel).

   Als het dialoogvenster niet verschijnt, voert u de omgevings-URL in Home>Gegevens transformeren>Parameters bewerken in.

6. Vernieuw de gegevens en meld u aan zoals vereist.

7. Sla op en publiceer in een werkruimte.

8. Noteer de rapportnaam en werkruimtenaam.

9. Meld u aan bij Power BI.

10. Open het rapport dat u hebt gepubliceerd en noteer de werkruimte-GUID en rapport-GUID in de URL.

    Als u publiceert naar 'Mijn werkruimte', is de werkruimte-GUID 00000000-0000-0000-0000-000000000000.

11. Selecteer de drie stippen (...) en bekijk vervolgens Semantisch Model.

12. Open Bestand>Instellingen.

13. Controleer of er geen problemen zijn met de referenties van de gegevensbron . Meld u aan om eventuele problemen op te lossen.

14. Ga naar Vernieuwen en stel het vernieuwingsschema in.

De omgevingsvariabele van het rapport bijwerken

Als u het dashboard voor ingesloten gespreks-KPI's wilt instellen, werkt u de gerelateerde omgevingsvariabele bij met de juiste id's. Je kunt deze stappen volgen of de Setup Wizard gebruiken.

1. Meld u aan bij Power Apps en selecteer de omgeving waarin u Copilot Studio Kit hebt geïnstalleerd.
2. Selecteer Oplossingen>Standaardoplossing.
3. Selecteer Omgevingsvariabelen.
4. Gespreks-KPI's zoeken en selecteren.
5. Vervang de tijdelijke aanduidingen in de standaardwaarde door de werkruimtenaam, werkruimte-GUID, rapportnaam en rapport-GUID-waarden die u tijdens het publicatieproces hebt genoteerd.
6. Selecteer Opslaan.

Meer informatie over configuratie van agents in Copilot Studio Kit, waaronder het configureren van een nieuwe agent voor gespreks-KPI's.

Toegang tot de Copilot Studio Kit-app

Ga als volgende te werk om toegang te krijgen tot de app Copilot Studio Kit:

1. Meld u aan bij Power Apps en selecteer de omgeving waarin u Copilot Studio Kit hebt geïnstalleerd.
2. Ga naar Apps.
3. Zoek en selecteer Power CAT Copilot Studio Kit.
4. Selecteer Afspelen.
5. (Optioneel) Voeg de app toe aan bladwijzers.

De Copilot Studio Kit-app delen

Nadat u hebt gecontroleerd of de app is gestart, moet de eigenaar (of systeembeheerder die de Kit heeft geïnstalleerd) de Copilot Studio Kit-app delen met het team.

1. Aanmelden bij Power Apps.
2. Selecteer de apps.
3. Zoek naar 'Copilot Studio Kit' en zoek de set met het type Code (niet de modelgestuurde app).
4. Selecteer de drie puntjes (...) en selecteer Vervolgens Delen naast de naam van de app.
5. Zoek en voeg de gebruikers of beveiligingsgroepen toe die toegang nodig hebben.
6. Selecteer Delen om te bevestigen.

Meer informatie vindt u in Een canvas-app delen met uw organisatie.

Volgende stap