Obtenir un instantané d’agent

Pendant l’exécution d’un agent, ses artefacts de sortie sont versionnés : le résultat JSON structuré à mesure qu’il prend forme, ainsi que les artefacts Markdown, HTML, texte ou captures d’écran qu’il produit. Chaque modification génère un événement de trace artifact.updated qui référence la nouvelle version par son snapshotId. Ce point de terminaison récupère le contenu complet d’un tel instantané.

À quoi cela sert#

Résultats partiels — prévisualisez la sortie structurée de l’agent avant la fin de l’exécution. L’artefact de résultat JSON (artifactId: "result") est capturé à mesure qu’il évolue, de sorte que chaque snapshotId représente un état à un instant donné des data finales.
Artefacts rendus — récupérez le contenu des artefacts non JSON produits par l’agent, tels qu’un rapport Markdown ou une capture d’écran d’une page qu’il a visitée.
Inspection de l’exécution — associez-les à la trace pour reconstituer précisément l’évolution de la sortie tout au long de l’exécution.

Fonctionnement#

Le champ change de l’événement artifact.updated indique comment l’instantané se compare au précédent : init (première version), partial, append, modify ou update. Chaque modification génère un nouveau snapshotId : récupérez le plus récent pour connaître l’état actuel ou parcourez l’historique pour comparer les versions.

Le champ snapshot de la réponse contient le contenu de l’artefact sous forme de chaîne. Pour les artefacts json, il est encodé en JSON : parsez-le avant de l’utiliser.

Note

Les instantanés sont enregistrés lors des exécutions Spark 2, c’est-à-dire à chaque nouvelle exécution. Les jobs démarrés sur des modèles Spark 1 avant leur retrait ne disposent d’aucun instantané et renvoient 400.

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