Använd aktivitetsspårningen för att felsöka din agent

Aktivitetsspårningen i agenter som drivs av GitHub Copilot-harnessen i Microsoft Copilot Studio visar exakt hur din agent bearbetar varje meddelande. Använd den för att förstå din agents tankekedja, verifiera ursprunget till kunskapskällan, bekräfta användningen av verktyg och felsöka fel.

Note

Funktionerna i denna artikel används av agenter eller arbetsflöden som drivs av GitHub Copilot-verktyget.

Användningsbaserad fakturering gäller för att använda, bygga, testa och utvärdera agenter. Dessa åtgärder kan förbruka Copilot-krediter. Läs mer i Hantera kostnader för agenter som drivs av GitHub Copilot-harnessen.

Förutsättningar

  • En agent skapad med GitHub Copilot-selen
  • Minst en testkonversation i fliken Förhandsversion

Öppna aktivitetspåret

  1. Öppna din agent i Copilot Studio och välj fliken Förhandsversion.

  2. Se till att reglaget för förhandsversion för slutanvändare är avstängt (standardläge för skapare). Aktivitetsspåret visas bredvid chattpanelen och visar bearbetningsdetaljer för varje meddelande.

  3. Skicka ett meddelande till din agent. Aktivitetsspåret uppdateras i realtid när agenten bearbetar meddelandet.

Förstå spårningen

Aktivitetsspåret visar en vy över tankekedjan (CoT) för din agents bearbetning. Varje steg i aktivitetsspåret presenteras som en nod som visar vad agenten gjorde och varför.

Nodtyper

Spåret kan omfatta följande nodtyper:

Nodtyp Vad det visar
Användarmeddelande Meddelandet du skickade till agenten
Agentens svar Agentens genererade svar
Kunskap En kunskapskälla som agenten använde som grund. Visas som ett "Searched knowledge"-hopfällbart kort som visar källor för varje kunskapskälla som har använts, samt referenslänkar när sådana finns tillgängliga.
Utförde åtgärd En anslutning eller ett verktygsanrop som visas som ett hopfällbart kort med anslutningen, ifyllda inmatningsparametrar och körtid
Tool Ett verktyg som agenten anropade för att utföra en handling eller hämta data
Konnektor En anslutning som agenten använde för att komma åt externa data
Flöde Ett agentflöde som utlöstes
Färdighet En färdighet som utfördes
Error Ett fel som uppstod under bearbetningen
Komplett En grön bock visas längst ner i spårningen när alla verktygsanrop har slutförts

Visa information om noden

  1. Välj vilken nod som helst i spårningen för att utöka dess detaljer.

  2. Granska informationen som visas, vilket kan inkludera:

    • Indata som agenten skickade till steget
    • Utdata eller returnerat resultat
    • Bearbetningstid och metriker
    • Felinformation om steget misslyckades

Felsök problem med kunskapskällor

När din agent använder kunskap för att besvara en fråga visar spårningen vilka källor som användes:

  1. Hitta kunskapsnoden i spåret.

  2. Granska källan för att se vilka kunskapskällor som har använts.

  3. Välj en källa för att se det specifika innehållet som hämtats.

  4. Verifiera att agenten har använt rätt källa och att det hämtade innehållet är relevant.

Om agenten använde fel källa eller returnerade felaktig information, kontrollera din kunskapskonfiguration i fliken Skapa.

Felsöka verktygskörning

När din agent anropar ett verktyg visar spårningen exekveringsdetaljerna:

  1. Hitta Verktyg, anslutningsprogram, Flöde eller färdighet-noden i spårningen.

  2. Gå igenom exekveringsdetaljerna, inklusive indataparametrar och utdataresultat.

  3. Verifiera att rätt verktyg har anropats och att resultaten är som förväntat.

  4. Om ett verktyg inte kunde köras, granska felinformationen i noden.

För att konfigurera om ett verktyg, öppna fliken skapa och hitta verktyget i din agents konfiguration.

Felsökning av fel

När fel uppstår under bearbetningen markerar spårningen dem:

  1. Leta efter noder markerade med en felindikator i spårningen.

  2. Välj felnoden för att se feldetaljerna, inklusive felmeddelandet och kontexten.

  3. Vanliga problem är:

    • Autentiseringsfel för verktyg eller anslutningsprogram
    • Åtkomstfel för kunskapskällor
    • Timeout-fel för långkörande verktygsanrop
    • Innehållsmodereringsflaggor

  4. Åtgärda grundorsaken i fliken Bygg eller Inställningar, och testa sedan igen.

Aktivitetsspårningen integreras med fliken Bygg för snabb redigering.

  1. Välj valfri källa, verktyg eller komponent i spårningen.

  2. Copilot Studio navigerar till motsvarande komponent i fliken Bygg.

  3. Gör dina ändringar och gå tillbaka till fliken Förhandsversion för att testa igen.

  • Last updated on