# FIRE-1 (Agente) (Beta)

> FIRE-1 es un agente de IA que permite la navegación e interacción inteligentes con páginas web

FIRE-1 es un agente de IA que potencia las capacidades de scraping de Firecrawl mediante navegación e interacción web inteligentes. Puede gestionar la paginación, controlar acciones del navegador y recorrer estructuras web complejas para permitir una extracción de datos completa más allá de los métodos tradicionales de scraping.

<div id="what-fire-1-can-do">
  ### Qué puede hacer FIRE-1:
</div>

- Navegar automáticamente por contenido paginado.
- Interactuar con botones, enlaces, campos y elementos dinámicos.
- Realizar tareas avanzadas de extracción en múltiples páginas.

<div id="enabling-fire-1-agent">
  ## Habilitar FIRE-1 (Agente)
</div>

Para habilitar el agente FIRE-1, debes incluir el objeto `agent` en la carga de tu solicitud a la API para el punto de conexión `scrape` o `extract`.

El objeto `agent` tiene las siguientes propiedades:

*   `model` (string, opcional): Especifica el modelo de IA a utilizar. Si no se especifica, el valor predeterminado es `FIRE-1`. Actualmente, `FIRE-1` es el único modelo disponible.
*   `prompt` (string, requerido para el punto de conexión `scrape`): Proporciona instrucciones para el agente de IA, indicando qué contenido buscar y cómo navegar por el sitio web (por ejemplo, cómo manejar la paginación, qué botones hacer clic, etc.). En `/extract` usará el prompt indicado en el parámetro `prompt`.

<div id="using-fire-1-with-the-scrape-endpoint">
  ### Uso de FIRE-1 con el punto de conexión /scrape
</div>

Puedes usar el agente FIRE-1 con el punto de conexión `/v1/scrape` para realizar navegación inteligente antes de extraer el contenido final.

**Ejemplo (cURL):**

```bash
curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer TU_CLAVE_API' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "Navega por las listas de productos haciendo clic en el botón «Siguiente página» hasta que esté desactivado. Extrae el contenido de cada página visitada."
      }
    }'
```

En este ejemplo, se indica al FIRE-1 (Agente) que avance por las páginas de productos antes de realizar la extracción final.

<div id="using-fire-1-with-the-extract-endpoint">
  ### Uso de FIRE-1 con el endpoint de extracción
</div>

Del mismo modo, puedes aprovechar el agente FIRE-1 con el endpoint `/v1/extract` para tareas complejas de extracción que requieren navegar por varias páginas o interactuar con elementos.

**Ejemplo (cURL):**

```bash
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"
      }
    }'
```

Aquí, el agente se asegura de que se carguen todos los comentarios de la página al interactuar con el botón &quot;Cargar más comentarios&quot; antes de iniciar el proceso de extracción, en función del esquema y el prompt proporcionados.
**Nota:** El agente FIRE-1 ofrece capacidades potentes, pero puede consumir más créditos según la complejidad de las instrucciones de navegación y la cantidad de páginas con las que interactúe.

<div id="meet-fire-1-intelligent-navigation-and-interaction">
  ### Conoce FIRE-1: navegación e interacción inteligentes
</div>

![Visualización del agente FIRE-1](/launch-week/lw3-d2-3.webp)

FIRE-1 aporta un nuevo nivel de inteligencia a Firecrawl, mejorando tus tareas de scraping al navegar por estructuras complejas de sitios web, gestionar la paginación, interactuar con contenido dinámico y mucho más. Este potente agente de IA garantiza una extracción de datos integral que va más allá de los métodos tradicionales de scraping.

<div id="what-fire-1-can-do-2">
  ### Qué puede hacer FIRE-1:
</div>

- Navegar automáticamente por contenido paginado.
- Interactuar con botones, enlaces y elementos dinámicos.
- Realizar tareas de extracción sofisticadas en múltiples páginas.

<div id="how-to-enable-fire-1">
  ## Cómo habilitar FIRE-1
</div>

Activar FIRE-1 es sencillo. Solo tienes que incluir un objeto `agent` en tu solicitud a la API de scrape o extract:

```json
"agent": {
  "model": "FIRE-1",
  "prompt": "Aquí van tus instrucciones de navegación detalladas."
}
```

*Nota:* El campo `prompt` es obligatorio en las solicitudes de scraping y le indica a FIRE-1 con precisión cómo interactuar con la página web.

<div id="example-usage-with-scrape-endpoint">
  ## Ejemplo de uso con punto de conexión /scrape
</div>

Aquí tienes un ejemplo rápido de uso de FIRE-1 con el punto de conexión /scrape para paginar listados de productos:

```bash
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."
    }
  }'
```

En este escenario, FIRE-1 gestiona de forma inteligente la paginación y recopila todos los productos.

<div id="considerations">
  ## Consideraciones
</div>

* Utilizar FIRE-1 puede consumir más créditos en función de la complejidad de la tarea y de la profundidad de la interacción.
* Asegúrate de que tus prompts orienten claramente a FIRE-1 para optimizar los resultados y la eficiencia.

<div id="start-using-fire-1-today">
  ## Comienza a usar FIRE-1 hoy
</div>

Descubre hoy el futuro del web scraping:

- **Prueba FIRE-1:** Integra navegación inteligente en tus flujos de scraping y extracción.
- **Explora la documentación:** Obtén más información en nuestra [documentación completa](https://docs.firecrawl.dev/agents/fire-1).
- **¿Necesitas ayuda?** Únete a nuestra [comunidad en Discord](https://discord.gg/S7Enyh9Abh) o escribe a [help@firecrawl.com](mailto:help@firecrawl.com).
**¿Listo para aprovechar el scraping con IA?** [Regístrate en Firecrawl](https://firecrawl.dev/signup) y comienza con FIRE-1 hoy.