Neuron AI | Firecrawl

Documentação oficial do Neuron AI: docs.neuron-ai.dev/agent/toolsDê aos agentes PHP recursos de busca na web e leitura de páginas com o Firecrawl

Visão geral

Neuron AI é um framework agêntico para PHP. Ele já vem com um toolkit do Firecrawl, permitindo que um agente Neuron faça uma busca na web e leia qualquer página como Markdown limpo durante uma execução.

Início rápido

Instale o Neuron AI 4.1.3 ou superior:

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

Obtenha uma API key no seu painel do Firecrawl e configure-a como FIRECRAWL_API_KEY
Adicione o toolkit ao seu agente:

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

Ferramentas

Ferramenta	Nome visto pelo agente	O que faz
`FirecrawlSearchTool`	`web_search`	Faz buscas na web, ou em notícias quando o agente solicitar, com um intervalo de tempo opcional
`FirecrawlScrapeTool`	`url_reader`	Retorna o conteúdo principal de uma página em Markdown

Você também pode adicionar cada ferramenta separadamente, por exemplo: FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY')).

Obtenha o conteúdo da página com cada resultado de busca

Por padrão, uma busca retorna o título, a URL e a descrição de cada resultado. Ao passar scrapeOptions, cada resultado também inclui a página completa em Markdown, assim o agente não precisa fazer uma segunda chamada para lê-la:

use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlSearchTool;

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

withOptions() substitui os valores padrão e aceita qualquer parâmetro de busca. O termo de busca é sempre fornecido pelo agente.

Recursos