Installer Copilot Agent Kit

Copilot Agent Kit er et åpen kildekode-verktøysett for testing og evaluering av Copilot Studio-agenter. Det hjelper deg for eksempel med å definere testtilfeller, simulere brukerspørringer og validere agentsvar. Denne artikkelen gir trinnvise instruksjoner for installasjon av kitet fra Marketplace eller GitHub, sammen med steg etter utrulling og konfigurasjonsmuligheter.

Merk deg

Før du laster ned og installerer Copilot Agent Kit, sørg for at du oppfyller alle forutsetninger.

Installer Copilot Agent Kit fra Marketplace

Hvis du foretrekker å installere Copilot Agent Kit fra GitHub, hopp til Install Copilot Agent Kit fra GitHub.

Distribuer fra Marketplace

For å distribuere Copilot Agent Kit fra Marketplace, følg disse stegene:

  1. Gå til Copilot Agent Kit i Marketplace.
  2. Velg Hent den nå.
  3. Logg på om nødvendig.
  4. I visningen Install Copilot Agent Kit, velg miljøet der du vil sette ut Copilot Agent Kit.
  5. Se gjennom vilkårene og uttrykkene. Hvis du godtar det, merker du av i boksene og velger Installer.

Installasjonen av Copilot Agent Kit begynner.

Steg etter utrulling (Marketplace)

Når installasjonen er fullført, følger du disse trinnene etter distribusjon:

  1. Logg på Power Apps.
  2. Gå til Løsninger.
  3. Velg Standardløsning.
  4. Velg Tilkoblingsreferanser.
  5. Finn Copilot Agent Kit - Dataverse og åpne det for redigering.
  6. Kontroller at alle nødvendige felt er fylt ut, og at den valgte tilkoblingen er gyldig. Opprett en ny tilkobling til Dataverse etter behov.
  7. Velg Lagre.
  8. Følg ytterligere og valgfrie konfigurasjonstrinn.

Installer Copilot Agent Kit fra GitHub

Følg disse trinnene for å installere Copilot Agent Kit fra GitHub. Hvis du foretrekker å installere fra Marketplace, gå til Install Copilot Agent Kit fra Marketplace.

Last ned den nyeste GitHub-utgivelsen

Last ned den nyeste versjonen av den administrerte løsningen for Power CAT Copilot Agent Kit.

Installer Copilot Agent Kit administrert zip-fil

For å installere Copilot Agent Kit-administrert løsning:

  1. Logg på Power Apps.
  2. Velg miljøet der du vil installere Copilot Agent Kit.
  3. Gå til Løsninger.
  4. Velg Importer løsning.
  5. Velg Bla gjennom.
  6. Velg CopilotStudioKit*_managed.zip-filen .
  7. Velg Neste.
  8. Når du har gjennomgått løsningsinformasjonen, velger du Neste.
  9. Hvis du blir bedt om det, oppretter du de nødvendige tilkoblingene og velger Importer.
  10. La verdiene i rapporten for samtale-KPI-er stå slik de er for øyeblikket. Du kan oppdatere disse verdiene senere.
  11. Vent til importoperasjonen er fullført.

Oppgrader eksisterende løsning (GitHub)

For å oppgradere til den nyeste versjonen av Copilot Agent Kit, følg disse stegene:

  1. Logg på Power Apps.
  2. Velg miljøet hvor du vil oppgradere Copilot Agent Kit.
  3. Gå til Løsninger.
  4. Velg Importer løsning.
  5. Velg Bla gjennom.
  6. Velg CopilotStudioKit*_managed.zip.
  7. Velg Neste. Power Apps gjenkjenner at denne oppgraderingen er en eksisterende administrert løsning.
  8. Bekreft at du vil oppgradere den eksisterende løsningen ved å velge Neste.
  9. La verdiene i rapporten for samtale-KPI-er stå slik de er for øyeblikket. Du kan oppdatere disse verdiene senere.
  10. Velg Importer.

Merk deg

Når du oppgraderer Copilot Agent Kit, kan du støte på følgende feil: Løsning "Power CAT Copilot Agent Kit" mislyktes i å importere: ImportAsHolding mislyktes med unntak: Kan ikke slette attributt: cat_copilottestrunid fra Entity: cat_CopilotTestRun siden attributten ikke er et egendefinert felt.

