Installér Copilot Studio Kit

Copilot Studio Kit er en værktøjspakke med åben kildekode til test og evaluering af Copilot Studio-agenter. Det giver dig f.eks. mulighed for at definere testcases, simulere brugerforespørgsler og validere agentsvar. Denne artikel giver trin-for-trin instruktioner til installation af sættet fra MarketplaceellerGitHub, sammen med efter-udrulningstrin og konfigurationsmuligheder.

Notat

Før du downloader og installerer Copilot Studio Kit, skal du sikre dig, at alle forudsætninger er opfyldt.

Installer Copilot Studio Kit fra Marketplace

Hvis du foretrækker at installere Copilot Studio Kit fra GitHub, skal du gå videre til Installér Copilot Studio Kit fra GitHub.

Udrul fra Marketplace

For at udrulle Copilot Studio Kit fra Marketplace, følg disse trin:

1. Navigér til Copilot Studio Kit i Marketplace.
2. Vælg Få det nu.
3. Log på, hvis det er nødvendigt.
4. I visningen Install Copilot Studio Kit skal du vælge det miljø, hvor du vil installere Copilot Studio Kit.
5. Gennemse vilkår og sætninger. Hvis du accepterer, skal du markere afkrydsningsfelterne og vælge Installér.

Installationen af Copilot Studio Kit starter.

Skridt efter udrulning (Marketplace)

Når installationen er fuldført, skal du følge disse trin efter installationen:

1. Log på Power Apps.
2. Gå til Løsninger.
3. Vælg Standardløsning.
4. Vælg Forbindelsesreferencer.
5. Find Copilot Studio Kit – Dataverse, og åbn den til redigering.
6. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig. Opret en ny forbindelse til Dataverse efter behov.
7. Vælg Gem.
8. Følg yderligere og valgfri konfigurationstrin.

Installér Copilot Studio Kit fra GitHub

Følg disse trin for at installere Copilot Studio Kit fra GitHub. Hvis du foretrækker at installere fra Marketplace, så gå til Install Copilot Studio Kit fra Marketplace.

Download den nyeste GitHub-version

Download den nyeste version af den administrerede løsning til Power CAT Copilot Studio Kit.

Installér CopilotStudioKit-administreret zip-fil

Sådan installerer du den administrerede Copilot Studio Kit-løsning:

1. Log på Power Apps.
2. Vælg det miljø, hvor du vil installere Copilot Studio Kit.
3. Gå til Løsninger.
4. Vælg Importér løsning.
5. Vælg Gennemse.
6. Vælg filen CopilotStudioKit*_managed.zip .
7. Vælg Næste.
8. Når du har gennemset løsningsoplysningerne, skal du vælge Næste.
9. Hvis du bliver bedt om det, skal du oprette de nødvendige forbindelser og vælge Importér.
10. Lad samtale-KPI'ers rapportværdier være som de er indtil videre. Du kan opdatere disse værdier senere.
11. Vent, indtil importhandlingen er fuldført.

Opgrader eksisterende løsning (GitHub)

Hvis du har installeret en tidligere version af Copilot Studio Kit og vil opgradere til den nyeste version, skal du følge disse trin:

1. Log på Power Apps.
2. Vælg det miljø, hvor du vil opgradere Copilot Studio Kit.
3. Gå til Løsninger.
4. Vælg Importér løsning.
5. Vælg Gennemse.
6. Vælg CopilotStudioKit*_managed.zip.
7. Vælg Næste. Power Apps genkender, at denne opgradering er en eksisterende administreret løsning.
8. Bekræft, at du vil opgradere den eksisterende løsning ved at vælge Næste.
9. Lad samtale-KPI'ers rapportværdier være som de er indtil videre. Du kan opdatere disse værdier senere.
10. Vælg Importér.

Notat

Under opgraderingen af Copilot Studio Kit kan der opstå følgende fejl: "Løsningen "Power CAT Copilot Studio Kit" blev ikke importeret: ImportAsHolding mislykkedes med undtagelsen: Attributten kan ikke slettes: cat_copilottestrunid fra Entity: cat_CopilotTestRun da attributten ikke er et brugerdefineret felt."

