Obtenir un instantané de sortie d’une tâche d’agent
Points de terminaison Agent
Obtenir un instantané d’agent
GET
Obtenir un instantané de sortie d’une tâche 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
Le champ
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 chaquesnapshotIdreprésente un état à un instant donné desdatafinales. - 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
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.
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.
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paramètres de chemin
L’ID de la tâche d’agent
L’ID de l’instantané, issu d’un événement de trace artifact.updated

