Copilot Studio Kit installeren

Copilot Studio Kit is een opensource-toolkit voor het testen en evalueren van Copilot Studio-agents. Hiermee kunt u bijvoorbeeld testcases definiëren, gebruikersquery's simuleren en agentreacties valideren. Dit artikel geeft stapsgewijze instructies voor het installeren van de kit via MarketplaceofGitHub, samen met stappen na de uitrol en configuratieopties.

Installeer Copilot Studio Kit vanuit Marketplace

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

Deploy vanuit Marketplace

Om Copilot Studio Kit vanuit Marketplace te implementeren, volgt u deze stappen:

1. Navigeer naar de Copilot Studio Kit in Marketplace.
2. Selecteer Download het nu.
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. Meld u aan 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 je liever vanuit Marketplace installeert, ga dan naar Install Copilot Studio Kit vanuit Marketplace.

De nieuwste GitHub-release downloaden

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

CopilotStudioKit beheerd zip-bestand installeren

De beheerde copilot Studio Kit-oplossing installeren:

1. Meld u aan 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. Kies 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. Meld u aan 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. Kies 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 gelden ongeacht of je de Copilot Studio Kit via Marketplace of GitHub hebt geïnstalleerd.

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 aan op de SharePoint-bronsite. Verwijs de Dataverse-URL naar het Dataverse-exemplaar voor de aangepaste doelagenten waar de inhoud wordt gesynchroniseerd.

Je kunt deze stappen volgen of de Setup Wizard gebruiken om de SharePoint-verbindingsreferentie te configureren.

De sharePoint-synchronisatiefunctie gebruiken:

1. Installeer Copilot Studio Kit, zoals eerder in dit artikel is beschreven.
2. Meld u aan 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 voor beheerders 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. Meld u aan 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 voor bewerking.
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 GitHub-opslagplaats van de Power CAT Copilot Studio Kit.
3. Maak tijdens het importproces een verbinding met behulp van de URL van de licentiehost: https://licensing.powerplatform.microsoft.com/

Workflows inschakelen

Om de cloudflows die in de Copilot Studio Kit zijn opgenomen in te schakelen, volgt u 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. Selecteer 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

Om de Compliance Hub op te zetten, volgt u de stappen in Instellen en configureren van de Copilot Studio Kit Compliance Hub. Compliance Hub vereist Agent Inventory.

Het embedded KPI-dashboard voor gesprekken configureren

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

Noteer tijdens de stappen de volgende waarden:

• Werkruimtenaam
• 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. Zoek en selecteer Rapport over gespreks-KPI's.
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: Meer informatie over het configureren 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 Copilot Studio Kit-app:

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.

Volgende stap