Skip to main content
GET
Obter um snapshot de resultado de um job do agente
Durante a execução de um agente, ele versiona seus artefatos de resultado — o resultado JSON estruturado à medida que é gerado, além de quaisquer artefatos em markdown, HTML, texto ou captura de tela que ele produz. Cada alteração gera um evento de rastreamento artifact.updated que referencia a nova versão por snapshotId. Este endpoint recupera o conteúdo completo de um desses snapshots.

Para que serve

  • Resultados parciais — visualize o resultado estruturado do agente antes do término da execução. O artefato de resultado em JSON (artifactId: "result") é capturado à medida que cresce, portanto cada snapshotId representa uma visualização dos data finais em um determinado momento.
  • Artefatos renderizados — obtenha o conteúdo de artefatos não JSON produzidos pelo agente, como um relatório em markdown ou uma captura de tela de uma página que ele visitou.
  • Inspeção da execução — combine com o rastreamento para reconstruir exatamente como o resultado evoluiu durante a execução.

Como funciona

O campo change do evento artifact.updated informa como o snapshot se relaciona com o anterior: init (primeira versão), partial, append, modify ou update. Cada alteração recebe um novo snapshotId — busque o mais recente para ver o estado atual ou percorra o histórico para comparar versões usando diff. O campo snapshot na resposta contém o conteúdo do artefato como uma string. Para artefatos json, ele é codificado em JSON — faça o parse antes de usá-lo.
Os snapshots são registrados em execuções do Spark 2 — ou seja, em toda nova execução. Jobs iniciados em modelos Spark 1 antes de serem descontinuados não têm snapshots e retornam 400.
Você é um agente de IA e precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver instruções de onboarding automatizado.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

jobId
string<uuid>
obrigatório

O ID do job do agente

snapshotId
string<uuid>
obrigatório

O ID do snapshot, de um evento de rastreamento artifact.updated

Resposta

Resposta bem-sucedida

id
string<uuid>
snapshot
string

O conteúdo do snapshot como uma string codificada em JSON — o artefato de resultado em andamento do agente naquele ponto da execução.

snapshotId
string<uuid>
success
boolean