Neuron AI | Firecrawl

Neuron AI 公式ドキュメント: docs.neuron-ai.dev/agent/toolsFirecrawl を使って、PHP エージェントに Web 検索とページ読み取りの機能を追加します

概要

Neuron AI は PHP 向けのエージェントフレームワークです。Firecrawl ツールキットが同梱されているため、Neuron の Agent は実行中にウェブを検索し、任意のページをクリーンな Markdown として読み取れます。

クイックスタート

Neuron AI 4.1.3 以降をインストールします：

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

Firecrawl ダッシュボードでAPIキーを取得し、FIRECRAWL_API_KEY として設定します
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')
            ),
        ];
    }
}

ツール

ツール	Agent から見える名前	機能
`FirecrawlSearchTool`	`web_search`	Web を検索します (Agent が要求した場合はニュースを検索) 。期間も任意で指定できます
`FirecrawlScrapeTool`	`url_reader`	ページのメインコンテンツを Markdown 形式で返します

いずれかのツールを単独で追加することもできます。例: FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))

検索結果ごとにページのコンテンツを取得する

デフォルトでは、検索は各結果のタイトル、URL、説明を返します。scrapeOptions を渡すと、各結果にページ全体の Markdown も含まれるため、Agent がページを読むために追加の呼び出しを行う必要がなくなります。

use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlSearchTool;

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

withOptions() はデフォルト値を置き換えるもので、任意の検索パラメータを指定できます。検索クエリは常に Agent 側から渡されます。

参考リソース