> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](/pt-BR/api-reference/endpoint/agent-trace) que referencia a nova versão por `snapshotId`. Este endpoint recupera o conteúdo completo de um desses snapshots.

<div id="what-its-for">
  ## Para que serve
</div>

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

<div id="how-it-works">
  ## Como funciona
</div>

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.

<Note>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`.</Note>

> Você é um agente de IA e precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver instruções de onboarding automatizado.


## OpenAPI

````yaml pt-BR/api-reference/v2-openapi.json GET /agent/{jobId}/snapshots/{snapshotId}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API para interagir com os serviços do Firecrawl e executar tarefas de web
    scraping e crawling.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /agent/{jobId}/snapshots/{snapshotId}:
    parameters:
      - description: O ID do job do agente
        in: path
        name: jobId
        required: true
        schema:
          format: uuid
          type: string
      - description: O ID do snapshot, de um evento de rastreamento artifact.updated
        in: path
        name: snapshotId
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Agent
      summary: Obter um snapshot de resultado de um job do agente
      operationId: getAgentSnapshot
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  id:
                    format: uuid
                    type: string
                  snapshot:
                    description: >-
                      O conteúdo do snapshot como uma string codificada em JSON
                      — o artefato de resultado em andamento do agente naquele
                      ponto da execução.
                    type: string
                  snapshotId:
                    format: uuid
                    type: string
                  success:
                    type: boolean
                type: object
          description: Resposta bem-sucedida
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Snapshots are only available for Spark 2 extracts
                    type: string
                type: object
          description: >-
            Solicitação inválida — o ID do job ou do snapshot não é um UUID
            válido ou o job não foi executado no spark-2 (os snapshots estão
            disponíveis apenas para jobs de agente do spark-2).
        '404':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Agent job not found
                    type: string
                type: object
          description: Job do agente não encontrado
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````