Fejlfinding af agentsamtaler med Agentfejlfinding i Copilot Agent Kit

Agentfejlfinding er et diagnosticeringsværktøj, der hjælper dig med at indlæse en optaget samtale og inspicere hver beslutning, en agent har truffet. For hver samtalerunde kan du gennemgå udførelsesstien, trintiming, tokenbrug, videnskilder, trinargumenter og organisatorens ræsonnement.

Agentfejlfinding understøtter to datakilder:

• Samtaleafskrift (Dataverse): Når en samtale kører i Copilot Studio, registrerer platformen en aktivitetslog som en samtaleafskrift i Dataverse. Agentfejlfinding forespørger disse poster direkte, så enhver offentliggjort agent med afskriftsdata er straks tilgængelig.
• Copilot Studio-snapshot (ZIP): Copilot Studio-testpanelet inkluderer indstillingen Download snapshot, der eksporterer den aktuelle testsamtale som en ZIP-fil. Hvis du uploader den fil til Agentfejlfinding, får du en fuld analysevisning uden en Dataverse-forbindelse. Denne metode er nyttig til fejlfinding af samtaler før produktion, gengivelse af problemer offline eller deling af en mislykket session med en kollega.

Begge datakilder leverer den samme analysegrænseflade. Panelerne, trindetaljerne og visualiseringerne er de samme, uanset hvordan dataene indlæses.

Forudsætninger

For at bruge Agentfejlfinding skal du sikre, at følgende forudsætninger er opfyldt:

• Agenten er til stede i Agentlager og har mindst én samtaleafskrift optaget mod sig. Du kan bekræfte denne betingelse ved at åbne listevisningen Agentlager, vælge agenten og vælge Vis mere for at udvide de ekstra felter. Feltet Er afskrift tilgængelig skal indstilles til Ja. Synkroniseringen af Agentlager indstiller automatisk dette felt, når der findes mindst én samtaleafskrift for agenten i Dataverse.
• Den bruger, der er logget på, har sikkerhedsrollen CSK - Administrator eller Systemadministrator i pakkemiljøet.
• Den bruger, der er logget på, har læseadgang til tabellerne conversationtranscripts, bot og botcomponents i målmiljøet.

Vælg en samtale

Når du åbner Agentfejlfinding, giver filterlinjen de kontroller, du har brug for til at finde en samtale, der skal analyseres.

Når du har valgt et samtale-id, bliver Analyse tilgængelig. Vælg den for at åbne analysevisningen.

Upload et snapshot fra Copilot Studio

Fanen Upload snapshot giver et alternativt indgangspunkt, der ikke kræver adgang til Dataverse. I stedet for at vælge en live samtale fra rullelisterne, uploader du en snapshot-ZIP-fil, der er downloadet fra Copilot Studios-testruden.

Sådan uploader du et snapshot fra Copilot Studio:

1. Åbn din agent i Copilot Studio, og gå til panelet Test din agent.
2. Kør eller gennemse en samtale.
3. Vælg Download snapshot i testpanelets værktøjslinje.

Copilot Studio downloader en .zip-fil, der indeholder:

• dialog.json: Alle Bot Framework-aktiviteter for samtalen (påkrævet).
• botContent.yml: Agentens fulde komponent- og flowdefinitioner, brugt til at løse trinnavne (valgfrit. Hvis ikke til stede, vises rå skemanavne).

Sådan uploader du et snapshot til Agentfejlfinding:

1. Skift til fanen Upload snapshot i overskriften i Agentfejlfinding.
2. Træk og slip .zip-filen på dropzonen, eller vælg at søge efter den.

Agentfejlfinding validerer ZIP-filen, udpakker filerne og åbner analysevisningen. Der kræves ikke valg af miljø, agent eller samtale. Alle generelle oplysningsmålepunkter stammer fra den uploadede fil.

Brug tilstanden Upload snapshot, når du har brug for at:

• Foretage fejlfinding af en samtale, der fandt sted i testruden, før agenten blev publiceret.
• Analysere en samtale fra et miljø, du ikke kan godkendes imod.
• Genskabe problemer offline eller dele en fejlbehæftet session med en kollega uden at give adgang til Dataverse.
• Validere agentens adfærd i et lokalt udviklingsmiljø.

