PHP Agentic 实战01〡Neuron 框架入门认知

PHP 生态中 AI 集成

Neuron AI、Symfony AI 和 Laravel AI 是 PHP 生态中用于 AI 集成的三个不同项目，主要区别在于定位、框架依赖性和功能侧重。

Neuron 是什么

Neuron 是一个用于开发智能体（Agentic）应用的 PHP 框架。它负责处理编排、数据加载和调试等繁重工作，为你清除了障碍，让你专注于项目的创意核心。从第一行代码开始，一直到构建完整的多智能体系统，你都可以自由地创建 AI 实体，让它们以你设想的方式进行思考和行动。

官网 https://www.neuron-ai.dev

PHP 生态首个多 Ai Agentic 架构框架 Neuron

Neuron 架构

强类型系统

框架在整个代码库中充分利用 PHP 8 成熟的类型系统，每个方法签名、属性和返回值都明确标注类型。整个框架通过 PHPStan 100% 类型覆盖检查。

IDE 友好

强类型设计意味着你的 IDE 可以为智能体配置、工具参数和响应处理提供准确的自动补全。方法签名包含详细的 PHPDoc 注释，在类型提示之外提供更多上下文，解释参数预期和返回值结构。

这一基础让调试周期更快，也更容易与 Symfony 或 Laravel 等框架集成。我们假设你正在构建需要团队维护、扩展和理解的系统，而不仅仅是个人实验。

精心设计的架构

无论你是在 Laravel 应用、Symfony 项目、Webman 框架还是自定义 MVC 框架中工作，Neuron 都能无缝集成到现有代码库中，无需重构或破坏已建立的环境。

Neuron 在适当的地方使用标准的 PSR 接口，并保持最少的外部依赖，避免在不同 PHP 环境和框架版本之间产生冲突。这一设计选择解决了引入新库时常见的版本不兼容问题。

对于跨多个项目工作的团队，这种方法提供了持续的一致性。无论你是用纯 PHP 构建新的微服务、扩展 WordPress 站点，还是为企业级的 Symfony 和 Laravel 应用添加功能，相同的 Neuron 模式和实现都能通用。项目之间的知识转移变得无缝，开发者可以在整个 PHP 项目组合中充分利用 Neuron 专长。

社区驱动

这些设计原则为所有 PHP 社区创建了一个统一的 AI 开发生态系统。Neuron 没有将创新碎片化为特定框架的解决方案，而是让 Laravel 开发者、Symfony 贡献者、WordPress 插件作者以及自定义框架维护者之间能够协作。当 Neuron 核心功能得到改进时，每一位 PHP 开发者都能受益。

Neuron 的通用方法吸引了来自整个 PHP 生态的贡献者，从而带来更健壮的实现、在不同环境下的更广泛测试，以及新功能的更快开发。这种协作方式也为新手提供了更好的支持，因为来自各种 PHP 背景的有经验开发者可以提供指导和帮助。

支持多种提供商

Neuron 为大型语言模型使用统一的接口（AIProviderInterface），以及其他组件，例如嵌入、向量存储、工具包等。模块化架构允许你根据需要更换组件，无论是更换语言模型提供商、调整内存后端，还是跨多个服务器扩展。

这里使用中国智普的 ZAI 模型作为示例

namespace App\Neuron;

useNeuronAI\Agent\Agent;
useNeuronAI\Chat\Messages\UserMessage;
useNeuronAI\Providers\AIProviderInterface;
useNeuronAI\Providers\ZAI\ZAI;

class MyAgent extends Agent
{
    protectedfunction provider(): AIProviderInterface
    {
        returnnew ZAI(
            key: 'ZAI_API_KEY',
            model: 'glm-5',
            parameters: [], // Add custom params (temperature, logprobs, etc)
        );
    }
}

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

echo $message->getContent();
// Hi, how can I help you today?

AI 智能体是什么

AI 智能体是一个由人工智能生成输出的软件组件。这些组件能够理解人类语言，并根据它们拥有的上下文以及你提供的集成工具来执行任务。

你需要一个像 Neuron 这样的智能体框架，来连接额外的组件并处理广泛的任务。这些智能代理可以从回答简单问题，到解决需要推理、决策以及与外部系统主动交互的复杂问题。

与原始 LLM（主要在对话中提供信息和回答问题）相比，AI 智能体可以通过外部来源扩展知识，并采取独立行动来完成任务。

虽然简单的 LLM 可以在对话中直接回答你的问题，但 AI 智能体可能能够：

• 在多个知识库中研究信息并为你整理汇总
• 通过回复简单消息来管理你的电子邮件
• 从数据库中读取数据，并在重要事件发生时通过邮件提醒你

区分智能体与传统软件的关键特征是：它们能够在信息不完整的情况下运行，并适应不断变化的需求，就像人类一样。

为什么要在 PHP 中构建 AI 智能体？

如果你已经在使用 PHP，Neuron 允许你直接将 AI 功能集成到现有代码库中，而无需学习新语言或重构应用。简单来说，你不需要学习任何新的编程语言。Neuron 大幅降低了为 Web 应用、内容管理系统、电商平台和业务后端添加智能的门槛。

现代 PHP 提供了强大的面向对象编程特性、强类型能力以及优秀的性能特点，使其非常适合开发 AI 智能体。PHP 成熟的生态系统和简洁的部署模型，为构建可靠的智能体系统提供了坚实基础。

多智能体问题

当多个智能体需要协作时，构建 AI 应用很快就会变得复杂。管理智能体之间的状态、优雅地处理失败，以及在不同 AI 服务之间维护对话上下文，会产生复杂的依赖链。

没有合适的编排，开发者往往不得不使用脆弱的条件逻辑、手动状态管理和不具备扩展性的顺序处理。你如何设计让智能体能够协同工作、共享信息、从失败中恢复，同时保持清晰、可调试的代码的系统呢？