neuron-core/neuron-ai

The PHP Agentic Framework to build production-ready AI driven applications. Connect components (LLMs, vector DBs, memory) to agents that can interact with your data. With its modular architecture it's best suited for building RAG, multi-agent workflows, or business process automations.

agentagentic-aiagentic-frameworkagentsaillmllm-inferencellmsphpvector-database

GAI 中文摘要

Neuron 是一个专为 PHP 开发者设计的智能体（Agentic）开发框架，旨在简化生产级 AI 驱动应用的构建过程。它通过模块化架构将大语言模型、向量数据库和记忆组件有机结合，帮助开发者高效构建复杂的 AI 业务流程。

提供统一的 LLM 接口，方便开发者灵活接入多种大语言模型。内置多智能体编排功能，支持构建复杂的协作式 AI 工作流。集成完善的 RAG（检索增强生成）支持，能够轻松实现基于自有数据的知识库问答。提供全生命周期的管理工具，涵盖数据加载、模型交互、监控与调试等环节。支持与 Laravel 和 Symfony 等主流 PHP 框架的深度集成，提供优雅的开发体验。

该框架非常适合寻求在现有 PHP 生态中引入 AI 能力的开发者，特别适用于构建智能客服系统、企业级知识库问答以及自动化业务处理流程等场景。

⭐

1.8k

Stars

🔱

195

Forks

👁

Watchers

📋

Issues

PHPMIT创建于 2025/3/2更新于昨天

在 GitHub 上查看访问主页

README

由 Gemini 翻译整理

使用 PHP 构建功能完善的 Agentic 应用

[!IMPORTANT] 抢先获取新功能、独家教程以及使用 PHP 构建 AI Agent 的专家建议。加入 PHP 开发者社区，共同引领 AI 开发的未来。订阅新闻通讯

在继续之前，请在 GitHub 上点个星标 ⭐️ 以支持我们的社区。谢谢！

Neuron 是什么？

Neuron 是一个用于创建和编排 AI Agent 的 PHP 框架。它允许你通过强大且灵活的架构，将 AI 实体集成到 PHP 应用程序中。我们为 Agentic 应用的整个开发生命周期提供工具，涵盖 LLM 接口、数据加载、多 Agent 编排，以及监控和调试。此外，我们还提供教程和其他教育内容，帮助你在项目中上手使用 AI Agent。

视频教程

系统要求

PHP: ^8.1

官方文档

访问官方文档

指南与教程

查看技术指南和教程库，了解如何开始使用 Neuron 创建你的 AI Agent： https://docs.neuron-ai.dev/overview/fast-learning-by-video。

Neuron 是你项目中完美的 AI 架构。

Laravel

Neuron 提供了定义明确的封装模式，允许你在专属命名空间中构建 Agent 系统。你可以享受到与你喜爱的其他生态包（如 Filament 或 Nova）完全一致的开发体验。

示例项目 (GitHub)

Symfony

Neuron 的所有组件都遵循其接口定义，因此你可以使用 Symfony 服务容器来定义依赖关系并自动化对象创建。观看它是如何在真实项目中工作的。

Symfony & Neuron (YouTube)

安装

通过 composer 安装最新版本：

composer require neuron-core/neuron-ai

创建 Agent

Neuron 提供了 Agent 类，你可以通过继承该类来获取框架的核心功能，从而创建功能完备的 Agent。该类会自动为你管理一些高级机制，例如内存、工具、函数调用以及 RAG（检索增强生成）。你可以在文档中深入了解这些方面。

使用以下命令创建一个 Agent：

vendor/bin/neuron make:agent DataAnalystAgent

与 Agent 对话

发送消息给 Agent 以获取底层 LLM 的响应：


$agent = DataAnalystAgent::make();


$response = $agent->chat(
    new UserMessage("Hi, I'm Valerio. Who are you?")
)->getMessage();
echo $response->getContent();
// I'm a data analyst. How can I help you today?


$response = $agent->chat(
    new UserMessage("Do you remember my name?")
)->getMessage();
echo $response->getContent();
// Your name is Valerio, as you said in your introduction.

正如你在上面的示例中看到的，Agent 具有当前对话的记忆功能。在文档中了解更多关于内存的信息。

监控与调试

将 AI Agent 集成到应用程序中时，你操作的不仅仅是函数和确定性代码，你还在编写能够影响概率分布的程序。同样的输入 ≠ 同样的输出。这意味着可重现性、版本控制和调试成为了现实问题。

你使用 Neuron 构建的许多 Agent 将包含多个步骤，涉及多次 LLM 调用、工具使用、外部内存访问等。随着应用程序变得越来越复杂，能够检查你的 Agent 到底在做什么以及为什么这样做变得至关重要。

为什么模型会做出某些决定？模型是在对什么数据做出反应？提示词工程（Prompting）并非传统意义上的编程。没有静态类型，微小的变化就会破坏输出，长提示词会导致延迟，且在相同的提示词下，没有两个模型的表现是完全一样的。

掌控 AI 应用程序的最佳方法是使用 Inspector。注册后，请确保设置 INSPECTOR_INGESTION_KEY。