Analysere en samtale

Analysevisningen åbnes, efter du har valgt Analyser eller uploadet et snapshot. Den indeholder en oversigtsrække med generelle oplysninger øverst, en analysesektion, der kan skjules, med fire paneler (Udførelsessti, Ydelsestidslinje, Agentdetaljer og Anbefalinger) samt et layout med to paneler, der viser Samtaleforhåndsvisningen sammen med panelet Foretag fejlfinding af oplysninger.

Generelle oplysninger

Rækken med generelle oplysninger viser felter med oversigtsmetrikker for samtalen.

Når en live agent indlæses, vises linket Åbn agent i overskriften med generelle oplysninger. Linket åbner agentens konfigurationsside i Copilot Studio.

Udførelsessti

Udførelsesstien gengiver hele udførelsesrækkefølgen på tværs af alle samtalerunder som et ønsket flowdiagram. Trinnene flyder fra venstre mod højre i udførelsesrækkefølge. Stiplede lodrette linjer markerer rundegrænser, og hver brugerbesked starter en ny sektion. Rundeetiketter vises øverst i hver sektion. Når du vælger en rundeetiket, ruller samtaleforhåndsvisningen til den pågældende besked.

Hver trintype bruger en særskilt farve, og en forklaring nederst i diagrammet knytter farver til trinkategorier som Emne, Viden, Værktøj, Connector, Flow, Kode, MCP og Forbundet agent. Hver node viser trinnets navn og udførelsesvarighed. Fejlbehæftede trin er markeret med rødt. Forbundne agenter fremstår som containerfelter, der grupperer de underordnede trin, de udførte.

Ydeevnetidslinje

Ydeevnetidslinjen viser et vandfaldsdiagram over udførelsestider for trin grupperet efter samtalerunde. Trinlinjer skaleres efter rundens samlede varighed for at gøre relativ timing synlig. Farvekodningen matcher forklaringen til udførelsesstien, og fejlbehæftede trin vises med rødt.

Panelet indeholder følgende funktioner:

• Udvid/skjul alle-knapper skifter alle rundesektioner på én gang. Hver rundesektion kan også skjules individuelt.
• Statistikker pr. runde viser antal trin, navn på og varighed af det langsomste trin og antal fejl.
• En global oversigt øverst viser det samlede antal trin, den samlede forløbne tid, det langsomste trin i hele samtalen og det samlede antal fejl.
• Trin, der er langsommere end 10 sekunder, markeres med en advarselsindikator.

Oplysninger om helpdesk-medarbejder

Panelet med agentdetaljer viser den fulde konfiguration af agenten, som den var på det tidspunkt, samtalen blev analyseret. Oplysningerne er organiseret i seks faner.

Anbefalinger

Panelet med anbefalinger registrerer automatisk problemer i samtalen og fremviser dem som handlingsorienterede kort med vurderinger med alvorsgrader.

Følgende problemtyper registreres:

Hvert anbefalingskort viser ikonet og farven for alvorsgrad, et kategoribadge, titlen og beskrivelsen af det opdagede problem, et forslag til, hvordan man undersøger eller løser det, samt knappen Gå til runde, der ruller samtaleforhåndsvisningen til den relevante brugerbesked. Når der ikke opdages problemer, viser panelet en besked om tom tilstand.

Forhåndsversion af samtale

Panelet med forhåndsvisning af samtale viser hele samtaleudvekslingen, som den så ud for brugeren, inklusive bobler med bot- og brugerbeskeder, adaptive kort gengivet på linjen, foreslåede handlingschips og feedbackprompts.

Hvis du vælger en boble med en brugerbesked indlæses den pågældende runde i panelet Fejlfindingsoplysninger. Den valgte besked er markeret, så du kan følge med i, hvilken runde der er aktiv. Panelet kan rulles uafhængigt. Ved at vælge Vis JSON i overskriften for forhåndsversionen af samtalen åbnes den fulde afskrifts-JSON-dialog.

Fejlfindingsoplysninger

Panelet med fejlfindingsoplysninger viser detaljer på trinniveau for den valgte runde med brugerbesked. Panelet indeholder en trinliste til venstre og en detaljevisning af trinnet, der åbnes, når du vælger et trin.

