Copilot Agentkit installeren

Copilot Agentkit 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. In dit artikel vindt u stapsgewijze instructies voor het installeren van de kit vanuit Marketplace of GitHub, aangevuld met stappen na implementatie en configuratieopties.

Copilot Agentkit installeren via Marketplace

Als u liever Copilot Agentkit vanuit GitHub installeert, gaat u direct naar Copilot Agentkit installeren vanuit GitHub.

Implementeren vanuit Marketplace

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

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

De installatie van Copilot Agentkit 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. Selecteer Opslaan.
8. Volg extra en optionele configuratiestappen.

Copilot Agentkit installeren vanuit GitHub

Volg deze stappen om Copilot Agentkit vanuit GitHub te installeren. Als u de installatie liever vanuit Marketplace uitvoert, ga dan naar Copilot Agentkit installeren 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 Agentkit

De beheerde oplossing Copilot Agent Kit installeren:

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waarin u Copilot Agentkit 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)

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

1. Aanmelden bij Power Apps.
2. Selecteer de omgeving waarin u de Copilot Agentkit 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, ongeacht of u de Copilot Agentkit vanuit 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 naar de bronsite SharePoint. Verwijs de Dataverse-URL naar het Dataverse-exemplaar voor de aangepaste doelagents 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 de Copilot Agentkit, 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. Selecteer Opslaan.

Meer informatie: lees meer over het configureren van agents in Copilot Agentkit, inclusief hoe u 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.

Nadat de verbindingsreferenties zijn ingesteld, configureer je de omgevingsscope, agenttypes, omgevingsgroepen, inventarisopties en het sync-schema vanuit Agent Inventory. Meer informatie vindt u in Agentinventaris configureren.

De functie Agentinventaris gebruiken:

1. Installeer de Copilot Agentkit, 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. Selecteer 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. Selecteer Opslaan.

Workflows inschakelen

Om de cloudstromen die bij de Copilot Agentkit horen in te schakelen, volgt u deze stappen of gebruikt u de installatiewizard.

1. Installeer de Copilot Agentkit, eerder beschreven in dit artikel.
2. Meld u aan bij Power Automate.
3. Zorg ervoor dat de omgeving met 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 in te stellen, volgt u de stappen in Copilot Agentkit 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 de Copilot Agentkit, 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. Meld u aan bij Power Apps en selecteer de omgeving waarin u Copilot Agentkit 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.

Leer over het configureren van agenten in Copilot Agentkit, inclusief hoe u een nieuwe agent configureert voor gespreks-KPI's.

Toegang krijgen tot de Copilot Agentkit-app

Toegang krijgen tot de Copilot Agentkit-app:

1. Meld u aan bij Power Apps en selecteer de omgeving waarin u Copilot Agentkit 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.

De Copilot Agentkit-app delen

Nadat is geverifieerd dat de app correct is gestart, dient de eigenaar (of systeembeheerder die de Kit heeft geïnstalleerd) de Copilot Agentkit-app met het team te delen.

1. Aanmelden bij Power Apps.
2. Selecteer Apps.
3. Zoek naar "Copilot Agentkit" en selecteer de app 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