Deelvenster Traceren in Agentforce Builder
Het deelvenster Traceren is de foutopsporing voor redeneringen die is ingebouwd in de omgeving Voorbeeld en Live test in Agentforce Builder. Het toont hoe uw agent beslissingen heeft genomen, inclusief geselecteerde subagenten, welke acties zijn geactiveerd, wanneer onderwerpovergangen hebben plaatsgevonden en hoe variabele waarden zijn gewijzigd.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition. Vereiste uitbreidingslicenties variëren per type agent. |
Nadat u een testbericht hebt verzonden, toont Samenvatting van interactie elke event in het besluitvormingsproces van de agent als een visuele tijdlijn. Afhankelijk van de testcase omvatten de events:
| Event | Beschrijving |
|---|---|
| Invoer: [bericht] | Het bericht dat deze beurt startte |
| Redenering: [naam agent] | De redenering van de agent geeft aan wat de agent vervolgens heeft besloten te doen en waarom |
| Actie: [functielabel] | Een agentactie die de agent heeft geactiveerd (stroom, Apex, enzovoort) |
| Transitie naar subagent: [doelagent] | De agent heeft het gesprek overgedragen aan een subagent binnen dezelfde agent |
| Transitie naar agent: [naam ontwikkelaar] | De agent heeft het gesprek overgedragen aan een afzonderlijke gerelateerde agent |
| Uitvoerevaluatie: [categorie] | Evaluatie van de reactie van de agent voordat deze wordt geretourneerd aan de gebruiker |
| Evaluatie van MCP-tool: [naam agent] | Een MCP-toolaanroep die de agent heeft geëvalueerd |
Selecteer een event in de Interactiesamenvatting om de detailweergave ervan te openen op het tabblad Traceren. Het tabblad Traceren toont een analyse van elke milliseconde van die event, met timingbalken voor elke subbewerking. Klik door naar een afzonderlijke periode om de volledige uitvoergegevens ervan te zien en precies wat de agent op dat moment heeft ontvangen en geretourneerd.
Het subtabblad Variabelen toont de status van elke variabele op elk beslissingspunt in de sessie. Elke event toont de waarde voordat deze werd uitgevoerd en de waarde nadat de event is voltooid. Bijvoorbeeld een booleaanse flipping van False (Onwaar) naar True (Waar) nadat een voorwaardecontrole is geslaagd. Gebruik het subtabblad Variabelen voor:
- Controleer of de juiste gegevens een actie- of aanwijzingssjabloon van een agent hebben bereikt
- Bevestig dat de juiste variabele is bijgewerkt na voltooiing van de actie
- Bepalen waar in de sessie een variabele een onverwachte waarde heeft ontvangen
Stel initiële of overschrijvingswaarden in Contextvariabelen in voordat u de test start en gebruik vervolgens variabelen tijdens de sessie om bij te houden hoe die waarden zich ontwikkelen.
Binnen elke redeneringsstap toont het tabblad Traceren de exacte aanwijzing die naar de LLM is verzonden. Gebruik deze informatie voor inzicht in:
- Welke context de agent had toen deze een subagent selecteerde of besloot om een agentactie te activeren
- Als de aanwijzing de variabele waarden en instructies bevatte die u had verwacht
- Waarom de redenering van de agent tot een onverwachte uitkomst heeft geleid
Stel tijdens het beoordelen van een tracering vragen aan de ingebouwde Agentforce Assistent over wat u ziet. Bijvoorbeeld "Verklaar de aanwijzing die in deze redeneringsstap wordt gegenereerd" of "Hoe kan ik de agent repareren om deze case af te handelen?"
Controleer alle voorgestelde oplossingen zorgvuldig voordat u ze toepast. Suggesties verwijzen soms naar acties of stromen van agenten die niet voorkomen in uw organisatie. Controleer daarom eerst of u wijzigingen aanbrengt.
Hier zijn enkele van de meest voorkomende foutopsporingsproblemen en stappen voor het oplossen ervan.
| Event | Oplossing |
|---|---|
| Een agentactie is niet geactiveerd | Open de stap Redenering onmiddellijk vóór de verwachte actie. Controleer de gegenereerde aanwijzing om te zien of de agent de context had die nodig is om de actie aan te roepen. Controleer vervolgens of er een FunctionStep (Actie) wordt weergegeven na de stap Redenering. Als dit niet het geval is, heeft de agent besloten de actie niet te activeren op basis van de beschikbare context. |
| Er heeft zich een onverwachte subagentovergang voorgedaan | Zoek de TransitionStep in de Samenvatting van interactie. Vouw de stap Redenering ervoor uit om te zien welke context de agent naar de overstap heeft geleid. Controleer of de configuratie van de Agent-router overeenkomt met de intent die uw testbericht heeft uitgedrukt. |
| Uitvoer kwam niet overeen met verwachtingen | Controleer de OutputEvaluationStep aan het einde van de reeks. Werk vervolgens terug door de stappen voor Redeneren en het subtabblad Variabelen om te bepalen waar de beslissing van de agent afwijkt van wat u had verwacht. |
