Skip to main content
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 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.
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

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

jobId
string<uuid>
requis

L’ID de la tâche d’agent

snapshotId
string<uuid>
requis

L’ID de l’instantané, issu d’un événement de trace artifact.updated

Réponse

Réponse réussie

id
string<uuid>
snapshot
string

Le contenu de l’instantané sous forme de chaîne encodée en JSON — l’artefact de sortie de travail de l’agent à ce stade de l’exécution.

snapshotId
string<uuid>
success
boolean