Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Copilot-agentpaketet Kit är ett verktyg med öppen källkod 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 innehåller stegvisa instruktioner för att installera kitet från Marketplace eller GitHub, tillsammans med åtgärder efter installation och konfigurationsalternativ.
Note
Innan du laddar ner och installerar Copilot-agentpaketet, se till att du uppfyller alla förutsättningar.
Installera Copilot-agentpaketet 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-agentpaketet från Marketplace, följ dessa steg:
- Navigera till Copilot-agentpaketet i Marketplace.
- Välj Hämta nu.
- Logga in om det behövs.
- I vyn Installera Copilot-agentpaketet , välj miljön där du vill distribuera Copilot-agentpaketet.
- Granska villkoren och -uttrycken. Om du godkänner markerar du kryssrutorna och väljer Installera.
Installation av Copilot-agentpaketet påbörjas.
Steg efter distribution (Marketplace)
När installationen är klar följer du de här stegen efter distributionen:
- Logga in på Power Apps.
- Gå till Lösningar.
- Välj standardlösning.
- Välj Anslutningsreferenser.
- Hitta Copilot Agent Kit - Dataverse och öppna det för redigering.
- Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig. Skapa en ny anslutning till Dataverse efter behov.
- Välj Spara.
- Följ ytterligare och valfria konfigurationssteg.
Installera Copilot-agentpaketet från GitHub
Följ dessa steg för att installera Copilot-agentpaketet från GitHub. Om du föredrar att installera från Marketplace, gå till Installera Copilot-agentpaketet 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 hanterad ZIP-fil för Copilot Agent Kit
Så här installerar du den hanterade lösningen för Copilot Agent Kit:
- Logga in på Power Apps.
- Välj miljön där du vill installera Copilot-agentpaketet.
- Gå till Lösningar.
- Välj Importera lösning.
- Välj Bläddra.
- Välj filen CopilotStudioKit*_managed.zip .
- Klicka på Nästa.
- När du har granskat lösningsinformationen väljer du Nästa.
- Om du uppmanas till det skapar du de nödvändiga anslutningarna och väljer Importera.
- Lämna rapportvärden för konversations-KPI:er as-is för tillfället. Du kan uppdatera dessa värden senare.
- Vänta tills importen har slutförts.
Uppgradera en befintlig lösning (GitHub)
För att uppgradera till den senaste versionen av Copilot-agentpaketet, följ dessa steg:
- Logga in på Power Apps.
- Välj miljön där du vill uppgradera Copilot-agentpaketet.
- Gå till Lösningar.
- Välj Importera lösning.
- Välj Bläddra.
- Välj CopilotStudioKit*_managed.zip.
- Klicka på Nästa. Power Apps inser att den här uppgraderingen är en befintlig hanterad lösning.
- Bekräfta att du vill uppgradera den befintliga lösningen genom att välja Nästa.
- Lämna rapportvärden för konversations-KPI:er as-is för tillfället. Du kan uppdatera dessa värden senare.
- Välj Importera.
Note
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-agentpaketet från Marketplace eller GitHub.
Tip
Copilot-agentpaketet inkluderar en installationsguide för att konfigurera anslutningsreferenser, miljövariabler och molnflöden. Lär dig mer i använda installationsguiden.
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:
- Installera Copilot-agentpaketet, som beskrivits tidigare i denna artikel.
- Logga in på Power Apps.
- Gå till Lösningar.
- Välj standardlösning.
- Välj Anslutningsreferenser.
- Hitta Copilot Agent Kit - SharePoint-anslutningsreferensen och öppna den för redigering.
- Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig. Skapa en ny anslutning till SharePoint efter behov.
- Välj Spara.
Mer information: Läs om hur du konfigurerar agenter i Copilot-agentpaketet, inklusive hur du 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 klienten. 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.
Efter att anslutningsreferenserna är uppsatta konfigurerar du miljöomfång, agenttyper, miljögrupper, inventariealternativ och synkroniseringsschemat från Agent Inventory. Läs mer i Konfigurera agentinventering.
Så här använder du funktionen Agentinventering:
- Installera Copilot-agentpaketet, som beskrivits tidigare i denna artikel.
- Logga in på Power Apps.
- Gå till Lösningar.
- Välj standardlösning.
- Välj Anslutningsreferenser.
- Hitta anslutningsreferensen Copilot Agent Kit - Power Platform for Admins och öppna den för redigering.
- Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig.
- Välj Spara.
- Hitta anslutningsreferensen Copilot Agent Kit - Dataverse och öppna den för redigering.
- Kontrollera att alla obligatoriska fält är ifyllda och att den valda anslutningen är giltig.
- Välj Spara.
Aktivera flöden
Note
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-agentpaketet, följ antingen dessa steg eller använd Installationsguiden.
- Installera Copilot-agentpaketet, som beskrivits tidigare i denna artikel.
- Logga in på Power Automate.
- Kontrollera att miljön med Copilot Agent Kit är vald.
- Välj Lösningar.
- Välj Copilot-agentpaketet.
- Välj Molnflöden.
- Kontrollera att alla flöden är aktiverade (Status = På).
- Aktivera alla flöden som inte är aktiverade i följande ordning:
- Flöden som slutar med Två nivåer under.
- Flöden som slutar med Underordnad.
- Resten av flödena efter behov, i valfri ordning.
Sätt upp Compliance Hub
Om du vill konfigurera Compliance Hub följer du stegen i Konfigurera och ställ in 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:
Installera Copilot-agentpaketet, som beskrivits tidigare i denna artikel.
Ladda nerConversation.KPIs.zip från Power CAT Copilot Agent Kit GitHub-arkivet.
Extrahera innehållet i zip-filen.
Öppna filen Conversation KPI:er.pbit i Power BI Desktop-programmet.
Ange Dataverse-URL:en som miljö-URL i dialogrutan som visas och välj Läs in (till exempel
org3c23948.crm.dynamics.com, utanhttps://prefixet).Om dialogrutan inte visas, ange Miljö-URL i Hem>Transformera data>Redigera parametrar.
Uppdatera data och logga in efter behov.
Spara och publicera på en arbetsyta.
Anteckna rapportnamnet och arbetsytans namn.
Logga in på Power BI.
Öppna den rapport som du publicerade och anteckna GUID för arbetsyta och rapport-GUID i URL:en.
Om du publicerar till ”Min arbetsyta” är arbetsytans GUID
00000000-0000-0000-0000-000000000000.Välj de tre prickarna (...) och sedan Visa semantisk modell.
Öppna Filinställningar>.
Kontrollera att autentiseringsuppgifterna för datakällan inte har några problem. Logga in för att åtgärda eventuella problem.
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.
- Logga in på Power Apps och välj den miljö där du installerade Copilot-agentpaketet.
- Välj Lösningar>Standardlösning.
- Välj Miljövariabler.
- Leta upp och välj Rapport för konversations-KPI:er.
- 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.
- Välj Spara.
Läs mer om konfigurering av agenter i Copilot-agentpaketet, inklusive hur du konfigurerar en ny agent för samtals-KPI:er.
Åtkomst till appen för Copilot-agentpaketet
För att komma åt appen för Copilot-agentpaketet:
- Logga in på Power Apps och välj den miljö där du installerade Copilot-agentpaketet.
- Gå till Appar.
- Hitta och välj Power CAT Copilot Agent Kit.
- Välj Spela upp.
- (Valfritt) Bokmärke för appen.
Dela appen Copilot Agent Kit
Efter att ha verifierat att appen startar utan problem behöver ägaren (eller systemadministratören som installerade Kit) dela appen för Copilot-agentpaketet med teamet.
- Logga in på Power Apps.
- Välj Program.
- Sök efter ”Copilot Agent Kit” och leta reda på det med typen Kod (inte den modellbaserade appen).
- Välj de tre punkterna (...) och välj sedan Dela bredvid appnamnet.
- Sök efter och lägg till de användare eller säkerhetsgrupper som behöver åtkomst.
- Välj Dela för att bekräfta.
Läs mer i Dela en canvas app med din organisation.