Feilsøk agentsamtaler med Agent Debugger i Copilot-agentsett

Agent Debugger er et diagnostisk verktøy som hjelper deg med å laste inn en innspilt samtale og inspisere hver beslutning agenten har tatt. For hver samtalerunde kan du gjennomgå utførelsesbanen, stegtiming, tokenbruk, kunnskapskilder, stegargumenter og iverksetterens resonnement.

Agent Debugger støtter to datakilder:

• Samtaletranskripsjon (Dataverse): Når en samtale kjøres i Copilot Studio, registrerer plattformen en aktivitetslogg som en samtaletranskripsjon i Dataverse. Agent Debugger spør direkte i disse postene, så enhver publisert agent med transkripsjonsdata er umiddelbart tilgjengelig.
• Copilot Studio snapshot (ZIP): Copilot Studio testpanel inkluderer et nedlastingsøyeblikksbilde-alternativ som eksporterer den nåværende testsamtalen som en ZIP-fil. Å laste opp den filen til Agent Debugger gir deg full analysevisning uten Dataverse-tilkobling. Denne metoden er nyttig for å feilsøke preproduksjonssamtaler, gjenskape problemer offline, eller dele en mislykket økt med en kollega.

Begge datakildene gir tilgang til det samme analysegrensesnittet. Panelene, trinndetaljene og visualiseringene er de samme uansett hvordan dataene lastes inn.

Forutsetning

For å bruke Agent Debugger, sørg for at følgende forutsetninger er oppfylt:

• Agenten er til stede i Agent Inventory og har minst én samtaletranskripsjon registrert mot seg. Du kan verifisere denne betingelsen ved å åpne Agent Inventory-listen, velge agenten og velge Vis mer for å utvide de ekstra feltene. Feltet Er transkripsjon tilgjengelig må settes til Ja. Agent Inventory-synkroniseringen setter automatisk dette feltet når det finnes minst én samtaletranskripsjon for agenten i Dataverse.
• Den innloggede brukeren har CSK - Administrator eller Systemadministrator sikkerhetsrollen i pakkemiljøet.
• Den innloggede brukeren har lese-tilgang på conversationtranscripts, bot, og botcomponents-tabellene i målmiljøet.

Velg en samtale

Når du åpner Agent Debugger, gir filterlinjen kontrollene du trenger for å finne en samtale å analysere.

Etter at du har valgt en Samtale ID, blir Analyser tilgjengelig. Velg den for å åpne analysevisningen.

Last opp et øyeblikksbilde fra Copilot Studio

Fanen Last opp øyeblikksbilde gir et alternativt inngangspunkt som ikke krever tilgang til Dataverse. I stedet for å velge en live samtale fra nedtrekksmenyene, laster du opp en ZIP-fil med øyeblikksbilde lastet ned fra Copilot Studios testpanel.

For å laste ned et øyeblikksbilde fra Copilot Studio:

1. Åpne agenten din i Copilot Studio og gå til panelet Test agenten din.
2. Kjør eller gjennomgå en samtale.
3. Velg Last ned øyeblikksbilde i testpanelets verktøylinje.

Copilot Studio laster ned en .zip fil som inneholder:

• dialog.json: Alle Bot Framework-aktiviteter for samtalen (påkrevd).
• botContent.yml: Agentens fullstendige komponent- og flytdefinisjoner, brukt til å løse stegnavn (valgfritt; hvis fraværende, vises rå skjemanavn).

For å laste opp et øyeblikksbilde til Agent Debugger:

1. Bytt til fanen Last opp øyeblikksbilde i Agent Debugger-headeren.
2. Dra og slipp .zip-filen i slippsonen, eller velg for å bla etter den.

Agent Debugger validerer ZIP-en, pakker ut filene og åpner analysevisningen. Ingen valg av miljø, agent eller samtale er nødvendig. Alle generelle informasjonsmålinger er hentet fra den opplastede filen.

Bruk Last opp øyeblikksbilde-modus når du trenger:

• Feilsøk en samtale som fant sted i testpanelet før agenten ble publisert.
• Analyser en samtale fra et miljø du ikke kan autentisere deg mot.
• Reproduser problemer offline eller del en mislykket økt med en kollega uten å gi Dataverse-tilgang.
• Valider agentens atferd i et lokalt utviklingsmiljø.

