Installera Copilot Agent Kit

Copilot Agent Kit är ett öppen källkodsverktyg för att testa och utvärdera Copilot Studio-agenter. Det hjälper dig till exempel att definiera testfall, simulera användarfrågor och validera agentsvar. Den här artikeln ger steg-för-steg-instruktioner för installation av kitet från Marketplace eller GitHub, tillsammans med steg efter distribution och konfigurationsalternativ.

Anmärkning

Innan du laddar ner och installerar Copilot Agent Kit, se till att du uppfyller alla förutsättningar.

Installera Copilot Agent Kit från Marketplace

Om du föredrar att installera Copilot Agent Kit från GitHub, hoppa till Installera Copilot Agent Kit från GitHub.

Distribuera från Marketplace

För att distribuera Copilot Agent Kit från Marketplace, följ följande steg:

  1. Gå till Copilot Agent Kit på Marketplace.
  2. Välj Hämta nu.
  3. Logga in om det behövs.
  4. I vyn Installera Copilot Agent Kit väljer du miljön där du vill distribuera Copilot Agent Kit.
  5. Granska villkoren och -uttrycken. Om du godkänner markerar du kryssrutorna och väljer Installera.

Installationen av Copilot Agent Kit påbörjas.

Steg efter utrullning (Marketplace)

När installationen är klar följer du de här stegen efter distributionen:

  1. Logga in på Power Apps.
  2. Gå till Lösningar.
  3. Välj standardlösning.
  4. Välj Anslutningsreferenser.
  5. Hitta Copilot Agent Kit - Dataverse och öppna det för redigering.
  6. Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig. Skapa en ny anslutning till Dataverse efter behov.
  7. Välj Spara.
  8. Följ ytterligare och valfria konfigurationssteg.

Installera Copilot Agent Kit från GitHub

Följ dessa steg för att installera Copilot Agent Kit från GitHub. Om du föredrar att installera från Marketplace, gå till Install Copilot Agent Kit från Marketplace.

Ladda ned den senaste GitHub-versionen

Ladda ner den senaste versionen av den hanterade lösningen för Power CAT Copilot Agent Kit.

Installera Copilot Agent Kit managed zip-fil

För att installera Copilot Agent Kit hanterade lösning:

  1. Logga in på Power Apps.
  2. Välj miljön där du vill installera Copilot Agent Kit.
  3. Gå till Lösningar.
  4. Välj Importera lösning.
  5. Välj Bläddra.
  6. Välj filen CopilotStudioKit*_managed.zip .
  7. Klicka på Nästa.
  8. När du har granskat lösningsinformationen väljer du Nästa.
  9. Om du uppmanas till det skapar du de nödvändiga anslutningarna och väljer Importera.
  10. Lämna rapportvärden för konversations-KPI:er as-is för tillfället. Du kan uppdatera dessa värden senare.
  11. Vänta tills importen har slutförts.

Uppgradera en befintlig lösning (GitHub)

För att uppgradera till den senaste versionen av Copilot Agent Kit, följ följande steg:

  1. Logga in på Power Apps.
  2. Välj miljön där du vill uppgradera Copilot Agent Kit.
  3. Gå till Lösningar.
  4. Välj Importera lösning.
  5. Välj Bläddra.
  6. Välj CopilotStudioKit*_managed.zip.
  7. Klicka på Nästa. Power Apps inser att den här uppgraderingen är en befintlig hanterad lösning.
  8. Bekräfta att du vill uppgradera den befintliga lösningen genom att välja Nästa.
  9. Lämna rapportvärden för konversations-KPI:er as-is för tillfället. Du kan uppdatera dessa värden senare.
  10. Välj Importera.

Anmärkning

När du uppgraderar Copilot Agent Kit kan du stöta på följande fel: Lösning "Power CAT Copilot Agent Kit" misslyckades med import: ImportAsHolding misslyckades med undantag: Kan inte ta bort attributet: cat_copilottestrunid från Entity: cat_CopilotTestRun eftersom attributet inte är ett anpassat fält.