Trinlisten viser hvert organisatortrin, der udføres for den valgte runde, med et trinikon og farve, der angiver trintypen, trinnavnet (gengivet som et visningsnavn, hvor det er muligt), udførelsens varighed og en indikator for vellykket eller mislykket. Trin, der tilhører en forbundet agent, grupperes i et containerkort, der kan skjules, der viser agentens navn og den samlede udførelsestid. Knappen Indlæs detaljer om forbundet agent på containeren indlæser den underordnede agents fulde afskrift efter behov.

Følgende trintyper understøttes:

Ved at vælge et trin åbnes et detaljepanel med følgende sektioner, som vises, når dataene er til stede i afskriften:

• Tænkt proces: Organisatorens ræsonnementstekst optaget, før trinnet blev aktiveret. Viser, hvordan modellen valgte at kalde dette trin, og hvad den forventede af det.
• Trintype: Klassificeret etiket for trinnet.
• Argumenter: Visning af et JSON-træ med inputparametre, der kan skjules, og som sendes til trinnet. Indeholder en kopieringsmulighed for at hente JSON til supportanmodninger.
• Observation: Output- eller returværdien fra trinnet. Vises også som et JSON-træ med kopieringsunderstøttelse, der kan skjules.
• Kodeforhåndsvisning: For Python-kodetrin vises kildekoden med syntaksfremhævning.
• Tokenbrug: Antal prompttokens, antal fuldførelsestokens og samlet antal for trinnet sammen med modelnavnet.
• Videnskilder: Kilder, der blev søgt i, returnerede resultater (output) og kilder, der faktisk blev citeret i det endelige svar. Hver post viser kildenavn, type, URL, hvor det er tilgængeligt, samt et link til at åbne kilden.
• MCP-serverinfo: For MCP-trin vises serverens protokolversion, deklarerede egenskaber og listen over værktøjer, som serveren leverede under initialiseringen.
• Fejloplysninger: Når et trin fejlede, vises fejlkoden, fejlmeddelelsen og (for blokeringer ved ansvarlig AI) indholdssikkerhedskategorien, der udløste filteret.
• Adaptive kort: Når trinnet producerer et svar fra et adaptivt kort, gengives kortet på linjen i detaljepanelet præcis, som brugeren ville have set det.

Afskrift-JSON

Når du vælger Vis JSON i overskriften til forhåndsvisningen af samtalen, åbnes en dialogboks, der viser de fulde rå afskriftsaktiviteter med syntaksmarkering, fuldtekstsøgning i JSON-træet og funktionen Kopiér til udklipsholder for alle nyttedataene.

Brug denne visning, når:

• Du skal inspicere en hændelsestype, der ikke vises i panelet Fejlfindingsoplysninger.
• Du vil kopiere specifikke felter til en supportanmodning.
• Du undersøger uventet adfærd i de analyserede visninger.

Fejlfinding

Følgende afsnit beskriver almindelige problemer, og hvordan du løser dem.

Agent vises ikke på rullelisten Miljø eller agent

Agenten er ikke synkroniseret med Agentlager, eller også har den ingen samtaleafskrifter.

Sådan løses dette problem:

1. Kør en manuel synkronisering af Agentlager for miljøet.
2. Bekræft agentposten i tabellen Agentdetaljer i Dataverse.
3. Tjek, at kolonnen Er afskrift tilgængelig er indstillet til Ja for posten. Synkroniseringen indstiller dette felt, når der findes mindst én afskrift.

Du kan finde flere oplysninger under Overvåg agenter ved brug af Agentlager i Copilot Agent Kit.

Samtale-id findes ikke i rullemenuen

I forbindelse med ydeevne forudindlæser rullemenuen kun de 50 seneste samtaler inden for det aktive tidsinterval. Ældre afskrifter findes stadig i Dataverse, men vises ikke som standard. Alternativt er afskriften måske ikke skrevet endnu, hvis samtalen lige er afsluttet.

Sådan løses dette problem:

1. Indtast samtale-id'et direkte i feltet Samtale-id. Hvis du skriver, udløses der en fuld søgning på tværs af alle afskrifter for den pågældende agent, uden at der tages højde for tidsintervallet.
2. Hvis tidsintervallet er snævert (for eksempel sidste 30 minutter), skal du udvide det eller skifte til et brugerdefineret interval, der dækker samtaledatoen.
3. Hvis samtalen lige er afsluttet, skal du vente 35-40 minutter på, at afskriften skrives til Dataverse, og derefter opdatere.

