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

# FIRE-1 Agent (Bêta)

> FIRE-1 est un agent d’IA qui permet une navigation et une interaction intelligentes avec les pages web

FIRE-1 est un agent d’IA qui renforce les capacités de scraping de Firecrawl grâce à une navigation et des interactions web intelligentes. Il gère la pagination, contrôle des actions du navigateur et navigue dans des structures de sites complexes pour permettre une extraction de données plus complète, au-delà des méthodes de scraping traditionnelles.

<div id="what-fire-1-can-do">
  ### Ce que FIRE-1 peut faire :
</div>

* Naviguer automatiquement dans le contenu paginé.
* Interagir avec des boutons, des liens, des champs de saisie et des éléments dynamiques.
* Réaliser des tâches d’extraction avancées sur plusieurs pages.

<div id="enabling-fire-1-agent">
  ## Activation de l’agent FIRE-1
</div>

Pour activer l’agent FIRE-1, vous devez inclure l’objet `agent` dans le corps de votre requête API pour le point de terminaison `scrape` ou `extract`.

L’objet `agent` comporte les propriétés suivantes :

* `model` (string, optionnel) : Spécifie le modèle d’IA à utiliser. S’il n’est pas fourni, la valeur par défaut est `FIRE-1`. Actuellement, `FIRE-1` est le seul modèle disponible.
* `prompt` (string, requis pour le point de terminaison `scrape`) : Donne des instructions à l’agent IA, en décrivant le contenu à rechercher et la manière de naviguer sur le site (par exemple, comment gérer la pagination, quels boutons cliquer, etc.). Dans `/extract`, il utilisera l’invite fournie dans le paramètre `prompt`.

<div id="using-fire-1-with-the-scrape-endpoint">
  ### Utiliser FIRE-1 avec le point de terminaison /scrape
</div>

Vous pouvez utiliser l’agent FIRE-1 avec le point de terminaison `/v1/scrape` pour effectuer une navigation intelligente avant d’extraire le contenu final.

**Exemple (cURL) :**

```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer VOTRE_API_KEY' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "Parcourez les fiches produits en cliquant sur le bouton « Page suivante » jusqu’à ce qu’il soit grisé/désactivé. Récupérez le contenu de chaque page visitée."
      }
    }'
```

Dans cet exemple, l’agent FIRE-1 est chargé de parcourir la pagination des fiches produits avant d’effectuer le scraping final.

<div id="using-fire-1-with-the-extract-endpoint">
  ### Utiliser FIRE-1 avec le point de terminaison d’extraction
</div>

De même, vous pouvez utiliser l’agent FIRE-1 avec le point de terminaison `/v1/extract` pour des tâches d’extraction complexes nécessitant de naviguer sur plusieurs pages ou d’interagir avec des éléments.

**Exemple (cURL) :**

```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/extract \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "urls": ["https://example-forum.com/topic/123"],
      "prompt": "Extract all user comments from this forum thread.",
      "schema": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {"type": "string"},
                "comment_text": {"type": "string"}
              },
              "required": ["author", "comment_text"]
            }
          }
        },
        "required": ["comments"]
      },
      "agent": {
        "model": "FIRE-1"
      }
    }'
```

Ici, l’agent veille à ce que tous les commentaires soient chargés sur la page en interagissant avec le bouton "Charger plus de commentaires" avant de lancer le processus d’extraction à partir du schema et du prompt fournis.
**Remarque :** L’agent FIRE-1 offre de puissantes capacités, mais peut consommer davantage de crédits en fonction de la complexité des instructions de navigation et du nombre de pages avec lesquelles il interagit.

<div id="meet-fire-1-intelligent-navigation-and-interaction">
  ### Découvrez FIRE-1 : navigation et interaction intelligentes
</div>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/launch-week/lw3-d2-3.webp" alt="Visualisation de l'agent FIRE-1" />

FIRE-1 apporte un nouveau niveau d'intelligence à Firecrawl en enrichissant vos tâches de scraping grâce à la navigation dans des structures de sites web complexes, à la gestion de la pagination, à l'interaction avec du contenu dynamique, et bien plus encore. Ce puissant agent IA garantit une extraction complète des données, au-delà des méthodes de scraping traditionnelles.

<div id="what-fire-1-can-do">
  ### Ce que FIRE-1 peut faire :
</div>

* Parcourir automatiquement le contenu paginé.
* Interagir avec des boutons, des liens et des éléments dynamiques.
* Réaliser des extractions avancées sur plusieurs pages.

<div id="how-to-enable-fire-1">
  ## Comment activer FIRE-1
</div>

L’activation de FIRE-1 est simple. Il suffit d’inclure un objet `agent` dans votre requête API de scraping ou d’extraction :

```json theme={null}
"agent": {
  "model": "FIRE-1",
  "prompt": "Saisissez ici vos instructions de navigation détaillées."
}
```

*Remarque :* Le champ `prompt` est requis pour les requêtes de scraping et indique précisément à FIRE-1 comment interagir avec la page web.

<div id="example-usage-with-scrape-endpoint">
  ## Exemple d’utilisation avec le point de terminaison /scrape
</div>

Voici un exemple rapide utilisant FIRE-1 avec le point de terminaison /scrape pour parcourir des listes de produits page par page :

```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/scrape \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/products?page=1",
    "formats": ["markdown"],
    "agent": {
      "model": "FIRE-1",
      "prompt": "Navigate through the product listings by clicking the \'Next Page\' button until disabled. Scrape each page."
    }
  }'
```

Dans ce scénario, FIRE-1 gère intelligemment la pagination et récupère l’ensemble des produits.

<div id="considerations">
  ## Points à prendre en compte
</div>

* L’utilisation de FIRE-1 peut consommer plus de crédits selon la complexité de la tâche et le niveau d’interaction.
* Assurez-vous que vos prompts indiquent clairement à FIRE-1 quoi faire afin d’optimiser les résultats et l’efficacité.

<div id="start-using-fire-1-today">
  ## Commencez à utiliser FIRE-1 dès aujourd’hui
</div>

Découvrez dès aujourd’hui l’avenir du web scraping :

* **Essayez FIRE-1 :** Intégrez une navigation intelligente à vos workflows de scraping et d’extraction.
* **Explorez la documentation :** Découvrez-en plus dans notre [documentation complète](https://docs.firecrawl.dev/agents/fire-1).
* **Besoin d’aide ?** Rejoignez notre [communauté Discord](https://discord.gg/S7Enyh9Abh) ou écrivez à [help@firecrawl.com](mailto:help@firecrawl.com).
  **Prêt à tirer parti d’un scraping piloté par l’IA ?** [Inscrivez-vous à Firecrawl](https://firecrawl.dev/signup) et commencez avec FIRE-1 dès aujourd’hui.