Det här problemet är känt och under utredning. Som en lösning kan du mellanlagra uppgraderingen innan du tillämpar den. Läs mer i Uppgradera eller uppdatera en lösning.

Ytterligare och valfria konfigurationssteg

Dessa konfigurationssteg gäller oavsett om du installerade Copilot Agent Kit från Marketplace eller GitHub.

Tips/Råd

Copilot Agent Kit inkluderar en installationsguide för att konfigurera anslutningsreferenser, miljövariabler och molnflöden. Läs mer om att använda Setup Wizard.

Konfigurera SharePoint-synkronisering

Följande steg är valfria och krävs endast om du planerar att använda SharePoint-synkroniseringsfunktionen . Du kan ange dessa värden när som helst innan du använder funktionen.

Rikta anslutningen till SharePoint mot källans SharePoint-webbplats. Peka Dataverse-URL:en till Dataverse-instansen för de anpassade målagenter där innehållet synkroniseras.

Du kan följa de här stegen eller använda guiden Setup för att konfigurera anslutningsreferensen för SharePoint.

Så här använder du SharePoint-synkroniseringsfunktionen:

  1. Installera Copilot Agent Kit, som beskrivits tidigare i denna artikel.
  2. Logga in på Power Apps.
  3. Gå till Lösningar.
  4. Välj standardlösning.
  5. Välj Anslutningsreferenser.
  6. Hitta Copilot Agent Kit - SharePoint-anslutningsreferensen och öppna den för redigering.
  7. Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig. Skapa en ny anslutning till SharePoint efter behov.
  8. Välj Spara.

Mer information: Lär dig om att konfigurera agenter i Copilot Agent Kit, inklusive hur man konfigurerar en ny agent för filsynkronisering.

Konfigurera inventering för agenter

Följande steg är valfria och krävs endast om du planerar att använda funktionen Agentinventering . Du kan ange dessa värden när som helst innan du använder funktionen.

Anslutningsreferenserna i lösningen styr agenternas synlighet. Även om du kan använda andra konton kan du använda dessa behörigheter för att få fullständig insyn.

  • Copilot Agent Kit - Power Platform for Admins hämtar listan över miljöer i hyresgästen. Kräver behörigheter på Power Platform-administratörsnivå.
  • Copilot Agent Kit - Dataverse samlar in agentinformation från miljöerna. Kräver behörigheter på systemadministratörsnivå till alla miljöer.

Du kan följa dessa steg eller använda Installationsguiden för att konfigurera Agent Inventory-anslutningsreferenserna.

Så här använder du funktionen Agentinventering:

  1. Installera Copilot Agent Kit, som beskrivits tidigare i denna artikel.
  2. Logga in på Power Apps.
  3. Gå till Lösningar.
  4. Välj standardlösning.
  5. Välj Anslutningsreferenser.
  6. Hitta anslutningsreferensen Copilot Agent Kit - Power Platform for Admins och öppna den för redigering.
  7. Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig.
  8. Välj Spara.
  9. Hitta anslutningsreferensen Copilot Agent Kit - Dataverse och öppna den för redigering.
  10. Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig.
  11. Välj Spara.

Aktivera flöden

Anmärkning

Om du planerar att använda SharePoint synkroniseringKonfigurera SharePoint synkronisering innan du aktiverar relaterade flöden (namn börjar med SharePoint synkronisering).

För att aktivera molnflödena som ingår i Copilot Agent Kit, följ antingen dessa steg eller använd Installationsguiden.

  1. Installera Copilot Agent Kit, som beskrivits tidigare i denna artikel.
  2. Logga in på Power Automate.
  3. Se till att miljön med Copilot Agent Kit är vald.
  4. Välj Lösningar.
  5. Välj Copilot Agent Kit.
  6. Välj Molnflöden.
  7. Kontrollera att alla flöden är aktiverade (Status = På).
  8. Aktivera alla flöden som inte är aktiverade i följande ordning:
    1. Flöden som slutar med Två nivåer under.
    2. Flöden som slutar med Underordnad.
    3. Resten av flödena efter behov, i valfri ordning.

