> 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 是一个用于开发 agentic 应用的 PHP 框架。通过处理提供方编排、记忆管理、UI 集成和调试等繁重工作，Neuron 为你扫清障碍，让你专注于项目的创造性核心。从第一行代码到一个完全编排的多智能体系统，你都可以自由构建 AI 实体，让它们按照你设想的方式思考和行动。

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

<figure><img src="https://content.gitbook.com/content/GHx4l2LknIex7vFIUg1R/blobs/WIjdF4h01xkBuRjveyhK/neuron-ai-architecture.png" alt=""><figcaption><p>Neuron 架构</p></figcaption></figure>

### 从一个提示开始

复制并粘贴此初始提示，告诉你的编码代理如何在你的项目中安装和配置 Neuron AI。

```
你将要在这个项目中设置 Neuron AI，这是一个用于构建代理式应用程序的 PHP 框架， 
在这个项目中，你必须按顺序执行三个步骤。 

- 首先，安装框架：检查 composer.json，如果还没有依赖 neuron-core/neuron-ai， 
运行 `composer require neuron-core/neuron-ai`。 
- 其次，安装随框架提供的 agent 技能 
在项目根目录运行 `npx skills add ./vendor/neuron-core/neuron-ai/skills -y`。 
这些技能是通过符号链接连接的，因此每当 Neuron 
通过 Composer 更新时，它们都会保持最新。从那以后，在你编写任何 Neuron 
代码之前，先加载相关技能，而不要依赖你对该框架的记忆，因为你的记忆可能 
描述的是一个较旧的版本。 
- 第三，弄清楚这是什么类型的应用。查看 composer.json 
和项目结构，以判断它是 Laravel 应用还是 Symfony 应用，然后 
激活匹配的技能：neuron-laravel-integration 或 neuron-symfony-integration。 
如果 Neuron 已经是应用的一部分，就逐项查看该技能的基础检查清单 
逐项检查。报告与推荐设置不同的地方。 

如果应用中还没有 Neuron，请按照同样的清单进行首次设置。 
如果应用两种框架都没有使用，就从一个使用 neuron-agent 技能的普通 PHP agent 开始。 
最后用简短总结说明你安装了什么以及你发现了什么。
```

### 对多个提供方的支持

Neuron 为 LLM 提供方使用统一接口（`AIProviderInterface`）以及其他组件，例如 [记忆](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/chat-history-and-memory.md), [嵌入](https://docs.neuron-ai.dev/neuron-v3-zh/rag/embeddings-provider.md), [向量存储](https://docs.neuron-ai.dev/neuron-v3-zh/rag/vector-store.md), [工具包](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->chat(new UserMessage("Hi!"))
    ->getMessage();

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

{% endtab %}
{% endtabs %}

查看所有受支持的提供方，请在 [AI 提供商](https://docs.neuron-ai.dev/neuron-v3-zh/ti-gong-shang/ai-provider.md) 部分中查看。

### 视频教程

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

更多资源请见： [视频教程](https://docs.neuron-ai.dev/neuron-v3-zh/gai-lan/fast-learning-by-video.md#video)

### 为什么选择 Neuron

你的下一个应用将是 agentic 的。越来越多的新软件不再是一个逐步加入 AI 功能的 Web 应用，而是一个天生就以 agentic 为核心的应用，其中 agent 本身就是架构，决定系统如何推理、行动，以及如何与用户界面交互。构建这类应用需要一套特定的基础：带检查点的事件驱动工作流、human-in-the-loop、可中断、多智能体编排、流式传输，以及像 AG-UI 和 Vercel AI SDK 协议、MCP 和异步执行这样的 agentic UI 协议。

在 PHP 生态中，这套基础只在一个地方完整具备。以下每一项都是本文档的一个章节： [工作流](https://docs.neuron-ai.dev/workflow/getting-started.md), [Human in the loop](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/tool-approval.md), [流式传输与 UI 协议](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/streaming.md#stream-adapters), [MCP](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/mcp-connector.md), [异步](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/async.md), [中间件](https://docs.neuron-ai.dev/neuron-v3-zh/gong-zuo-liu/middleware.md), [评估](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/evaluation.md).

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

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

Neuron 也是 PHP 中唯一专注于 agentic 应用开发的垂直生态系统。围绕这个框架，有一个专为 agentic 应用设计的扩展、工具和技术注册表，并且越来越多的公司正在基于同一架构进行构建，而不是从零散的部分自行拼装。

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

## 资源

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

近年来，现代智能体技术与传统 PHP 开发之间的差距一直在不断扩大。虽然 Python 开发者拥有丰富的库和框架来创建 AI 智能体，但 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)

我们正在使用 [讨论](https://github.com/inspector-apm/neuron-ai/discussions) 作为与正在使用 Neuron 构建其 Agentic 应用的 PHP 开发者交流的地方。我们希望你：

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

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

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

追踪并评估你的 agent 执行流程，帮助你自信地维护生产级实现。查看 [**监控集成**](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/observability.md).

## 保持联系

* 网站与通讯： [https://neuron-ai.dev](https://neuron-ai.dev/)
* 仓库： [https://github.com/neuron-code/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/>
