> 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/gai-lan/readme.md).

# 简介

### 什么是 Neuron

Neuron 是一个用于开发智能体应用的 PHP 框架。通过处理编排、数据加载和调试这些繁重工作，Neuron 为你扫清道路，让你专注于项目的创造性核心。从第一行代码到一个完全编排的多智能体系统，你都可以自由构建 AI 实体，使其按照你设想的方式思考和行动。

我们为整个智能体应用开发生命周期提供工具，从 LLM 接口，到数据加载，到多智能体编排，再到监控和调试。此外，我们还提供 [教程和其他教育内容](/neuron-v3-zh/gai-lan/fast-learning-by-video.md) 帮助你在项目中开始使用 AI Agents。

<figure><img src="/files/2e58d2a4812cdb2ae3b49adf8fcfe9dd358f9cee" alt=""><figcaption><p>Neuron 架构</p></figcaption></figure>

### 三步快速上手

**1）安装** 将 Neuron 安装到你的项目中：

```shellscript
composer require neuron-core/neuron-ai
```

**2）创建** 一个继承 `Agent` 类的智能体：

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        // 返回一个 AI 提供者（Anthropic、OpenAI、Ollama、Gemini 等）
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }
}
```

**3）与** 智能体对话：

```php
use NeuronAI\Chat\Messages\UserMessage;

$message = MyAgent::make()
    ->chat(new UserMessage("嗨，你是谁？"))
    ->getMessage();

echo $message->getContent();
// 我是一个使用 Neuron AI 框架构建的友好 AI 智能体，今天我能为你做什么？
```

### Laravel 演示

Neuron 提供了清晰定义的封装模式，让你可以在专用命名空间中处理 AI 组件。你可以享受到与其他你已经喜爱的生态包完全相同的体验，比如 Filament、Nova、Horizon 等。

<a href="https://www.youtube.com/watch?v=oSA1bP_j41w" class="button primary" data-icon="youtube">观看演示</a>

<a href="https://github.com/neuron-core/neuron-ai" class="button primary" data-icon="laravel">官方 Laravel 包</a>

### Symfony 演示

Neuron 的所有组件都属于其自己的接口，因此你可以轻松定义依赖，并使用 Symfony 服务容器自动创建对象。看看它在真实项目中如何工作。

<a href="https://www.youtube.com/watch?v=JWRlcaGnsXw" class="button primary" data-icon="youtube">Symfony 与 Neuron</a>

### 支持多个提供者

Neuron 为大语言模型使用通用接口（`AIProviderInterface`），同时也为其他组件使用通用接口，例如 [嵌入](/neuron-v3-zh/rag/embeddings-provider.md), [向量存储](/neuron-v3-zh/rag/vector-store.md), [工具包](/neuron-v3-zh/zhi-neng-ti/tools.md#toolkits-composable-agent-capabilities)等。模块化架构让你可以按需替换组件，无论你是在更换 LLM 提供者、调整记忆后端，还是在多个服务器之间扩展。

下面是几个示例：

{% tabs %}
{% tab title="Anthropic" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("嗨！"))
    ->getMessage();

echo $message->getContent();
// 嗨，今天我能帮你什么？
```

{% endtab %}

