> 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**：编排整个报告生成过程

* **规划**：创建报告结构
* **GenerateSectionContent**：使用搜索结果生成每个部分的内容
* **格式化**：汇总最终报告

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

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

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

### 旅行规划代理

该项目演示了如何使用 Neuron PHP 框架为 agentic 应用创建旅游规划器。

使用的技术栈：

* 用于多代理编排的 Neuron 工作流。
* [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 工作流](https://docs.neuron-ai.dev/workflow/getting-started) 用于多代理编排。
* [SerpAPI](https://serpapi.com/) 用于查找酒店、航班和景点；使用大型语言模型为任意主题生成全面的研究报告，重点强调模块化、可扩展性和实时结果。

<figure><img src="https://content.gitbook.com/content/GHx4l2LknIex7vFIUg1R/blobs/EKh727BovIG1YXS5MQWw/laravel-travel-planner-ai-agent.png" 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
```

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