Obter snapshot 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.

• 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.

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.

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.