Analyser en samtale

Analysevisningen åpnes etter at du har valgt Analyser eller last opp et øyeblikksbilde. Den inneholder en sammendragsrad med Generell informasjon øverst, en sammenleggbar analysedel med fire paneler (Utførelsessti, Ytelsestidslinje, Agentdetaljer og Anbefalinger), og et oppsett med to paneler som viser Forhåndsvisning av samtalen ved siden av Feilsøkingsinformasjon-panelet.

Generell informasjon

Den generelle informasjonsraden viser sammendragsmål-fliser for samtalen.

Når en menneskelig agent lastes inn, vises en Åpne agent-lenke i den generelle informasjonsheaderen. Lenken åpner agentens konfigurasjonsside i Copilot Studio.

Utførelsesbane

Kjøringsstien gjengir hele utførelsesrekkefølgen over alle samtaleturer som et rettet flytdiagram. Stegene går fra venstre til høyre i utførelsesrekkefølge. Strupte vertikale linjer markerer svinggrenser, og hver brukermelding starter en ny seksjon. Vendeetiketter vises øverst i hver seksjon. Ved å velge en turetikett ruller samtaleforhåndsvisningen til den meldingen.

Hver trinntype bruker en egen farge, og en forklaring nederst i diagrammet kartlegger farger til trinnkategorier som Emne, Kunnskap, Verktøy, Kobling, Flyt, Kode, MCP og Tilkoblet agent. Hver node viser stegnavnet og utførelsestiden. Mislykkede steg er markert med rødt. Tilkoblede agenter vises som beholderbokser som grupperer de underordnede stegene de utførte.

Ytelsestidslinje

Ytelsestidslinjen viser et fossefallsdiagram over utførelsestider gruppert etter samtalevending. Trinnstolpene skaleres etter svingens totale varighet for å gjøre relativ timing synlig. Fargekoding matcher utførelsesvei-legenden, og mislykkede steg vises i rødt.

Panelet omfatter følgende funksjoner:

• Utvid/Slå sammen alle-knapper slår alle turseksjoner samtidig. Hver svingseksjon er også sammenleggbar individuelt.
• Statistikk per tur viser antall skritt, navnet og varigheten på det tregeste steget, samt antall feil.
• En global oppsummering øverst viser totalt antall steg, total forløpt tid, det tregeste steget i hele samtalen, og totalt antall feil.
• Steg som er tregere enn 10 sekunder flagges med en advarselsindikator.

Agentdetaljer

Agentens detaljpanel viser hele konfigurasjonen av agenten slik den eksisterte da samtalen ble analysert. Informasjonen er organisert i seks faner.

Anbefalinger

Anbefalingspanelet oppdager automatisk problemer i samtalen og fremhever dem som handlingsrettede kort med alvorlighetsvurderinger.

Følgende problemtyper oppdages:

Hvert anbefalingskort viser alvorlighetsikonet og fargen, et kategorimerke, tittel og beskrivelse av det oppdagede problemet, et forslag til hvordan man kan undersøke eller løse det, og en Kjør til vend-knapp som ruller samtaleforhåndsvisningen til den relevante brukermeldingen. Når ingen problemer oppdages, viser panelet en melding om tom tilstand.

Forhåndsvis en samtale

Samtaleforhåndsvisningspanelet viser hele samtaleutvekslingen slik den fremsto for brukeren, inkludert bot- og brukerbobler, dynamiske kort gjengitt i line, foreslåtte handlingsbrikker og tilbakemeldingsprompter.

Å velge en brukermeldingsboble laster inn trinnene til Debug-informasjonspanelet. Den valgte meldingen er markert slik at du kan spore hvilken runde som er aktiv. Panelet kan rulles uavhengig. Ved å velge Vis JSON i samtaleforhåndsvisningen åpnes hele transkripsjonsdialogen for JSON.

Feilsøkingsinformasjon

Feilsøkingsinformasjonspanelet viser trinnivådetaljer for den valgte brukermeldingsrunden. Panelet inkluderer en stegliste til venstre og en trinndetaljvisning som åpnes når du velger et steg.