Sätt upp Compliance Hub

För att sätta upp Compliance Hub, följ stegen i Sätt upp och konfigurera Copilot Agent Kit Compliance Hub. Compliance Hub kräver agentinventering.

Konfigurera den inbäddade KPI-instrumentpanelen för konversation

Följ dessa steg endast om du planerar att använda den inbäddade konversations-KPI:er-instrumentpanelen.

Anteckna följande värden under stegen:

  • Arbetsytans namn
  • Arbetsytans GUID
  • Rapportnamn
  • Rapport-GUID

Publicera rapporten

Så här publicerar du rapporten konversations-KPI:er:

  1. Installera Copilot Agent Kit, som beskrivits tidigare i denna artikel.

  2. Ladda nerConversation.KPIs.zip från Power CAT Copilot Agent Kit GitHub-arkivet.

  3. Extrahera innehållet i zip-filen.

  4. Öppna filen Conversation KPI:er.pbit i Power BI Desktop-programmet.

  5. Ange Dataverse-URL:en som miljö-URL i dialogrutan som visas och välj Läs in (till exempel org3c23948.crm.dynamics.com, utan https:// prefixet).

    Om dialogrutan inte visas, ange Miljö-URL i Hem>Transformera data>Redigera parametrar.

  6. Uppdatera data och logga in efter behov.

  7. Spara och publicera på en arbetsyta.

  8. Anteckna rapportnamnet och arbetsytans namn.

  9. Logga in på Power BI.

  10. Öppna den rapport som du publicerade och anteckna arbetsytans GUID och rapport-GUID i URL:en.

    Om du publicerar till "Min arbetsyta" är arbetsytans GUID 00000000-0000-0000-0000-000000000000.

  11. Välj de tre prickarna (...) och sedan Visa semantisk modell.

  12. Öppna Filinställningar>.

  13. Kontrollera att autentiseringsuppgifterna för datakällan inte har några problem. Logga in för att åtgärda eventuella problem.

  14. Gå till Uppdatera och ange uppdateringsschemat.

Uppdatera rapportmiljövariabeln

För att konfigurera den inbäddade instrumentpanelen för konversationens KPI:er, uppdatera den relaterade miljövariabeln med rätt identifierare. Du kan antingen följa dessa steg eller använda Setup Wizard.

  1. Logga in på Power Apps och välj miljön där du installerade Copilot Agent Kit.
  2. Välj Lösningar>Standardlösning.
  3. Välj Miljövariabler.
  4. Leta upp och välj Rapport för konversations-KPI:er.
  5. Ersätt platshållarna i standardvärdet med de värden för arbetsytans namn, arbetsytans GUID, rapportnamn och rapport-GUID som du antecknade under publiceringsprocessen.
  6. Välj Spara.

Lär dig om hur du konfigurerar agenter i Copilot Agent Kit, inklusive hur du konfigurerar en ny agent för konversations-KPI:er.

Få tillgång till Copilot Agent Kit-appen

För att komma åt Copilot Agent Kit-appen:

  1. Logga in på Power Apps och välj miljön där du installerade Copilot Agent Kit.
  2. Gå till Appar.
  3. Hitta och välj Power CAT Copilot Agent Kit.
  4. Välj Spela upp.
  5. (Valfritt) Bokmärke för appen.

Dela Copilot Agent Kit-appen

Efter att ha verifierat att appen startar framgångsrikt behöver ägaren (eller systemadministratören som installerade Kitet) dela Copilot Agent Kit-appen med teamet.

  1. Logga in på Power Apps.
  2. Välj Program.
  3. Sök efter "Copilot Agent Kit" och hitta den med typen Code (inte den modelldrivna appen).
  4. Välj de tre punkterna (...) och välj sedan Dela bredvid appnamnet.
  5. Sök efter och lägg till de användare eller säkerhetsgrupper som behöver åtkomst.
  6. Välj Dela för att bekräfta.

Läs mer i Dela en canvas app med din organisation.

Nästa steg