> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-zh/zi-yuan/examples.md).

# 技巧与窍门

### 节点太多？

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

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

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

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

## 示例项目

### AIForm - 对话式数据收集

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

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

<a href="https://github.com/neuron-core/ai-form" class="button secondary" data-icon="github">查看 GitHub 仓库</a>

### 深度研究代理

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

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

#### 架构

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

* **Planning**: 创建报告结构
* **GenerateSectionContent**: 使用搜索结果生成各个部分的内容
* **Format**: 编译最终报告

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

* **GenerateQueries**: 根据章节主题创建搜索查询
* **SearchTheWeb**: 执行并行搜索并处理结果

<a href="https://github.com/neuron-core/deep-research-agent" class="button secondary" data-icon="github">查看 GitHub 仓库</a>

### 旅行规划代理

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

使用的技术栈：

* 用于多代理编排的 Neuron Workflow。
* [SerpAPI](https://serpapi.com/) 用于查找酒店、航班和景点，使用大语言模型生成任何主题的全面研究报告，重点在于模块化、可扩展性和实时结果。

#### 架构

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

#### 节点

* **接待员**: 收集用户提供的全部信息
* **分发器**: 为航班、酒店和景点生成单独报告
  * *航班*
  * *酒店*
  * *景点*
* **GenerateItinerary**: 生成最终报告

<a href="https://github.com/neuron-core/travel-planner-agent" class="button secondary" data-icon="github">查看 GitHub 仓库</a>

### Laravel 旅行代理

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

使用的技术栈：

* [Laravel](https://laravel.com/) 和 [Livewire](https://livewire.laravel.com/) 用于该应用。
* [Neuron Workflow](https://docs.neuron-ai.dev/workflow/getting-started) 用于多代理编排。
* [SerpAPI](https://serpapi.com/) 用于查找酒店、航班和景点，使用大语言模型生成任何主题的全面研究报告，重点在于模块化、可扩展性和实时结果。

<figure><img src="/files/e28942ef138eb1c9e53a12a99109b10c852f9eb6" alt=""><figcaption></figcaption></figure>

#### 如何使用此项目

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

```bash
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
```

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