Skip to main content
GET
Obtiene una instantánea de salida de un trabajo del agente
Mientras se ejecuta un agente, se controlan las versiones de sus artefactos de salida: el resultado JSON estructurado a medida que toma forma, así como cualquier artefacto de markdown, HTML, texto o captura de pantalla que produzca. Cada cambio genera un evento de traza artifact.updated que referencia la nueva versión mediante snapshotId. Este endpoint recupera el contenido completo de una de esas instantáneas.

Para qué sirve

  • Resultados parciales — previsualiza la salida estructurada del agente antes de que termine la ejecución. Se toma una instantánea del artefacto de resultado JSON (artifactId: "result") a medida que crece, por lo que cada snapshotId ofrece una vista en un momento dado de los data finales.
  • Artefactos renderizados — obtén el contenido de artefactos no JSON que produjo el agente, como un informe en Markdown o una captura de pantalla de una página que visitó.
  • Inspección de ejecuciones — combínala con la traza para reconstruir exactamente cómo evolucionó la salida durante la ejecución.

Cómo funciona

El campo change del evento artifact.updated indica cómo se relaciona la instantánea con la anterior: init (primera versión), partial, append, modify o update. Cada cambio recibe un nuevo snapshotId: obtén el más reciente para conocer el estado actual o recorre el historial para comparar versiones. El campo snapshot de la respuesta contiene el contenido del artefacto como una cadena. En los artefactos json, está codificado en JSON; პროცესarlo antes de usarlo.
Las instantáneas se registran en las ejecuciones de Spark 2, es decir, en cada ejecución nueva. Los trabajos iniciados en modelos Spark 1 antes de su retirada no tienen instantáneas y devuelven 400.
¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones de incorporación automatizada.

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

jobId
string<uuid>
requerido

El ID del trabajo del agente

snapshotId
string<uuid>
requerido

El ID de la instantánea, de un evento de rastreo artifact.updated

Respuesta

Respuesta correcta

id
string<uuid>
snapshot
string

El contenido de la instantánea como una cadena codificada en JSON: el artefacto de salida de trabajo del agente en ese punto de la ejecución.

snapshotId
string<uuid>
success
boolean