Installer Copilot Agent Kit

Copilot Agent Kit er et open source-værktøjssæt til test og evaluering af Copilot Studio-agenter. Det hjælper dig f.eks. med at definere testcases, simulere brugerforespørgsler og validere agentsvar. Denne artikel giver trin-for-trin instruktioner til installation af sættet fra Marketplace eller GitHub, sammen med trin efter udrulning og konfigurationsmuligheder.

Seddel

Før du downloader og installerer Copilot Agent Kit, skal du sikre dig, at du opfylder alle forudsætninger.

Installer Copilot Agent Kit fra Marketplace

Hvis du foretrækker at installere Copilot Agent Kit fra GitHub, så spring til Install Copilot Agent Kit fra GitHub.

Udrul fra Marketplace

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

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

Installationen af Copilot Agent Kit begynder.

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 Agent Kit - Dataverse og åbn det 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.

Installer Copilot Agent Kit fra GitHub

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

Download den nyeste version af GitHub

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

Installer Copilot Agent Kit managed zip-fil

For at installere Copilot Agent Kit administrerede løsning:

  1. Log på Power Apps.
  2. Vælg det miljø, hvor du vil installere Copilot Agent 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)

For at opgradere til den nyeste version af Copilot Agent Kit, følg disse trin:

  1. Log på Power Apps.
  2. Vælg det miljø, hvor du vil opgradere Copilot Agent 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.

Seddel

Når du opgraderer Copilot Agent Kit, kan du støde på følgende fejl: Løsning "Power CAT Copilot Agent Kit" kunne ikke importeres: ImportAsHolding mislykkedes med undtagelse: Kan ikke slette attribut: 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 Agent Kit fra Marketplace eller GitHub.

Tip!

Copilot Agent Kit inkluderer en opsætningsguide til at konfigurere forbindelsesreferencer, miljøvariabler og cloud-flows. Lær mere i 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.

Ret forbindelsen til SharePoint mod 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 bruger du SharePoint-synkroniseringsfunktionen:

  1. Installer Copilot Agent Kit, som tidligere beskrevet 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 Agent Kit - SharePoint 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.

Mere information: Lær om konfiguration af agenter i Copilot Agent Kit, herunder hvordan man 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 Agent Kit - Power Platform for Admins henter listen over miljøer i lejeren. Kræver tilladelser på administratorniveau til Power Platform.
  • Copilot Agent Kit - Dataverse indsamler agentinformation 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. Installer Copilot Agent Kit, som tidligere beskrevet 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 Agent 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 forbindelsesreferencen til Copilot Agent Kit - Dataverse 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 flow

Seddel

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 Agent Kit, skal du enten følge disse trin eller bruge Setup Wizard.

  1. Installer Copilot Agent Kit, som tidligere beskrevet i denne artikel.
  2. Log på Power Automate.
  3. Sørg for, at miljøet med Copilot Agent Kit er valgt.
  4. Vælg Løsninger.
  5. Vælg Copilot Agent 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, følg trinene i Opsætning og konfigurering af Copilot Agent Kit Compliance Hub. Compliance Hub kræver Agent Inventory.

Konfigurer det integrerede dashboard for samtale-KPI

Følg kun disse trin, 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. Installer Copilot Agent Kit, som tidligere beskrevet i denne artikel.

  2. Download Conversation.KPIs.zip fra Power CAT Copilot Agent Kit GitHub repository.

  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 ind på Power Apps og vælg det miljø, hvor du installerede Copilot Agent 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.

Lær om konfiguration af agenter i Copilot Agent Kit, herunder hvordan du konfigurerer en ny agent til samtale-KPI'er.

Få adgang til Copilot Agent Kit-appen

For at få adgang til Copilot Agent Kit-appen:

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

Del Copilot Agent Kit-appen

Efter at have bekræftet, at appen starter succesfuldt, skal ejeren (eller systemadministratoren, der installerede Kit'et) dele Copilot Agent Kit-appen med teamet.

  1. Log på Power Apps.
  2. Vælg Apps.
  3. Søg efter "Copilot Agent Kit" og find den med typen Code (ikke den modeldrevne app).
  4. Vælg de tre prikker (...), og vælg derefter Del ud for appnavnet.
  5. Søg efter og tilføj de brugere eller sikkerhedsgrupper, der har brug for adgang.
  6. Vælg Del for at bekræfte.

Få mere at vide i Del en lærredsapp med din organisation.

Næste trin