技巧与窍门

通过真实代码示例克服瓶颈，并了解工作流特性

节点太多？

当你处理很多节点、循环或分支时，节点总是以扁平列表的形式在工作流中注册。节点过多会让人难以直观跟踪执行流程，也难以聚焦于工作流的某一部分进行修改或新开发。

不要使用一个扁平的 20 节点数组，而是把它拆分成逻辑分区：

 class MyWorkflow extends Workflow
 {
     ... 
    protected function nodes(): array
    {
        return [
            ...$this->classificationProcess(),
            ...$this->analysis(),
            ...$this->postProcessing(),
        ];
    }
    
    /**
     * 初始分类流程
     */
    protected function classificationProcess(): array
    {
        return [
            // 这里是节点...
        ];
    }
}

展开运算符 (...) 保持运行时行为完全一致。它仍然是一个扁平数组。但现在， nodes() 方法看起来就像目录，每个分组都能自说明其用途。

示例项目

AIForm - 对话式数据收集

AIForm 是一个通过多轮自然语言对话收集结构化数据的组件。它使用 AI 代理逐步收集由结构化输出类定义的信息，并在此过程中验证每一项数据。

该表单会维护对话历史，跟踪已收集字段、缺失字段以及跨多轮的验证错误。

查看 GitHub 仓库

深度研究代理

这个项目受 Open Deep Research 启发，其实现使用了 LangGraph。也有其他实现，例如针对 llamaindex 的版本，以及其他方案。我们的版本利用 Neuron 构建了一个强大、模块化的研究与分析工作流。

Neuron Open Deep Research 提供了一种结构化的方法，使用大语言模型生成任何主题的全面研究报告，重点在于模块化、可扩展性和实时结果。

架构

DeepResearchAgent: 负责整体报告生成流程的编排

• Planning: 创建报告结构

• GenerateSectionContent: 使用搜索结果生成各个部分的内容

• Format: 编译最终报告

SearchWorkflow: 作为嵌套工作流处理搜索操作

• GenerateQueries: 根据章节主题创建搜索查询

• SearchTheWeb: 执行并行搜索并处理结果

查看 GitHub 仓库

旅行规划代理

这个项目展示了如何使用 Neuron PHP 框架为代理式应用创建一个旅游规划器。

使用的技术栈：

• 用于多代理编排的 Neuron Workflow。

• SerpAPI 用于查找酒店、航班和景点，使用大语言模型生成任何主题的全面研究报告，重点在于模块化、可扩展性和实时结果。

架构

TravelPlannerAgent: 负责整体行程生成流程的编排

节点

• 接待员: 收集用户提供的全部信息

• 分发器: 为航班、酒店和景点生成单独报告

  • 航班

  • 酒店

  • 景点

• GenerateItinerary: 生成最终报告

查看 GitHub 仓库

Laravel 旅行代理

这个项目展示了如何使用 Neuron PHP AI 框架在 Laravel 应用中集成多代理工作流。

使用的技术栈：

• Laravel 和 Livewire 用于该应用。

• Neuron Workflow 用于多代理编排。

• SerpAPI 用于查找酒店、航班和景点，使用大语言模型生成任何主题的全面研究报告，重点在于模块化、可扩展性和实时结果。

如何使用此项目

将项目下载到你的机器上，并在项目目录中打开终端。首先，安装 composer 依赖：

composer install

npm run build

php artisan migrate

创建一个 项目根目录中的 .env 文件（见 .env.example 作为模板），并根据你想连接的服务提供 API 密钥。

# 至少需要一个
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
OPENAI_API_KEY=

# 必需
SERPAPI_KEY=

# 可选
INSPECTOR_INGESTION_KEY=
INSPECTOR_TRANSPORT=sync

在浏览器中打开项目，注册一个账户，然后开始规划你的旅行。