Dette problemet er kjent og under etterforskning. Som en midlertidig løsning kan du utføre oppgraderingen før du bruker den. Finn ut mer i Oppgrader eller oppdater en løsning.

Ytterligere og valgfrie konfigurasjonstrinn

Disse konfigurasjonstrinnene gjelder enten du installerte Copilot Agent Kit fra Marketplace eller GitHub.

Tips

Copilot Agent Kit inkluderer en oppsettsveiviser for å konfigurere tilkoblingsreferanser, miljøvariabler og skyflyter. Lær mer ved å bruke Oppsettsveiviseren.

Konfigurere SharePoint-synkronisering

Følgende trinn er valgfrie og kreves bare hvis du planlegger å bruke SharePoint synkronisering-funksjonen. Du kan angi disse verdiene når som helst før du bruker funksjonen.

Pek koblingen til SharePoint-nettstedet til kildenettstedet SharePoint. Pek den dataverse URL-adressen til dataversforekomsten for de egendefinerte målagentene der innholdet synkroniseres.

Du kan følge disse trinnene eller bruke Setup-veiviseren til å konfigurere SharePoint tilkoblingsreferansen.

Slik bruker du SharePoint synkroniseringsfunksjonen:

  1. Installer Copilot Agent Kit, beskrevet tidligere i denne artikkelen.
  2. Logg på Power Apps.
  3. Gå til Løsninger.
  4. Velg Standardløsning.
  5. Velg Tilkoblingsreferanser.
  6. Finn Copilot Agent Kit - SharePoint-tilkoblingsreferansen og åpne den for redigering.
  7. Kontroller at alle nødvendige felt er fylt ut, og at den valgte tilkoblingen er gyldig. Opprett en ny tilkobling til SharePoint etter behov.
  8. Velg Lagre.

Mer informasjon: Lær om konfigurasjon av agenter i Copilot Agent Kit, inkludert hvordan du konfigurerer en ny agent for filsynkronisering.

Konfigurer agentlager

Følgende trinn er valgfrie og bare nødvendige hvis du planlegger å bruke Agent Inventory-funksjonen . Du kan angi disse verdiene når som helst før du bruker funksjonen.

Tilkoblingsreferansene i løsningen kontrollerer synligheten til agentene. Selv om du kan bruke andre kontoer, kan du bruke disse tillatelsene til å få full synlighet.

  • Copilot Agent Kit - Power Platform for Admins henter listen over miljøer i leietakeren. Krever tillatelser for administrasjonsnivå for Power Platform.
  • Copilot Agent Kit - Dataverse samler agentinformasjon fra miljøene. Krever tillatelser på systemadministratornivå for alle miljøer.

Du kan følge disse stegene eller bruke Oppsettsveiviseren for å konfigurere tilkoblingsreferansene til Agent Inventory.

Slik bruker du agentbeholdningsfunksjonen:

  1. Installer Copilot Agent Kit, beskrevet tidligere i denne artikkelen.
  2. Logg på Power Apps.
  3. Gå til Løsninger.
  4. Velg Standardløsning.
  5. Velg Tilkoblingsreferanser.
  6. Finn tilkoblingsreferansen til Copilot Agent Kit - Power Platform for Admins og åpne den for redigering.
  7. Kontroller at alle nødvendige felt er fylt ut, og at den valgte tilkoblingen er gyldig.
  8. Velg Lagre.
  9. Finn forbindelsesreferansen til Copilot Agent Kit - Dataverse og åpne den for redigering.
  10. Kontroller at alle nødvendige felt er fylt ut, og at den valgte tilkoblingen er gyldig.
  11. Velg Lagre.

Aktiver arbeidsflyter

Merk deg

Hvis du planlegger å bruke SharePoint synkronisering, Konfigurer SharePoint synkronisering før du aktiverer relaterte flyter (navn starter med SharePoint synkronisering).

For å aktivere skyflytene som er inkludert i Copilot Agent Kit, følg enten disse stegene eller bruk Oppsettveiviseren.

  1. Installer Copilot Agent Kit, beskrevet tidligere i denne artikkelen.
  2. Logg på Power Automate.
  3. Sørg for at miljøet med Copilot Agent Kit er valgt.
  4. Velg løsninger.
  5. Velg Copilot Agent Kit.
  6. Velg Skyflyter.
  7. Sørg for at alle flytene er aktivert (Status = På).
  8. Aktiver alle prosesser som ikke er aktivert, i denne rekkefølgen:
    1. Flyter som slutter med To nivåer lengre ned.
    2. Flyter som slutter med Underordnet.
    3. Resten av flytene kan utføres etter behov, i hvilken som helst rekkefølge.

