Del via

Konfigurere Microsoft godkjenning for Copilot Studio Kit-testing

Denne artikkelen gir en oversikt over agenttestrammeverket og trinnvise instruksjoner for å konfigurere Microsoft godkjenning for testing Copilot Studio agenter ved hjelp av Agent Test Runner Power Apps Component Framework (PCF).

Arkitektur

Microsoft godkjenning gir en strømlinjeformet, nettleser-til-agent SDK-arkitektur som er optimalisert for testscenarioer. Denne fremgangsmåten muliggjør sikker kommunikasjon mellom testmiljøet og Copilot Studio agenter uten å kreve ekstra godkjenningsinfrastruktur.

Flytarkitektur

Følgende sekvensdiagram illustrerer godkjennings- og testkjøringsflyten.

Diagram som illustrerer SDK-arkitekturen for nettleser til agent for godkjenning og testing.

Komponentarkitektur

Diagrammet nedenfor illustrerer nøkkelkomponentene som er involvert i Microsoft godkjenningsflyt for Agent Test Runner.

Diagram som illustrerer de viktigste komponentene som er involvert i testflyten, inkludert nettlesermiljøet, Power Platform-tjenester og godkjenningstjenester.

Konfigurere Microsoft godkjenning

Konfigurasjonsprosessen innebærer å registrere programmet i Azure-portalen, hente agentidentifikatorer fra Copilot Studio og opprette en konfigurasjonspost i Dataverse.

Azure portal

Opprett en appregistrering i Azure portalen, legg til url-adressen for omadressering og konfigurer API-tillatelser.

Note

Hvis du har leieradministrasjonsrettigheter, kan du konfigurere API-tillatelser. Ellers må du kanskje be en leieradministrator om å gjøre det for deg.

  1. Opprett en appregistrering i Azure-portalen.

    Pass på at du kopierer både program-ID-en (klient) og ID-en for katalogen (leier). Du kan hente disse verdiene fra Oversikt-siden .

  2. Konfigurer API-tillatelser i Azure-portalen:

    1. Gå til API-tillatelser i appregistreringen.

    2. Velg Legg til en tillatelse.

    3. Velg API-ene organisasjonen min bruker fanen.

    4. Søk etter API for Power Platform.

      Note

      Hvis du ikke ser API-en for Power Platform i listen, må du legge til API-en i leieren. Følg instruksjonene på API-godkjenningstrinnet for Power Platform 2.

    5. Velg Delegerte tillatelser.

    6. Velg CopilotStudio.Copilots.Invoke under CopilotStudio.

    7. Velg Legg til tillatelser.

    8. Gi administratorsamtykke ved å velge Gi administratorsamtykke for <organisasjonen>. Hvis knappen ikke er tilgjengelig, må du kanskje be en leieradministrator om å gjøre det for deg.

  3. Legg til url-adressen for omadressering og konfigurer tokeninnstillinger i Azure portalen:

    1. Gå til Godkjenning i appregistreringen.

    2. Velg Legg til en plattform under Plattformkonfigurasjoner.

    3. Velg enkeltsideprogram.

    4. Skriv inn URL-adressen for miljøet ved hjelp av formatet: https://[your-org].crm.dynamics.com

    5. Velg både Access-tokener (brukes for implisitte flyter) og ID-tokener (brukes for implisitte og hybridflyter).

    6. Velg Konfigurer.

    7. Bekreft at kontotypene som støttes , bare er satt til Kontoer i denne organisasjonskatalogen.

Copilot Studio og datavers

I Copilot Studio kan du få agentens miljø-ID og agentidentifikator til å opprette en agentkonfigurasjonspost i Dataverse.

  1. I Copilot Studio:

    1. Kontroller at du er i riktig miljø.

    2. Velg agenten du vil teste, og kontroller at den er publisert.

    3. Velg Avanserte> fra Innstillinger.

    4. Kopier verdiene for miljø-ID og skjemanavn. Skjemanavnet er agentidentifikatoren og bruker formatet cr123_agentname.

  2. Opprett en agentkonfigurasjonspost i Dataverse med verdiene fra de forrige trinnene:

    Felt Verdi Eksempel
    Brukergodkjenning Microsoft godkjenning
    Klient-ID Program-ID (klient) fra trinn 1 under Azure portal. 00001111-aaaa-2222-bbbb-3333cccc4444
    Leier-ID Katalog-ID (utleier) fra trinn 1 i Azure-portalen. 11112222-bbbb-3333-cccc-4444dddd5555
    Miljø-ID Miljø-ID fra forrige trinn. 11111111-2222-3333-4444-555555555555
    Agentidentifikator Skjemanavn fra forrige trinn. cr123_testagent

Troubleshooting

Denne delen inneholder feilsøkingstrinn for vanlige feil du kan støte på.

Godkjenningsfeil

Feil: «AADSTS50011: Url-adressen for svar som er angitt i forespørselen, samsvarer ikke»

  • Årsak: Omadresser URI-samsvar i appregistrering.

  • Løsning:

    1. Gå til App registrations i Azure-portalen, og velg Manage>Authentication.
    2. Sørg for at omadresserings-URI-en samsvarer nøyaktig med miljø-URL-adressen.
    3. Bruk formatet: https://[your-org].crm.dynamics.com

Feil: «AADSTS65001: Brukeren eller administratoren har ikke samtykket»

  • Årsak: Manglende API-tillatelser eller administratorsamtykke.

  • Løsning:

    1. Gå til App registrations i Azure-portalen, og velg Administrering>API-tillatelser.
    2. Sørg for at CopilotStudio.Copilots.Invoke-tillatelse legges til.
    3. Velg Gi administratortillatelse.

