Gebruik de activity trace om je agent te debuggen

De activiteitstrace in agenten die gebruikmaken van de GitHub Copilot-harness in Microsoft Copilot Studio laat je precies zien hoe je agent elk bericht verwerkt. Gebruik deze om de gedachtegang van uw agent te begrijpen, de toewijzing van kennisbronnen te controleren, de uitvoering van tools te bevestigen en fouten op te sporen.

Prerequisites

• Een agent gemaakt met het GitHub Copilot-harnas
• Ten minste één testgesprek in het tabblad Voorbeeld

Open het activiteitenlogboek

1. Open uw agent in Copilot Studio en selecteer het tabblad Voorbeeld.

2. Zorg ervoor dat de schakelaar preview voor eindgebruikers uit staat (de standaardontwerpweergave). De activiteitentrace verschijnt naast het chatvenster en toont de verwerkingsdetails voor elk bericht.

3. Stuur een bericht naar uw agent. De trace wordt in realtime bijgewerkt terwijl de agent het bericht verwerkt.

Inzicht in de tracering

De activiteitentrace toont een chain-of-thought-weergave (CoT) van het verwerkingsproces van uw agent. Elke stap in de trace wordt weergegeven als een knooppunt dat laat zien wat de agent heeft gedaan en waarom.

Knooppunttypen

De trace kan de volgende knooppunttypen bevatten:

Details van knooppunt weergeven

1. Selecteer een knooppunt in de trace om de details ervan uit te vouwen.

2. Bekijk de weergegeven informatie, waaronder:

   • De invoer die de agent naar de stap heeft gestuurd
   • De uitvoer of het geretourneerde resultaat
   • Verwerkingstijd en statistieken
   • Foutdetails als de stap is mislukt

Problemen met kennisbronnen debuggen

Wanneer uw agent kennis gebruikt om een ​​vraag te beantwoorden, toont de trace welke bronnen zijn geraadpleegd:

1. Zoek het Kennis-knooppunt in de trace.

2. Bekijk de bron om te zien welke kennisbronnen zijn geraadpleegd.

3. Selecteer een bron om de specifieke opgehaalde inhoud te bekijken.

4. Controleer of de agent de juiste bron heeft gebruikt en of de opgehaalde inhoud relevant is.

Als de agent de verkeerde bron heeft gebruikt of onjuiste informatie heeft geretourneerd, controleer dan uw kennisconfiguratie op het tabblad Bouwen.

Tooluitvoering debuggen

Wanneer uw agent een tool aanroept, toont de trace de uitvoeringsdetails:

1. Zoek het knooppunt Tool, Connector, Flow of Skill in de trace.

2. Bekijk de uitvoeringsdetails, inclusief de invoerparameters en uitvoerresultaten.

3. Controleer of de juiste tool is aangeroepen en of de resultaten overeenkomen met de verwachtingen.

4. Als de uitvoering van een tool is mislukt, bekijk dan de foutdetails in het knooppunt.

Om een ​​tool opnieuw te configureren, opent u het tabblad Build en zoekt u de tool in de configuratie van uw agent.

Fouten oplossen

Wanneer er fouten optreden tijdens de verwerking, worden deze in de trace gemarkeerd:

1. Zoek naar knooppunten die in de trace zijn gemarkeerd met een foutindicator.

2. Selecteer het foutknooppunt om de foutdetails te bekijken, inclusief het foutbericht en de context.

3. Veelvoorkomende problemen zijn:

   • Authenticatiefouten voor hulpprogramma's of connectoren
   • Fouten bij toegang tot kennisbronnen
   • Time-outfouten voor langlopende toolaanroepen
   • Vlaggen voor inhoudsmoderatie

4. Pak de hoofdoorzaak aan in het tabblad Build of Instellingen en test vervolgens opnieuw.

Navigeer vanuit de tracering naar het tabblad Build

De activiteitstrace is geïntegreerd met het tabblad Build voor snelle bewerking.

1. Selecteer een bron, tool of component in de trace.

2. Copilot Studio navigeert naar de corresponderende component in het tabblad Build.

3. Breng uw wijzigingen aan en ga terug naar het tabblad Preview om opnieuw te testen.

Verwante informatie

• Bekijk en test een agent
• Een agent testen
• Deel je makelaar met anderen
• Beheer previewgesprekken
• Een agent controleren