Sett opp Compliance Hub

For å sette opp Compliance Hub, følg stegene i Sett opp og konfigurer Copilot Agent Kit Compliance Hub. Compliance Hub krever Agent Inventory.

Konfigurer det innebygde samtale-KPI-instrumentbordet

Følg disse trinnene bare hvis du planlegger å bruke det innebygde samtale-KPI-instrumentbordet.

Legg merke til følgende verdier under trinnene:

  • Navn på arbeidsområdet
  • Arbeidsområde-GUID
  • Rapportnavn
  • Rapport-GUID

Publiser rapporten

Slik publiserer du samtale-KPI-rapporten:

  1. Installer Copilot Agent Kit, beskrevet tidligere i denne artikkelen.

  2. Last Conversation.KPIs.zip ned fra Power CAT Copilot Agent Kit GitHub-arkivet.

  3. Pakk ut innholdet i .zip-filen.

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

  5. Skriv inn nettadressen for datavers som URL-adresse for miljø i dialogboksen som vises, og velg org3c23948.crm.dynamics.com (for eksempel uten https:// prefikset).

    Hvis dialogboksen ikke vises, skriver du inn url-adressen for miljø iRedigeringsparametere for >>.

  6. Oppdater data og logg på etter behov.

  7. Lagre og publiser i et arbeidsområde.

  8. Noter deg navnet på rapporten og arbeidsområdenavnet.

  9. Logg på Power BI.

  10. Åpne rapporten du publiserte, og noter GUID-en for arbeidsområdet og rapport-GUID-en i nettadressen.

    Hvis du publiserer til Mitt arbeidsområde, er GUID-en 00000000-0000-0000-0000-000000000000for arbeidsområdet .

  11. Velg de tre prikkene (...) og se semantisk modell.

  12. Åpne Filinnstillinger>.

  13. Kontroller at legitimasjonen for datakilden ikke har noen problemer. Logg på for å løse eventuelle problemer.

  14. Gå til Oppdater , og angi tidsplanen for oppdatering.

Oppdater variabelen for rapportmiljø

Hvis du vil konfigurere det innebygde samtale-KPI-instrumentbordet, oppdaterer du den relaterte miljøvariabelen med de riktige identifikatorene. Du kan enten følge disse stegene eller bruke oppsettsveiviseren.

  1. Logg inn på Power Apps og velg miljøet der du installerte Copilot Agent Kit.
  2. Velg Løsninger>Standardløsning.
  3. Velg miljøvariabler.
  4. Finn og velg Samtale KPI-er rapport.
  5. Erstatt plassholderne i standardverdien med verdiene arbeidsområdenavn, ARBEIDsområde-GUID, rapportnavn og rapport-GUID som du noterte under publiseringsprosessen.
  6. Velg Lagre.

Lær om hvordan du konfigurerer agenter i Copilot Agent Kit, inkludert hvordan du konfigurerer en ny agent for samtale-KPI-er.

Få tilgang til Copilot Agent Kit-appen

For å få tilgang til Copilot Agent Kit-appen:

  1. Logg inn på Power Apps og velg miljøet der du installerte Copilot Agent Kit.
  2. Gå til Apper.
  3. Finn og velg Power CAT Copilot Agent Kit.
  4. Velg Spill av.
  5. (Valgfritt) Bokmerke appen.

Del Copilot Agent Kit-appen

Etter å ha verifisert at appen startes vellykket, må eieren (eller systemadministratoren som installerte Kit) dele Copilot Agent Kit-appen med teamet.

  1. Logg på Power Apps.
  2. Velg Apper.
  3. Søk etter "Copilot Agent Kit" og finn den med typen Code (ikke den modelldrevne appen).
  4. Velg de tre prikkene (...), og velg deretter Del ved siden av appnavnet.
  5. Søk etter og legg til brukere eller sikkerhetsgrupper som trenger tilgang.
  6. Velg Del for å bekrefte.

Finn ut mer i Del en lerretsapp med organisasjonen.

Neste trinn: