Installeer Copilot Agent Kit

Copilot Agent Kit is een open-source toolkit voor het testen en evalueren van Copilot Studio-agenten. Het helpt u bijvoorbeeld testcases te definiëren, gebruikersquery's te simuleren en agentreacties te valideren. Dit artikel geeft stapsgewijze instructies voor het installeren van de kit via Marketplace of GitHub, samen met stappen na de uitrol en configuratieopties.

Installeer Copilot Agent Kit vanuit Marketplace

Als je liever Copilot Agent Kit van GitHub wilt installeren, ga dan naar Install Copilot Agent Kit van GitHub.

Implementeren vanuit Marketplace

Om Copilot Agent Kit via Marketplace te implementeren, volgt u deze stappen:

1. Ga naar de Copilot Agent Kit in Marketplace.
2. Selecteer Download het nu.
3. Meld u indien nodig aan.
4. Selecteer in de weergave Install Copilot Agent Kit de omgeving waar je de Copilot Agent Kit wilt inzetten.
5. Bekijk de voorwaarden en instructies. Als u akkoord gaat, schakelt u de selectievakjes in en selecteert u Installeren.

De installatie van Copilot Agent 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 Agent Kit - Dataverse en open het voor bewerking.
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. Kies Opslaan.
8. Volg extra en optionele configuratiestappen.

Installeer Copilot Agent Kit van GitHub

Volg deze stappen om Copilot Agent Kit te installeren vanaf GitHub. Als je liever installeert vanuit Marketplace, ga dan naar Install Copilot Agent Kit vanuit Marketplace.

De nieuwste GitHub-release downloaden

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

Installeer het beheerde zipbestand van Copilot Agent Kit

Om de door Copilot Agent Kit beheerde oplossing te installeren:

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waarin je Copilot Agent Kit wilt installeren.
3. Ga naar Oplossingen.
4. Selecteer Oplossing importeren.
5. Kies 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)

Om te upgraden naar de nieuwste versie van de Copilot Agent Kit, volgt u deze stappen:

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waarin je de Copilot Agent Kit wilt upgraden.
3. Ga naar Oplossingen.
4. Selecteer Oplossing importeren.
5. Kies 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 zowel als je de Copilot Agent Kit hebt geïnstalleerd via 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 Agent Kit, zoals eerder beschreven in dit artikel.
2. Aanmelden bij Power Apps.
3. Ga naar Oplossingen.
4. Selecteer Standaardoptie.
5. Selecteer Verbindingsverwijzingen.
6. Zoek de Copilot Agent Kit - SharePoint-verbindingsreferentie op en open deze voor bewerking.
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. Kies Opslaan.

Meer informatie: Lees over het configureren van agents in Copilot Agent Kit, inclusief hoe je een nieuwe agent configureert 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 Agent Kit - Power Platform for Admins haalt de lijst met omgevingen in de tenant op. Hiervoor zijn machtigingen op Power Platform-beheerniveau vereist.
• Copilot Agent Kit - Dataverse verzamelt agentinformatie 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 Agent Kit, zoals eerder beschreven in dit artikel.
2. Aanmelden bij Power Apps.
3. Ga naar Oplossingen.
4. Selecteer Standaardoptie.
5. Selecteer Verbindingsverwijzingen.
6. Zoek de Copilot Agent Kit - Power Platform for Admins verbindingsreferentie en open deze voor bewerking.
7. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is.
8. Kies Opslaan.
9. Zoek de Copilot Agent Kit - Dataverse verbindingsreferentie op en open deze voor bewerking.
10. Zorg ervoor dat alle vereiste velden zijn ingevuld en dat de geselecteerde verbinding geldig is.
11. Kies Opslaan.

Workflows inschakelen

Om de cloudstromen die in de Copilot Agent Kit zijn opgenomen in te schakelen, volgt u deze stappen of gebruikt u de Setup Wizard.

1. Installeer Copilot Agent Kit, zoals eerder beschreven in dit artikel.
2. Meld u aan bij Power Automate.
3. Zorg ervoor dat de omgeving met de Copilot Agent Kit is geselecteerd.
4. Selecteer Oplossingen.
5. Selecteer Copilot Agent 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 Copilot Agent Kit Compliance Hub instellen en configureren. 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
• Naam van rapport
• Rapport-GUID

Het rapport publiceren

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

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

2. Download Conversation.KPIs.zip uit de Power CAT Copilot Agent Kit GitHub repository.

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. Log in bij Power Apps en selecteer de omgeving waarin je Copilot Agent 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. Kies Opslaan.

Leer over het configureren van agenten in Copilot Agent Kit, inclusief hoe je een nieuwe agent configureert voor Conversation KPI's.

Toegang tot de Copilot Agent Kit-app

Om toegang te krijgen tot de Copilot Agent Kit-app:

1. Log in bij Power Apps en selecteer de omgeving waarin je Copilot Agent Kit hebt geïnstalleerd.
2. Ga naar Apps.
3. Vind en selecteer Power CAT Copilot Agent Kit.
4. Selecteer Afspelen.
5. (Optioneel) Voeg de app toe aan bladwijzers.

Deel de Copilot Agent Kit-app

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

1. Aanmelden bij Power Apps.
2. Selecteer de apps.
3. Zoek op "Copilot Agent Kit" en vind degene met 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