使用 PHP 构建全功能 Agentic 应用

[!IMPORTANT] 获取最新功能、独家教程以及构建 PHP AI Agent 的专家建议。加入 PHP 开发者社区，共同开启 AI 开发的未来。 订阅简报

在继续之前，请给 Neuron AI 项目加颗星 ⭐️ 以支持我们的社区。谢谢！

什么是 Neuron？

Neuron 是一个用于创建和编排 AI Agent 的 PHP 框架。它通过强大且灵活的架构，让您可以将 AI 实体集成到 PHP 应用程序中。我们提供了贯穿 Agent 应用开发生命周期的工具，从 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)

操作指南

• 安装
• 创建 Agent
• 与 Agent 对话
• 监控
• AI 提供商
• 工具与工具包
• MCP 连接器
• 结构化输出
• RAG
• 工作流
• AI 辅助开发
• 安全漏洞
• 官方文档

安装

通过 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 并非传统意义上的编程。没有静态类型，微小的改动就会导致输出失效，冗长的 Prompt 会增加延迟，而且没有任何两个模型在相同的 Prompt 下表现完全一致。

控制 AI 应用程序的最佳方式是使用 Inspector。注册后，请确保设置 I...