Neuron AI | Firecrawl

Documentation officielle de Neuron AI : docs.neuron-ai.dev/agent/toolsPermettez à vos agents PHP d’effectuer des recherches sur le web et de lire des pages grâce à Firecrawl

Présentation

Neuron AI 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.

Démarrage rapide

Installez Neuron AI 4.1.3 ou une version ultérieure :

composer require neuron-core/neuron-ai:^4.1.3

Obtenez une clé API depuis votre tableau de bord Firecrawl et définissez-la dans FIRECRAWL_API_KEY
Ajoutez le kit d’outils à votre agent :

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')
            ),
        ];
    }
}

Outils

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')).

Obtenir le contenu de la page avec chaque résultat de recherche

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 :

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. La requête de recherche est toujours fournie par l’agent.

Ressources