Påloggingspopup vises hver gang

  • Årsak: Konto som ikke bufres eller nettleserinnstillinger hindrer tokenlagring.

  • Løsning:

    1. Sørg for at nettleseren tillater popup-vinduer for Dynamics domenet.
    2. Kontroller at nettleseren er i inkognito eller privat modus.
    3. Kontroller at nettleseren ikke blokkerer informasjonskapsler fra tredjeparter.
    4. Fjern hurtigbufferen i nettleseren, og prøv på nytt.
    5. Kontroller om organisasjonspolicyer tvinger godkjenning på nytt.

Feil: «InteractionRequiredAuthError» i nettleserkonsollen

  • Årsak: Normal virkemåte når stille godkjenning mislykkes og interaktiv pålogging utløses.

  • Forventet virkemåte:

    • Denne feilen oppstår når stille godkjenning mislykkes.
    • Systemet viser automatisk hurtigmeny for pålogging.

  • Handling kreves: Ingen.

Agent-SDK-feil

Feil: «Finner ikke 404 – Finner ikke agent»

  • Årsak: Feil agentidentifikator eller miljø-ID.

  • Løsning:

    1. Kontroller agentidentifikatoren (skjemanavnet) i Copilot Studio under Settings > Advanced > Metadata.
    2. Sørg for at miljø-ID-en samsvarer med miljøet der agenten publiseres.
    3. Bekreft at agenten er publisert og tilgjengelig.

Feil: «401 Uautorisert»

  • Årsak: Problemer med godkjenningstoken.

  • Løsning:

    1. Kontroller om brukeren har tilgang til Copilot Studio miljøet.
    2. Bekreft appregistreringstillatelser.
    3. Fjern hurtigbufferen for nettleseren, og prøv godkjenning på nytt.

Feil: «403 Forbudt»

  • Årsak: Utilstrekkelige tillatelser til å få tilgang til agent.

  • Løsning:

    1. Sørg for at brukeren har riktige sikkerhetsroller i Dataverse.
    2. Kontroller om agenten tillater brukerens sikkerhetsrolle.
    3. Bekreft miljøtillatelser.

Feil ved kontroll av agenttestkjører

Feil: «Kan ikke initialisere godkjenningstjenesten»

  • Årsak: Ugyldig konfigurasjon i agentkonfigurasjonsoppføringen.

  • Løsning:

    1. Kontroller at alle fire konfigurasjonsverdiene er riktige:
      • Klient-ID
      • Leier-ID
      • Miljø-ID
      • Agentidentifikator
    2. Se etter ekstra mellomrom eller ugyldige tegn.

Feil: «Ekstern tjenesteanrop blokkert»

  • Årsak: Mangler ekstern tjenestebruk.

  • Løsning:

    • For sluttbrukere i modelldrevne apper:
      • Denne feilen angir vanligvis et problem med distribusjon eller konfigurasjon.
      • Kontakt systemansvarlig eller utvikleren.
      • Ingen brukerhandling kan løse dette problemet, da det krever administrator- eller utviklerintervensjon.
    • For systemansvarlige:
      • Kontroller om sikkerhetspolicyer for organisasjoner blokkerer eksterne anrop.
      • Kontroller at brannmur- og proxyinnstillinger tillater tilkoblinger som kreves Microsoft domener.

Nettverks- og CORS-feil

Feil: «CORS-policy: Ingen «Access-Control-Allow-Origin»-topptekst

  • Årsak: Forespørsel om kryssopprinnelse blokkert.

  • Løsning:

    1. Sørg for at omadresserings-URI i Azure samsvarer med nøyaktig domene.
    2. Bruk HTTPS for alle URL-adresser.
    3. Kontroller at det ikke er noen problemer med blandet innhold (HTTP/HTTPS).

Feil: «Kan ikke hente»

  • Årsak: Problemer med nettverkstilkobling eller brannmur.

  • Løsning:

    1. Kontroller nettverkstilkoblingen til:
      • login.microsoftonline.com
      • api.powerplatform.com
    2. Kontroller at brannmuren tillater utgående HTTPS-trafikk.
    3. Kontroller proxy-innstillingene hvis det er aktuelt.

Testkjøringsfeil

Feil: «Tidsavbrudd for testkjøring»

  • Årsak: Agenten bruker for lang tid på å svare.

  • Løsning:

    1. Kontroller agentytelsen i Copilot Studio.
    2. Kontroller at agenten er publisert og fungerer.

Feil: «Kan ikke opprette samtale»

  • Årsak: Agent SDK-initialisering mislyktes.

  • Løsning:

    1. Bekreft at agenten er publisert.
    2. Kontroller agentkonfigurasjonen i Copilot Studio.
    3. Sørg for at agenten støtter testscenarioet.

Feilsøkingstips

  1. Aktiver utviklerverktøy for nettleseren:

    • Trykk F12 for å åpne utviklerverktøy.
    • Kontroller fanen Konsoll for JavaScript-feil.
    • Kontroller Nettverk-fanen for mislykkede forespørsler.

  2. Kontroller godkjenningsflyt:

    • Overvåk Nettverk-fanen under pålogging.
    • Se etter 200 svar fra login.microsoftonline.com.
    • Bekreft tokenoppkjøp i konsolllogger.

  3. Valider konfigurasjon:

    • Kontroller alle GUIDer og identifikatorer.
    • Kontroller at det ikke er ekstra mellomrom eller spesialtegn.
    • Bekreft tilgjengelighet for miljø og agent.

  4. Test isolert:

    • Prøv agenten direkte i Copilot Studio.
  • Last updated on