Dette problem er kendt og undersøges. Du kan løse problemet ved at iscenelægge opgraderingen, før du anvender den. Få mere at vide under Opgrader eller opdater en løsning.

Yderligere og valgfri konfigurationstrin

Disse konfigurationstrin gælder, uanset om du har installeret Copilot Studio Kit fra Marketplace eller GitHub.

Tips

Copilot Studio Kit inkluderer en opsætningsguide til at konfigurere forbindelsesreferencer, miljøvariabler og cloud-flows. Lær mere om brugen af Setup Wizard.

Konfigurer SharePoint-synkronisering

Følgende trin er valgfrie og kræves kun, hvis du planlægger at bruge sharePoint-synkroniseringsfunktionen . Du kan når som helst angive disse værdier, før du bruger funktionen.

Peg forbindelsen til SharePoint til SharePoint-kildewebstedet. Peg dataverse-URL-adressen på Dataverse-forekomsten for de brugerdefinerede målagenter, hvor indholdet synkroniseres.

Du kan følge disse trin eller bruge Installationsguiden til at konfigurere SharePoint-forbindelsesreferencen.

Sådan bruger du SharePoint-synkroniseringsfunktionen:

1. Installér Copilot Studio Kit, der er beskrevet tidligere i denne artikel.
2. Log på Power Apps.
3. Gå til Løsninger.
4. Vælg Standardløsning.
5. Vælg Forbindelsesreferencer.
6. Find Referencen til Copilot Studio Kit – SharePoint-forbindelsen , og åbn den til redigering.
7. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig. Opret en ny forbindelse til SharePoint efter behov.
8. Vælg Gem.

Flere oplysninger: Få mere at vide om konfiguration af agenter i Copilot Studio Kit, herunder hvordan du konfigurerer en ny agent til filsynkronisering.

Konfigurer agentlager

Følgende trin er valgfrie og kræves kun, hvis du planlægger at bruge funktionen Agentlager . Du kan når som helst angive disse værdier, før du bruger funktionen.

Forbindelsesreferencerne i løsningen styrer agenternes synlighed. Selvom du kan bruge andre konti, kan du bruge disse tilladelser til at få fuld synlighed.

• Copilot Studio Kit – Power Platform for Admins henter listen over miljøer i lejeren. Kræver tilladelser på administratorniveau til Power Platform.
• Copilot Studio Kit – Dataverse indsamler agentoplysningerne fra miljøerne. Kræver tilladelser på systemadministratorniveau til alle miljøer.

Du kan følge disse trin eller bruge Setup Wizard til at konfigurere Agent Inventory-forbindelsesreferencerne.

Sådan bruger du funktionen Agentlager:

1. Installér Copilot Studio Kit, der er beskrevet tidligere i denne artikel.
2. Log på Power Apps.
3. Gå til Løsninger.
4. Vælg Standardløsning.
5. Vælg Forbindelsesreferencer.
6. Find forbindelsesreferencen til Copilot Studio Kit – Power Platform for Admins , og åbn den til redigering.
7. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig.
8. Vælg Gem.
9. Find Referencen til Copilot Studio Kit – Dataverse-forbindelsen, og åbn den til redigering.
10. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig.
11. Vælg Gem.

Aktivér forbrugsdata

Hvis du vil aktivere valgfrie forbrugsdata i agentlageret, skal du udføre følgende trin:

1. Sørg for, at connector-HTTP med Microsoft Entra-id (forhåndsgodkendt) er tilladt i dit miljø.
2. Importér filen AgentInventoryUsage*_managed.zip fra GitHub-lageret i Power CAT Copilot Studio Kit.
3. Under importprocessen skal du oprette en forbindelse ved hjælp af URL-adressen til licensværten: https://licensing.powerplatform.microsoft.com/

Aktivér flow

Notat

Hvis du planlægger at bruge SharePoint-synkronisering, skal du konfigurere SharePoint-synkronisering , før du aktiverer de relaterede flow (navne starter med SharePoint-synkronisering).

For at aktivere de cloud-flows, der er inkluderet i Copilot Studio Kit, skal du enten følge disse trin eller bruge Setup Wizard.