Steglisten viser hvert iverksettertrinn utført for den valgte runden, med et stegikon og farge som angir stegtype, stegnavn (løst til et vennlig visningsnavn der mulig), utførelsesvarighet, og en suksess- eller feilindikator. Trinn som tilhører en tilkoblet agent grupperes i et sammenleggbart beholderkort som viser agentens navn og total kjøretid. En Last-tilkoblet agent detaljer-knapp på beholderen laster den underordnede agentens fullstendige transkripsjon på forespørsel.

Følgende stegtyper støttes:

Ved å velge et trinn åpnes et detaljpanel med følgende seksjoner, vist når dataene er til stede i transkripsjonen:

• Tankegang: Iverksetterens resonnementstekst nedtegnet før steget ble påkalt. Viser hvordan modellen bestemte seg for å kalle dette steget og hva den forventet av det.
• Trinntype: Klassifisert etikett for trinnet.
• Argumenter: En sammenleggbar JSON-trevisning av inndataparametrene som sendes til trinnet. Inkluderer et kopieringsalternativ for å fange JSON-filen for supporthenvendelser.
• Observasjon: Utgangs- eller returverdien fra trinnet. Vises også som et sammenleggbart JSON-tre med kopistøtte.
• Kodeforhåndsvisning: For Python-kodesteg vises kildekoden med syntaksmarkering.
• Tokenbruk: Prompt token-telling, fullføringstoken og total for steget, sammen med modellnavnet som brukes.
• Kunnskapskilder: Kilder som ble søkt i, resultater returnert (utdata), og kilder som faktisk ble sitert i det endelige svaret. Hver oppføring viser kildenavn, type, URL der det er tilgjengelig, og en lenke for å åpne kilden.
• MCP-serverinfo: For MCP-steg vises serverens protokollversjon, deklarerte kapasiteter og listen over verktøy serveren ga under initialiseringen.
• Feilinformasjon: Når et steg feilet, vises feilkoden, feilmeldingen og (for ansvarlig KI-blokker) innholdssikkerhetskategorien som utløste filteret.
• Dynamiske kort: Når steget gir et Dynamisk kort-svar, vises kortet inline i detaljpanelet akkurat slik brukeren ville ha sett det.

Utskrift JSON

Når du velger Vis JSON i samtaleforhåndsvisningshodet, åpnes en dialogboks som viser de fullstendige rå transkripsjonsaktivitetene med syntaksmarkering, fulltekstsøk i JSON-treet, og et kopier-til-utklippstavle-alternativ for hele nyttelasten.

Bruk denne visningen når:

• Du må inspisere en hendelsestype som ikke vises i Feilsøkingsinformasjon-panelet.
• Du vil kopiere spesifikke felt for en støtteforespørsel.
• Du undersøker uventet atferd i de analyserte visningene.

Feilsøking

De følgende seksjonene beskriver vanlige problemer og hvordan de kan løses.

Agent vises ikke i nedtrekksmenyen Miljø eller Agent

Agenten er ikke synkronisert med Agent Inventory, eller den har ingen transkripsjoner av samtaler.

Slik løser du dette problemet:

1. Kjør en manuell Agent Inventory-synkronisering for miljøet.
2. Verifiser at agentposten finnes i tabellen Agent Detaljer i Dataverse.
3. Sjekk at kolonnen Er Transkripsjon Tilgjengelig er satt til Ja på registeret. Synkroniseringen setter dette feltet når det finnes minst ett transkript.

For mer informasjon, se Overvåk agenter som bruker Agent Inventory i Copilot Agent Kit.

Samtale-ID finnes ikke i nedtrekksmenyen

For ytelse forhåndslaster nedtrekksmenyen kun de 50 siste samtalene innenfor det aktive tidsrommet. Eldre transkripsjoner eksisterer fortsatt i Dataverse, men vises ikke som standard. Alternativt kan det hende at transkripsjonen ikke er skrevet ennå hvis samtalen nettopp er avsluttet.

Slik løser du dette problemet:

1. Skriv inn samtale-ID-en direkte i feltet Samtale-ID. Å skrive utløser et fullstendig søk på tvers av alle transkripsjoner etter den agenten, uten å ta hensyn til tidsrommet.
2. Hvis tidsintervallet er smalt (for eksempel siste 30 minutter), utvid det eller bytt til et tilpasset intervall som dekker samtaledatoen.
3. Hvis samtalen nettopp er ferdig, vent 35-40 minutter på at transkripsjonen skal skrives til Dataverse, og oppdater deretter.

Analyser belastninger, men ingen steg vises i Debug-informasjonspanelet

Transkripsjonen eksisterer, men inneholder kun meldingsaktiviteter uten diagnostiske sporhendelser. Dette problemet oppstår vanligvis når samtalen kommer fra en kanal som ikke sender ut sporingsdata, som visse tilpassede kanaler eller eldre skjemaversjoner.

Slik løser du dette problemet:

1. Velg Vis JSON i samtaleforhåndsvisningsheaderen for å bekrefte at aktiviteter er til stede.
2. Se etter type: "trace" våre type: "event" oppføringer. Hvis de er fraværende, kan det hende kanalen ikke sender ut sporingsdata.

Tilgang nektet eller blank side ved lasting

Roller eller tillatelser mangler i ett eller begge miljøer.

Slik løser du dette problemet:

1. I pakkemiljøet må du sørge for at brukeren har rollen CSK - Administrator eller Systemadministrator.
2. I målmiljøet må du sørge for at den påloggede brukeren har lesetilgang til tabellene conversationtranscripts, bot og botcomponents.

Transkripsjonene virker ufullstendige (mangler tidlige meldinger)

Lange samtaler er fordelt på flere Dataverse-poster (1 MB grense per post). Hvis oppbevaringspolicyen fjerner noen arkiver, har den sammenslåtte utskriften hull.

Slik løser du dette problemet:

1. Dataverse fjerner som standard samtaletranskripsjoner eldre enn 30 dager. Hvis bevaring er problemet, oppdater planen for massesletting av jobbplanen i Power Apps>Innstillinger>Avanserte innstillinger>Databehandling>Massesletting.
2. Hvis oppbevaring ikke er årsaken, verifiser du at alle transkripsjonsposter for samtalen finnes i conversationtranscripts-tabellen i Dataverse.

Trinn viser rå skjemanavn i stedet for lesbare emnenavn

Tabelloppslaget botcomponents feilet, eller komponentposten ble slettet.

Slik løser du dette problemet:

1. Bekreft at den påloggede brukeren har lesetilgang til botcomponents-tabellen i målmiljøet.
2. Hvis komponenten ble slettet fra Copilot Studio, finnes det ingen matchende post, og Agent Debugger faller tilbake til det rå skjemanavnet, for eksempel cr123_mytopic. Denne oppførselen forventes for slettede temaer eller handlinger.

Agentens detaljpanel viser ingen data

Agentkonfigurasjonshentingen feilet, eller den innloggede brukerens tilkobling har ikke lesetilgang til tabellene bot og botcomponents i målmiljøet.

Slik løser du dette problemet:

1. Sjekk lesetilgang til bot og botcomponents-tabellene for tilkoblingsreferansen som appen bruker.
2. Hvis agenten ble slettet eller ikke publisert etter at samtalen ble spilt inn, kan konfigurasjonspostene ikke lenger eksistere. I dette tilfellet forblir panelet Agent-detaljer tomt, men transkripsjons- og feilsøkingspanelene er fortsatt fullt funksjonelle.

Anbefalingspanelet viser ingen problemer, men samtalen mislyktes

Anbefalinger kommer fra mønstre i transkripsjonssporingshendelsene. Hvis transkripsjonen mangler sporingsdata, eller hvis feilen skjer utenfor samtalen (for eksempel en stille nettverkstidsavbrudd som transkripsjonen ikke registrerer), genererer ikke systemet noen anbefalinger.

Slik løser du dette problemet:

1. Åpne transkripsjons-JSON for å se etter rå feilpayloads som ikke vises som en anbefaling.
2. Sjekk kjørebanen for eventuelle steg som er vist i rødt. Disse trinnene indikerer feil som ikke samsvarer med et kjent anbefalingsmønster.

Relatert informasjon

• Overvåk agenter med agentbeholdning i Copilot Agent Kit
• Konfigurer agenter i Copilot-agentsett
• Oversikt over Copilot-agentsettet