> 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/gong-zuo-liu/getting-started.md).

# 快速开始

借助 human-in-the-loop 指导、调节并控制你的多 Agent 系统。

{% hint style="warning" %}

#### 编码代理技能

使用 **`/neuron-workflow`** 教会你的编码代理如何在你的应用中实现智能体工作流。从简单的线性流程到带有中断和持久化特性的复杂循环。

[AI 辅助开发](https://docs.neuron-ai.dev/neuron-v3-zh/gai-lan/agentic-development.md)
{% endhint %}

### 什么是工作流

工作流是一种由事件驱动、基于节点的方式，用于控制应用程序的执行流程。

你的应用程序被划分为称为节点的部分，这些节点由事件触发，并且它们自身会返回事件，从而触发更多节点。通过组合节点和事件，你可以创建任意复杂的流程，将逻辑封装起来，使你的应用程序更易于维护和理解。

节点可以是从一行代码到一个复杂智能体的任何东西。它可以有任意输入和输出，这些内容通过事件在各处传递。它就像代码层面的 n8n。

<figure><img src="https://99736354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGHx4l2LknIex7vFIUg1R%2Fuploads%2FX8gk7EUo9yJ3bglyhSqr%2Fworkflow-single-step.png?alt=media&amp;token=fc287a43-a099-4f1f-ab66-77f6150d779d" alt=""><figcaption></figcaption></figure>

工作流允许你将所有 Neuron 组件，如 AI 提供商、嵌入、数据加载器、聊天历史、向量存储等，作为独立组件来使用，从而创建完全定制的智能体实体。

Agent 和 RAG 类本身就是工作流。它们代表了可直接使用的实现，涵盖了工具调用、检索、结构化输出等方面最常见的模式。工作流允许你从零开始完整地编程你的智能体系统。如果需要在执行过程中执行 AI 操作，Agent 和 RAG 也可以像其他组件一样在工作流内部使用，以完成任务。

Neuron Workflow 的特别之处在于它的 **流式传输** 和 **中断** 能力。这意味着你的多智能体系统可以直接向客户端流式推送更新，在流程中途暂停，请求人工输入，等待反馈，然后从中断处原地继续——即使那是几个小时或几天之后。

### 为什么要使用工作流，而不是普通脚本？

你可能会想：“这听起来很棒，但为什么我不能只写一个带有一些 if 语句和函数的普通 PHP 脚本呢？” 这是一个很合理的问题，也是我在构建 Neuron 时经常听到的问题。答案在你考虑到当你的流程需要分支到多个路径、并发运行它们、实现多个循环和中间检查点、向客户端流式传输实时更新，甚至暂停、等待并恢复时，就会变得很清楚。

当你刚开始，而你的用例还相当简单时，你可能看不到工作流的真正潜力，这是正常的。请记住，如果事情变得糟糕，Neuron 已经具备合适的架构，能够帮助你在任何层级上扩展。

### 开发优势

从开发者的角度来看，工作流解决了几个令人头疼的问题：

**建模和维护复杂场景**：借助这些简单的构建块，你可以创建只有几个步骤的简单流程，也可以创建带有迭代循环和中间检查点的复杂工作流。

**人机协同**：无缝融入人工监督。你可以将 AI 部署到敏感领域，因为关键决策始终有人参与。

**流式传输**：你可以在工作流执行期间向客户端发送实时更新。

**使用检查器调试**：与其猜测为什么你的工作流做出了某个特定决策，不如直接查看任意节点上正在发生的确切情况。

### 监控与调试

你使用 Neuron 构建的许多应用都会包含多个步骤以及多次 LLM 调用。随着这些应用变得越来越复杂，能够检查你的代理系统内部究竟发生了什么变得至关重要。做到这一点的最佳方式是使用 [Inspector](https://inspector.dev/).

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}