1. Installér Copilot Studio Kit, der er beskrevet tidligere i denne artikel.
2. Log på Power Automate.
3. Sørg for, at miljøet med Copilot Studio Kit er valgt.
4. Vælg Løsninger.
5. Vælg Copilot Studio Kit.
6. Vælg Cloudflows.
7. Sørg for, at alle flow er aktiveret (Status = Til).
8. Aktivér alle flow, der ikke er aktiveret, i følgende rækkefølge:
   1. Flows, der ender med Underordnet.
   2. Flows, der slutter med Child.
   3. Resten af flowene vises efter behov i vilkårlig rækkefølge.

Opsæt Compliance Hub

For at opsætte Compliance Hub'en skal du følge trinene i Opsætning og konfigurering af Copilot Studio Kit Compliance Hub. Compliance Hub kræver Agent Inventory.

Konfigurer det integrerede dashboard for samtale-KPI

Disse trin er kun påkrævet, hvis du planlægger at bruge dashboardet med integrerede samtale-KPI'er.

Under trinnene skal du notere dig følgende værdier:

• Navn på arbejdsområde
• Arbejdsområde-GUID
• Rapportnavn
• Rapport GUID

Udgiv rapporten

Sådan publicerer du rapporten Samtale-KPI'er:

1. Installér Copilot Studio Kit, der er beskrevet tidligere i denne artikel.

2. Download Conversation.KPIs.zip fra GitHub-lageret til Power CAT Copilot Studio Kit.

3. Udpak indholdet af filen .zip.

4. Åbn filen Conversation KPI'er.pbit i Power BI Desktop-programmet.

5. Angiv URL-adressen til Dataverse som URL-adressen for miljøet i den dialogboks, der vises, og vælg Indlæs (f.eks. org3c23948.crm.dynamics.comuden præfikset https:// ).

   Hvis dialogboksen ikke vises, skal du angive URL-adressen til miljøet på Startside>Transformér data>Rediger parametre.

6. Opdater data, og log på efter behov.

7. Gem og publicer i et arbejdsområde.

8. Notér navnet på rapporten og navnet på arbejdsområdet.

9. Log på Power BI.

10. Åbn den rapport, du har publiceret, og bemærk GUID for arbejdsområdet og rapport-GUID i URL-adressen.

    Hvis du publicerer til "Mit arbejdsområde", er GUID for arbejdsområdet 00000000-0000-0000-0000-000000000000.

11. Vælg de tre prikker (...) og vælg derefter Semantisk model.

12. Åbn Filindstillinger>.

13. Kontrollér, at der ikke er problemer med legitimationsoplysningerne for datakilden . Log på for at løse eventuelle problemer.

14. Gå til Opdater, og angiv tidsplanen for opdatering.

Opdater rapportmiljøvariablen

Hvis du vil konfigurere dashboardet med integrerede samtale-KPI'er, skal du opdatere den relaterede miljøvariabel med de korrekte id'er. Du kan enten følge disse trin eller bruge Setup Wizard.

1. Log på Power Apps , og vælg det miljø, hvor du har installeret Copilot Studio Kit.
2. Vælg Løsninger>Standardløsning.
3. Vælg Miljøvariabler.
4. Find og vælg Samtale-KPI'er Rapport.
5. Erstat pladsholderne i standardværdien med værdierne For arbejdsområdenavn, Arbejdsområde-GUID, Rapportnavn og Rapport-GUID , som du noterede under publiceringsprocessen.
6. Vælg Gem.

Flere oplysninger: Få mere at vide om konfiguration af agenter i Copilot Studio Kit, herunder hvordan du konfigurerer en ny agent til samtale-KPI'er.

Få adgang til Appen Copilot Studio Kit

Sådan får du adgang til Appen Copilot Studio Kit:

1. Log på Power Apps , og vælg det miljø, hvor du har installeret Copilot Studio Kit.
2. Gå til Apps.
3. Find og vælg Power CAT Copilot Studio Kit.
4. Vælg Afspil.
5. (Valgfrit) Bogmærke for appen.

Næste trin

Konfigurer brugere og teams