Neuron AI | Firecrawl

Neuron AI 官方文档： docs.neuron-ai.dev/agent/tools借助 Firecrawl，为 PHP 代理提供网页搜索和页面读取能力

概览

Neuron AI 是一个面向 PHP 的代理式框架，内置了 Firecrawl 工具包，让 Neuron 代理能够在运行过程中进行网页搜索，并以干净的 Markdown 格式读取任意页面。

快速开始

安装 Neuron AI 4.1.3 或更高版本：

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

在 Firecrawl Dashboard 中获取 API 密钥，并将其设置为 FIRECRAWL_API_KEY
将该工具包添加到你的代理中：

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

工具

工具	代理看到的名称	功能
`FirecrawlSearchTool`	`web_search`	搜索网页 (代理需要时也可搜索新闻) ，可选指定时间范围
`FirecrawlScrapeTool`	`url_reader`	以 Markdown 格式返回页面的主要内容

你也可以单独添加其中任一工具，例如 FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))。

在每个搜索结果中获取页面内容

默认情况下，搜索会返回每个结果的标题、URL 和描述。传入 scrapeOptions 后，每个结果还会附带 Markdown 格式的完整页面内容，代理无需再发起一次调用来读取页面：

use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlSearchTool;

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

withOptions() 会覆盖默认值，并支持任意搜索参数。搜索查询始终由代理提供。

资源