Bruk aktivitetssporingen til å feilsøke agenten din

Aktivitetssporingen i agenter drevet av GitHub Copilot-selen i Microsoft Copilot Studio viser deg nøyaktig hvordan agenten din behandler hver melding. Bruk det til å forstå agentens tankegang og resonnement, verifisere kunnskapskildetilskrivelse, bekrefte verktøyutførelse og feilsøke feil.

Bemerkning

Funksjonene i denne artikkelen drives av GitHub Copilot-selen, som bruker Copilot Credits for bruksbasert fakturering. Lær mer om Copilot-kreditter i Oversikt over fakturering for agenter drevet av GitHub Copilot-selen.

Bruksbasert fakturering gjelder for bruk, bygging, testing og evaluering av agenter. Disse handlingene kan bruke opp Copilot-kreditter.

Forutsetninger

  • En agent laget med GitHub Copilot-selen
  • Minst én testsamtale i fanen Forhåndsvis

Åpne aktivitetssporet

  1. Åpne agenten i Copilot Studio, og velg Forhåndsvis-fanen.

  2. Sørg for at vekslebryteren Sluttbrukerforhåndsvisning er slått av (standard utviklervisning). Aktivitetssporet vises ved siden av nettpratpanelet og viser prosessdetaljer for hver melding.

  3. Send en melding til agenten. Aktivitetssporet oppdateres i sanntid mens agenten behandler meldingen.

Forstå sporet

Aktivitetssporet viser en chain-of-thought-visning (CoT) av agentens prosess. Hvert trinn i aktivitetssporet vises som en node som viser hva agenten gjorde og hvorfor.

Nodetyper

Sporet kan inkludere følgende nodetyper:

Nodetype Hva det viser
Brukermelding Meldingen du sendte til agenten
Agentsvar Agentens genererte svar
Kunnskap En kunnskapskilde agenten konsulterte for faktabasering. Vises som et «Søkt kunnskapskilde»-sammenleggbart kort som viser kilder for hver kunnskapskilde som er brukt, samt siteringskoblinger der det er tilgjengelig.
Kjørte handling En kontakt- eller verktøykall gjengitt som et sammenleggbart kort som viser kontakten, fylte inngangsparametere og leveringstid
Verktøy Et verktøy agenten aktiverte for å utføre en handling eller hente data
Kobling En kobling som agenten brukte for å få tilgang til ekstern data
Flyt En agentflyt som ble utløst
Ferdigheter En ferdighet som ble utført
Feil En feil som oppsto under behandlingen
Fullstendig En grønn avkrysningsindikator vises nederst i aktivitetssporet når alle verktøykall er fullført

Vis nodedetaljer

  1. Velg en hvilken som helst node i aktivitetssporet for å vise detaljene.

  2. Gå gjennom informasjonen som vises, som kan inkludere:

    • Inndataene agenten sendte til trinnet
    • Utdataene eller resultatet som ble returnert
    • Behandlingstid og måledata
    • Feilinformasjon hvis trinnet feilet

Feilsøk problemer med kunnskapskilder

Når agenten din bruker kunnskap til å svare på et spørsmål, viser sporet hvilke kilder som ble konsultert:

  1. Finn Knowledge-noden i sporet.

  2. Gjennomgå kilden for å se hvilke kunnskapskilder som ble åpnet.

  3. Velg en kilde for å se det spesifikke innholdet som er hentet.

  4. Verifiser at agenten har brukt riktig kilde, og at det hentede innholdet er relevant.

Hvis agenten brukte feil kilde eller returnerte unøyaktig informasjon, sjekker du kunnskapskonfigurasjonen i Bygg-fanen.

Feilsøking av verktøyutførelse

Når agenten kjører et verktøy, viser sporet detaljer om utførelsen:

  1. Finn Verktøy, Kobling, Flyt eller Ferdighet-noden i sporet.

  2. Gjennomgå utførelsesdetaljene, inkludert inndataparametere og utdataresultater.

  3. Verifiser at riktig verktøy ble kjørt, og at resultatene er som forventet.

  4. Hvis en verktøyoperasjon mislyktes, må du gjennomgå feildetaljene i noden.

For å konfigurere et verktøy på nytt åpner du Bygg-fanen og finner verktøyet i agentens konfigurasjon.

Feilsøk problemer

Når feil oppstår under behandling, blir de markert i sporet:

  1. Se etter noder merket med en feilindikator i sporingen.

  2. Velg feilnoden for å se feildetaljene, inkludert feilmelding og kontekst.

  3. Vanlige problemer omfatter:

    • Autentiseringsfeil for verktøy eller koblinger
    • Tilgangsfeil til kunnskapskilde
    • Tidsavbruddsfeil for langvarige verktøykall
    • Innholdsmodereringsflagg

  4. Utbedre rotårsaken i Bygg-fanen eller Innstillinger, og test deretter på nytt.

Aktivitetssporet integreres med fanen Bygg for rask redigering.

  1. Velg en kilde, et verktøy eller en komponent i sporet.

  2. Copilot Studio navigerer til den tilsvarende komponenten i Bygg-fanen.

  3. Gjør endringene dine og gå tilbake til fanen Forhåndsvisning for å teste på nytt.

  • Last updated on