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

# Neuron AI

> Effectuez des recherches sur le web et lisez des pages au format Markdown depuis des agents IA Neuron AI en PHP

<Note>
  **Documentation officielle de Neuron AI :** [docs.neuron-ai.dev/agent/tools](https://docs.neuron-ai.dev/agent/tools)

  Permettez à vos agents PHP d’effectuer des recherches sur le web et de lire des pages grâce à Firecrawl
</Note>

<h2 id="overview">
  Présentation
</h2>

[Neuron AI](https://neuron-ai.dev) est un framework agentique pour PHP. Il intègre un kit d’outils Firecrawl qui permet à un agent Neuron d’effectuer des recherches sur le web et de lire n’importe quelle page sous forme de Markdown propre au cours d’une exécution.

<h2 id="quick-start">
  Démarrage rapide
</h2>

1. Installez Neuron AI 4.1.3 ou une version ultérieure :

```bash theme={null}
composer require neuron-core/neuron-ai:^4.1.3
```

2. Obtenez une clé API depuis votre [tableau de bord Firecrawl](https://www.firecrawl.dev/app/api-keys) et définissez-la dans `FIRECRAWL_API_KEY`
3. Ajoutez le kit d’outils à votre agent :

```php theme={null}
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlToolkit;

class ResearchAgent extends Agent
{
    ...

    protected function tools(): array
    {
        return [
            FirecrawlToolkit::make(
                key: getenv('FIRECRAWL_API_KEY')
            ),
        ];
    }
}
```

<h2 id="tools">
  Outils
</h2>

| Outil | Nom vu par l'agent | Rôle |
| - | - | - |
| `FirecrawlSearchTool` | `web_search` | Effectue une recherche sur le web, ou dans les actualités si l'agent le demande, avec une plage temporelle facultative |
| `FirecrawlScrapeTool` | `url_reader` | Renvoie le contenu principal d'une page au format Markdown |

Vous pouvez aussi ajouter un seul de ces outils, par exemple `FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))`.

<h2 id="get-page-content-with-each-search-result">
  Obtenir le contenu de la page avec chaque résultat de recherche
</h2>

Par défaut, une recherche renvoie le titre, l'URL et la description de chaque résultat. Si vous passez `scrapeOptions`, chaque résultat inclut aussi la page complète au format Markdown : l'agent n'a donc pas besoin d'un second appel pour la lire :

```php theme={null}
use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlSearchTool;

FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))->withOptions([
    'limit' => 5,
    'scrapeOptions' => [
        'formats' => ['markdown'],
        'onlyMainContent' => true,
    ],
]);
```

`withOptions()` remplace les valeurs par défaut et accepte tous les [paramètres de recherche](/fr/api-reference/endpoint/search). La requête de recherche est toujours fournie par l'agent.

<h2 id="resources">
  Ressources
</h2>

* [Outils et kits d’outils Neuron AI](https://docs.neuron-ai.dev/agent/tools)
* [Documentation sur la recherche Firecrawl](/fr/features/search)
* [Documentation sur l’extraction Firecrawl](/fr/features/scrape)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.