> ## 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 (Agente) (Beta)

> FIRE-1 é um agente de IA que possibilita navegação inteligente e interação com páginas da web

FIRE-1 é um agente de IA que potencializa os recursos de scraping do Firecrawl por meio de navegação e interação inteligentes na web. Ele lida com paginação, controla ações do navegador e percorre estruturas complexas de sites para viabilizar uma extração de dados mais completa do que os métodos tradicionais de scraping.

<div id="what-fire-1-can-do">
  ### O que o FIRE-1 pode fazer:
</div>

* Navegar automaticamente por conteúdo paginado.
* Interagir com botões, links, campos e elementos dinâmicos.
* Realizar tarefas avançadas de extração em várias páginas.

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

Para ativar o agente FIRE-1, inclua o objeto `agent` no payload da sua requisição de API para os endpoints `scrape` ou `extract`.

O objeto `agent` possui as seguintes propriedades:

* `model` (string, opcional): Especifica o modelo de IA a ser usado. Se não for fornecido, o padrão é `FIRE-1`. Atualmente, `FIRE-1` é o único modelo disponível.
* `prompt` (string, obrigatório para o endpoint `scrape`): Fornece instruções para o agente de IA, descrevendo que conteúdo buscar e como navegar no site (por exemplo, como lidar com paginação, quais botões clicar, etc.). Em `/extract`, ele usará o prompt fornecido no parâmetro `prompt`.

<div id="using-fire-1-with-the-scrape-endpoint">
  ### Usando o FIRE-1 com o endpoint /scrape
</div>

Você pode usar o FIRE-1 (Agente) com o endpoint `/v1/scrape` para aplicar navegação inteligente antes de fazer o scrape do conteúdo final.

**Exemplo (cURL):**

```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer SUA_CHAVE_DE_API' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "Navegue pelas listagens de produtos clicando no botão “Próxima página” até que ele fique desativado. Extraia o conteúdo de cada página visitada."
      }
    }'
```

Neste exemplo, o FIRE-1 (Agente) é instruído a navegar pela paginação das listagens de produtos antes que a raspagem final seja executada.

<div id="using-fire-1-with-the-extract-endpoint">
  ### Usando o FIRE-1 com o endpoint Extract
</div>

Da mesma forma, você pode usar o FIRE-1 (Agente) com o endpoint `/v1/extract` para tarefas complexas de extração que exigem navegação por várias páginas ou interação com elementos.

**Exemplo (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"
      }
    }'
```

Aqui, o agente garante que todos os comentários sejam carregados na página ao interagir com o botão "Carregar mais comentários" antes de iniciar o processo de extração com base no schema e no prompt fornecidos.
**Observação:** O FIRE-1 (Agente) oferece recursos avançados, mas pode consumir mais créditos dependendo da complexidade das instruções de navegação e da quantidade de páginas com as quais interage.

<div id="meet-fire-1-intelligent-navigation-and-interaction">
  ### Conheça o FIRE-1: Navegação e Interação Inteligentes
</div>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/launch-week/lw3-d2-3.webp" alt="Visualização do FIRE-1 (Agente)" />

O FIRE-1 leva a inteligência do Firecrawl a um novo patamar, aprimorando suas tarefas de scraping com navegação por estruturas complexas de sites, tratamento de paginação, interação com conteúdo dinâmico e muito mais. Esse poderoso agente de IA garante uma extração abrangente de dados, indo além dos métodos tradicionais de scraping.

<div id="what-fire-1-can-do">
  ### O que o FIRE-1 pode fazer:
</div>

* Navegar automaticamente por conteúdos paginados.
* Interagir com botões, links e elementos dinâmicos.
* Realizar tarefas avançadas de extração em várias páginas.

<div id="how-to-enable-fire-1">
  ## Como habilitar o FIRE-1
</div>

Ativar o FIRE-1 é simples. Basta incluir um objeto `agent` na sua solicitação à API de scrape ou extract:

```json theme={null}
"agent": {
  "model": "FIRE-1",
  "prompt": "Insira aqui suas instruções detalhadas de navegação."
}
```

*Nota:* O campo `prompt` é obrigatório em solicitações ao endpoint /scrape, indicando exatamente ao FIRE-1 como interagir com a página da web.

<div id="example-usage-with-scrape-endpoint">
  ## Exemplo de uso com o endpoint /scrape
</div>

Veja um exemplo rápido usando o FIRE-1 com o endpoint /scrape para paginar entre listagens de produtos:

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

Neste cenário, o FIRE-1 navega pela paginação de forma inteligente e coleta todos os produtos.

<div id="considerations">
  ## Considerações
</div>

* O uso do FIRE-1 pode consumir mais créditos, dependendo da complexidade da tarefa e da profundidade da interação.
* Certifique-se de que seus prompts orientem claramente o FIRE-1 para otimizar os resultados e a eficiência.

<div id="start-using-fire-1-today">
  ## Comece a usar o FIRE-1 hoje
</div>

Experimente o futuro do web scraping hoje:

* **Teste o FIRE-1:** Integre navegação inteligente aos seus fluxos de scraping e extração.
* **Explore a documentação:** Saiba mais na nossa [documentação completa](https://docs.firecrawl.dev/agents/fire-1).
* **Precisa de ajuda?** Entre na nossa [comunidade no Discord](https://discord.gg/S7Enyh9Abh) ou envie um e-mail para [help@firecrawl.com](mailto:help@firecrawl.com).
  **Pronto para potencializar o scraping com IA?** [Crie uma conta no Firecrawl](https://firecrawl.dev/signup) e comece com o FIRE-1 hoje.