Del via


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 indeholder en trinvis vejledning i installation af pakken fra MarketplaceorGitHub sammen med trin efter udrulning og konfigurationsindstillinger.

Notat

Før du downloader og installerer Copilot Studio Kit, skal du sikre dig, at alle forespørgsler er opfyldt.

Installér Copilot Studio Kit fra Marketplace

Hvis du foretrækker at installere Copilot Studio Kit fra GitHub, skal du gå til Installer Copilot Studio Kit fra GitHub.

Udrul fra Marketplace

Hvis du vil installere Copilot Studio Kit fra Marketplace, skal du følge disse trin:

  1. Gå til Copilot Studio Kit i Marketplace.
  2. Vælg Start nu.
  3. Log på, hvis det er nødvendigt.
  4. I visningen Installer 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.

Trin 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 Save.
  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, skal du gå til Installer Copilot Studio Kit fra Marketplace.

Download den nyeste version af GitHub

Download den latest-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 anerkender, 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 indeholder en installationsguide til konfiguration af forbindelsesreferencer, miljøvariabler og cloudflows. Lær mere om brugen af Setup Wizard.

Konfigurer synkronisering af SharePoint

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

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

Du kan følge disse trin eller bruge guiden Setup til at konfigurere SharePoint forbindelsesreference.

Sådan bruges 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 Copilot Studio Kit – SharePoint forbindelsesreference, 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 for at SharePoint efter behov.
  8. Vælg Save.

Flere oplysninger: Få mere at vide om konfigurer agenter i Copilot Studio Kit, herunder hvordan du konfigurere 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 til administratorer 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 Copilot Studio Kit – Power Platform til administratorer forbindelsesreference, og åbn den til redigering.
  7. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig.
  8. Vælg Save.
  9. Find Copilot Studio Kit – Dataverse forbindelsesreference, og åbn den til redigering.
  10. Kontrollér, at alle obligatoriske felter er udfyldt, og at den valgte forbindelse er gyldig.
  11. Vælg Save.

Aktivér forbrugsdata

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

  1. Sørg for, at connectoren 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/

Screenshot, der viser konfigurationen af værts-URL-adressen til licensering som URL-adressen til basisressourcen for HTTP'en med Microsoft Entra ID connector.

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).

Hvis du vil aktivere de cloudflows, der er inkluderet i Copilot Studio Kit, skal du følge disse trin eller bruge guiden Setup.

  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

Hvis du vil konfigurere Compliance Hub, skal du følge trinnene i Konfigurer 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 Power CAT Copilot Studio Kit GitHub lager.

  3. Udpak indholdet af filen .zip.

  4. Åbn filen Conversation KPIs.pbit i programmet Power BI Desktop.

  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øetStartside>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 Save.

Mere oplysninger: Få mere at vide om konfigurer agenter i Copilot Studio Kit, herunder hvordan du konfigurere 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