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

# Obtenir un instantané d’agent

Pendant l’exécution d’un agent, ses artefacts de sortie sont versionnés : le résultat JSON structuré à mesure qu’il prend forme, ainsi que les artefacts Markdown, HTML, texte ou captures d’écran qu’il produit. Chaque modification génère un [événement de trace](/fr/api-reference/endpoint/agent-trace) `artifact.updated` qui référence la nouvelle version par son `snapshotId`. Ce point de terminaison récupère le contenu complet d’un tel instantané.

<div id="what-its-for">
  ## À quoi cela sert
</div>

* **Résultats partiels** — prévisualisez la sortie structurée de l’agent avant la fin de l’exécution. L’artefact de résultat JSON (`artifactId: "result"`) est capturé à mesure qu’il évolue, de sorte que chaque `snapshotId` représente un état à un instant donné des `data` finales.
* **Artefacts rendus** — récupérez le contenu des artefacts non JSON produits par l’agent, tels qu’un rapport Markdown ou une capture d’écran d’une page qu’il a visitée.
* **Inspection de l’exécution** — associez-les à la trace pour reconstituer précisément l’évolution de la sortie tout au long de l’exécution.

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

Le champ `change` de l’événement `artifact.updated` indique comment l’instantané se compare au précédent : `init` (première version), `partial`, `append`, `modify` ou `update`. Chaque modification génère un nouveau `snapshotId` : récupérez le plus récent pour connaître l’état actuel ou parcourez l’historique pour comparer les versions.

Le champ `snapshot` de la réponse contient le contenu de l’artefact sous forme de chaîne. Pour les artefacts `json`, il est encodé en JSON : parsez-le avant de l’utiliser.

<Note>Les instantanés sont enregistrés lors des exécutions Spark 2, c’est-à-dire à chaque nouvelle exécution. Les jobs démarrés sur des modèles Spark 1 avant leur retrait ne disposent d’aucun instantané et renvoient `400`.</Note>

> Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour connaître les instructions d’intégration automatisée.


## OpenAPI

````yaml fr/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 pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /agent/{jobId}/snapshots/{snapshotId}:
    parameters:
      - description: L’ID de la tâche d’agent
        in: path
        name: jobId
        required: true
        schema:
          format: uuid
          type: string
      - description: L’ID de l’instantané, issu d’un événement de trace artifact.updated
        in: path
        name: snapshotId
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Agent
      summary: Obtenir un instantané de sortie d’une tâche d’agent
      operationId: getAgentSnapshot
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  id:
                    format: uuid
                    type: string
                  snapshot:
                    description: >-
                      Le contenu de l’instantané sous forme de chaîne encodée en
                      JSON — l’artefact de sortie de travail de l’agent à ce
                      stade de l’exécution.
                    type: string
                  snapshotId:
                    format: uuid
                    type: string
                  success:
                    type: boolean
                type: object
          description: Réponse réussie
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Snapshots are only available for Spark 2 extracts
                    type: string
                type: object
          description: >-
            Requête incorrecte — l’ID de tâche ou l’ID d’instantané n’est pas un
            UUID valide, ou la tâche ne s’est pas exécutée sur spark-2 (les
            instantanés sont disponibles uniquement pour les tâches d’agent
            spark-2).
        '404':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Agent job not found
                    type: string
                type: object
          description: Tâche d’agent introuvable
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````