> 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 智能体。

<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("Hi, who are you?"))
    ->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/agent/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("Hi!"))
    ->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("Hi!"))
    ->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("Hi!"))
    ->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("Hi!"))
    ->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("Hi!"))
    ->getMessage();

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

{% endtab %}
{% endtabs %}

查看所有受支持的提供商，见 [AI 提供商](/neuron-v3-zh/ti-gong-fang/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 为何独特

大多数智能体框架都要求你做出选择。有些简单到只需一个下午就能学会，但当你的用例第一次超出演示规模时，你就会碰到瓶颈。另一些则强大到足以应对某个用例，但在你交付真正产品之前，你会花上数周时间与它们的抽象层搏斗。

Neuron 建立在一种工作流架构之上，消除了这些妥协。最初的灵感来自 Python 世界里 LLmaindex 的 Workflow 概念。Neuron Workflow 以现代 PHP 的模式塑造而成，是一种 PHP 原生解决方案，如今已走上自己的道路；随着 PHP 中的智能体生态围绕它逐步成形，我们也会继续描绘这条路径。

**其结果是，一个新手第一天就能上手的基础架构，同时在底层已为严肃的智能体应用准备好一切**：统一消息层、工具与工具包、MCP、人机协同、智能体 UI 协议、多智能体交互、异步执行等等。当你的项目变得更宏大时，你无需更换框架。你在这段旅程开始时学到的架构，未来仍然是驱动你最复杂生产系统的同一套架构。

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

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

对于软件公司而言，这里是被认可为专家的地方，而不是又一个声称有 AI 经验的团队。对于需要一个能够长期依赖的智能体基础的公司来说，这意味着可以统一采用一种其整体方向都聚焦于这一领域的架构，而不是一个把智能体仅仅作为附加功能的通用库。

## 资源

### [电子书 -《在 PHP 中从 AI 智能体开始》](https://www.amazon.it/dp/B0F1YX8KJB)

近年来，现代智能体技术与传统 PHP 开发之间的差距一直在不断扩大。虽然 Python 开发者享有丰富的库和框架来创建 AI 智能体，但 PHP 开发者却常常在想，如何才能参与这场技术革命，而无需彻底重塑自己的技能，或从零开始重建应用程序。

Neuron 改变了一切。

本书既是开发者了解 AI 智能体概念的入门读物，也是 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/agent/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/>