{% tab title="Ollama" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Ollama\Ollama;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Ollama(
            url: 'OLLAMA_URL',
            model: 'OLLAMA_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("嗨！"))
    ->getMessage();

echo $message->getContent();
// 嗨，今天我能帮你什么？
```

{% endtab %}

{% tab title="OpenAI" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\OpenAI\OpenAI;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new OpenAI(
            key: 'OPENAI_API_KEY',
            model: 'OPENAI_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("嗨！"))
    ->getMessage();

echo $message->getContent();
// 嗨，今天我能帮你什么？
```

{% endtab %}

{% tab title="Gemini" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Gemini\Gemini;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Gemini(
            key: 'GEMINI_API_KEY',
            model: 'GEMINI_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("嗨！"))
    ->getMessage();

echo $message->getContent();
// 嗨，今天我能帮你什么？
```

{% endtab %}

{% tab title="Mistral" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Gemini\Mistral;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Mistral(
            key: 'MISTRAL_API_KEY',
            model: 'MISTRAL_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("嗨！"))
    ->getMessage();

echo $message->getContent();
// 嗨，今天我能帮你什么？
```

{% endtab %}
{% endtabs %}

查看 [AI Provider](/neuron-v3-zh/ti-gong-shang/ai-provider.md) 部分中所有受支持的提供者。

### 视频教程

{% embed url="<https://www.youtube.com/watch?v=oSA1bP_j41w>" %}

更多资源在这里： [视频教程](/neuron-v3-zh/gai-lan/fast-learning-by-video.md#video)

### 为什么选择 Neuron

你的下一个应用将是智能体式的。新软件中不断增长的部分，已不再是沿途添加了 AI 功能的网页应用，而是从诞生之初就是智能体式的应用，其中智能体本身就是架构，驱动系统如何推理、行动以及与用户界面交互。构建这类应用需要一组特定的基础：带有检查点的事件驱动工作流、human-in-the-loop、可中断性、多智能体编排、流式传输，以及像 AG-UI、Vercel AI SDK 协议、MCP 和异步执行这样的智能体 UI 协议。

在 PHP 生态中，这套基础只存在于一个地方。它们分别是本文档中的一个章节： [工作流](/neuron-v3-zh/gong-zuo-liu/getting-started.md), [Human in the loop](/neuron-v3-zh/zhi-neng-ti/middleware.md#tool-approval-human-in-the-loop), [流式传输与 UI 协议](/neuron-v3-zh/zhi-neng-ti/streaming.md#stream-adapters), [MCP](/neuron-v3-zh/zhi-neng-ti/mcp-connector.md), [异步](/neuron-v3-zh/zhi-neng-ti/async.md)。你可以将它与 PHP 开发者可用的任何其他方案进行比较，而比较的结果就是答案。

当项目不断增长时，也没有第二个框架在等着你。入门指南中运行你的第一个智能体的同一个 Workflow，在生产环境中也能运行带有状态、循环和人工审批的多智能体系统。你在第一天学到的内容，就是你未来项目中交付的内容。

### 垂直且独立的生态系统

Neuron 也是 PHP 中唯一用于智能体应用开发的垂直生态系统。围绕这个框架，有一个专门为原生智能体应用设计的扩展、工具和技术注册体系，而且越来越多的公司正在基于同样的架构构建，而不是用零散的组件拼凑自己的方案。

对于软件公司来说，这里是一个能被认可为专家的地方，而不是又一个声称具备 AI 经验的团队。对于需要一个可以长期依赖的智能体基础的公司来说，这意味着要标准化采用一个整体方向就是这个领域的架构，而不是一个把智能体当作附加功能的通用库。

## 资源

### [电子书 - “从 PHP 中的 AI Agents 开始”](https://www.amazon.it/dp/B0F1YX8KJB)

现代智能体技术与传统 PHP 开发之间的差距近年来一直在扩大。虽然 Python 开发者拥有丰富的库和框架来创建 AI Agents，但 PHP 开发者常常在思考，如何在不彻底重塑技能栈或从头重建应用的情况下参与这场技术革命。

Neuron 改变了这一切。

本书既是开发者了解 AI Agents 概念的入门指南，也是 Neuron 框架的全面手册。

<a href="https://www.amazon.com/dp/B0F1YX8KJB" class="button secondary" data-icon="amazon">前往 Amazon</a>

<a href="https://play.google.com/store/books/details?pcampaignid=books_read_action&#x26;id=agJPEQAAQBAJ&#x26;pli=1" class="button secondary" data-icon="google">前往 GooglePlay</a>

### [通讯订阅](https://neuron-ai.dev)

注册 Neuron 内部 [通讯](https://neuron-ai.dev/) 以获取关于如何在 PHP 中开始进行 AI 开发的有价值论文、文章和最佳实践。

你将学习如何以正确的方式看待 AI 系统，理解 LLM 背后最重要的技术概念，以及如何使用 Neuron AI 框架将你的 AI 解决方案开始集成到 PHP 应用中。

### [论坛](https://github.com/inspector-apm/neuron-ai/discussions)

我们正在使用 [Discussions](https://github.com/inspector-apm/neuron-ai/discussions) 作为与正在使用 Neuron 构建智能体应用的 PHP 开发者建立联系的地方。我们希望你：

* 提出你想知道的问题。
* 分享想法。
* 与其他社区成员互动。
* 欢迎他人，并保持开放心态。

### [**Inspector.dev**](https://inspector.dev)

Neuron 是 Inspector 生态系统的一部分，作为一个可信赖的平台，用于创建可靠且可扩展的 AI 驱动解决方案。

追踪并评估你的智能体执行流程，帮助你自信地维护生产级实现。查看 [**监控集成**](/neuron-v3-zh/zhi-neng-ti/observability.md).

## 保持联系

* 网站与通讯： [https://neuron-ai.dev](https://neuron-ai.dev/)
* 仓库： [https://github.com/neuron-core/neuron-ai](https://github.com/inspector-apm/neuron-ai)
* Inspector： <https://inspector.dev>
* 电子书： <https://www.amazon.it/dp/B0F1YX8KJB>
* Linkedin： <https://www.linkedin.com/company/neuron-ai-php-framework>
* X： <https://x.com/neuronai_php>
* Instagram： <https://www.instagram.com/neuronai_php_adk/>