Analysér belastninger, men der vises ingen trin i panelet Fejlfindingsoplysninger

Afskriften findes, men indeholder kun beskedaktiviteter uden hændelser med diagnosticeringsspor. Dette problem opstår typisk, når samtalen kommer fra en kanal, der ikke udsender sporingsdata, såsom visse brugerdefinerede kanaler eller ældre skemaversioner.

Sådan løses dette problem:

1. Vælg Vis JSON i overskriften for forhåndsvisning af samtalen for at bekræfte, at aktiviteter er til stede.
2. Se efter type: "trace"-eller type: "event"-poster. Hvis de mangler, kan kanalen måske ikke udsende sporingsdata.

Adgang nægtet eller tom side ved indlæsning

Roller eller tilladelser mangler i et eller begge miljøer.

Sådan løses dette problem:

1. I pakkemiljøet skal du sikre, at brugeren har sikkerhedsrollen CSK - Administrator eller Systemadministrator .
2. I målmiljøet skal du sikre, at den bruger, der er logget på, har læseadgang til tabellerne conversationtranscripts, bot og botcomponents.

Afskrifterne ser ufuldstændige ud (mangler tidlige beskeder)

Lange samtaler er fordelt på flere Dataverse-poster (grænse på 1 MB pr. post). Hvis opbevaringspolitikken fjerner nogle poster, har den flettede afskrift huller.

Sådan løses dette problem:

1. Dataverse fjerner som standard samtaleafskrifter, der er ældre end 30 dage. Hvis opbevaring er problemet, skal du opdatere tidsplanen for masseslettejobbet i Power Apps>Indstillinger>Avancerede indstillinger>Datahåndtering>Massesletning af poster.
2. Hvis opbevaring ikke er årsagen, skal du bekræfte, at alle afskriftsposter for samtalen findes i conversationtranscripts-tabellen i Dataverse.

Trin viser rå skemanavne i stedet for læsbare emnenavne

Opslag i tabellen botcomponents mislykkedes, eller komponentposten blev slettet.

Sådan løses dette problem:

1. Bekræft, at den bruger, der er logget på, har læseadgang til tabellen botcomponents i målmiljøet.
2. Hvis komponenten blev slettet fra Copilot Studio, findes der ingen matchende post, og Agentfejlfinding bruger i stedet det rå skemanavn, såsom cr123_mytopic. Denne adfærd forventes for slettede emner eller handlinger.

Panelet med agentdetaljer viser ingen data

Hentning af agentkonfiguration mislykkedes, eller forbindelse for den bruger, der er logget på, har ikke læseadgang til tabellerne bot og botcomponents i målmiljøet.

Sådan løses dette problem:

1. Kontrollér læseadgang til tabellerne bot og botcomponents for den forbindelsesreference, appen bruger.
2. Hvis agenten blev slettet eller fjernet fra publicering, efter at samtalen blev optaget, findes dens konfigurationsposter muligvis ikke længere. I dette tilfælde forbliver panelet Agentdetaljer tomt, men afskrifts- og fejlfindingspanelerne er stadig fuldt funktionsdygtige.

Panelet med anbefalinger viser ingen problemer, men samtalen mislykkedes

Anbefalinger kommer fra mønstre i hændelser for afskriftsspor. Hvis afskriften mangler sporingsdata, eller hvis fejlen sker uden for samtalen (for eksempel timeout pga. et stille netværk, som afskriften ikke optager), genererer systemet ingen anbefalinger.

Sådan løses dette problem:

1. Åbn afskrifts-JSON'en for at lede efter rå fejlbehæftede nyttedata, der ikke er dukket op som anbefaling.
2. Tjek udførelsesstien for eventuelle trin, der vises med rødt. Disse trin indikerer fejl, der ikke matcher et kendt anbefalingsmønster.

Relaterede oplysninger

• Overvåg agenter ved hjælp af agentlageret i Copilot Agent Kit
• Konfigurer agenter i Copilot Agent Kit
• Oversigt over Copilot Agent Kit