Obter um snapshot de resultado de um job do agente
Endpoints de agente
Obter snapshot do agente
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
O campo
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 cadasnapshotIdrepresenta uma visualização dosdatafinais 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
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parâmetros de caminho
O ID do job do agente
O ID do snapshot, de um evento de rastreamento artifact.updated

