Obtenir la trace d’exécution d’un agent

Chaque exécution d’agent enregistre une trace d’exécution canonique : un flux ordonné d’événements décrivant tout ce qu’elle a fait — les outils qu’elle a appelés et leurs résultats, des résumés de raisonnement, des mises à jour de progression, des sessions de navigateur et des modifications de ses artefacts de sortie. Il s’agit du même flux d’événements qui alimente la vue Activité en direct dans l’Agent Playground.

• Débogage des exécutions — consultez les recherches, scrapes et extractions exacts effectués par l’agent, les entrées (tool_call.started) et résultats (tool_call.finished) de chaque outil, ainsi que l’étape à laquelle une exécution a échoué (error.occurred, ainsi que l’outcome et l’error structuré de l’événement terminal run.finished).
• Interfaces de suivi en direct — interrogez la trace pendant qu’une tâche d’agent est en processing afin d’afficher en temps réel ce que fait l’agent. Les événements progress.reported indiquent la phase de l’exécution (planning, working, finalizing) avec un message lisible par un humain, et les événements reasoning.summary décrivent le raisonnement de l’agent.
• Vue Browser en direct — ajoutez ?liveView=true pendant qu’une exécution est en cours pour obtenir activeBrowserSessions : les sessions de navigateur actives de l’exécution, chacune avec une liveViewUrl que vous pouvez intégrer pour observer (ou présenter) la navigation de l’agent.
• Suivi des coûts — creditsUsed indique les crédits consommés jusqu’à présent, plafonnés à maxCredits pour l’exécution si cette valeur a été définie.

Les événements sont émis par les agents de l’exécution — l’orchestrator et ses subagents — et chacun identifie son émetteur dans le champ agent. Les opérations du Browser s’effectuent dans la session de navigateur propre à l’agent et sont signalées via des événements browser.session.*, et non par des agents de navigateur distincts. Triez les événements selon producerSequence (pour chaque agent émetteur). Le champ type distingue les 13 variantes d’événements ; consultez le schéma de réponse ci-dessous pour obtenir la liste complète et les champs de chaque variante.

Les événements artifact.updated ne contiennent pas le contenu de l’artefact lui-même : ils y font référence via snapshotId, que vous récupérez avec le point de terminaison de snapshot.

Des événements peuvent continuer à arriver pendant un court instant après la réception de run.finished. Si vous interrogez une exécution en cours, maintenez une courte fenêtre de délai avant d’afficher l’état final.

Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour les instructions d’intégration automatisée.