Neuron AI — PHP 智能体框架
在 PHP 中构建生产级 AI 应用，支持智能体、工作流、多智能体编排与 MCP。
证据显示：框架提供工具和MCP连接器，但未明确权限最小化设计；有human-in-the-loop模式，但未强制用户确认；数据流透明度有限，文档提及监控但未详细说明数据流向；敏感数据处理未明确；依赖安全未提及；外部效果（如数据库操作）未明确限制；无回滚机制；来源归属仅通过版权声明。扣分原因：缺乏具体实现细节和文档支持。
证据显示：README和代码示例一致，但未验证实际运行；依赖众多外部服务（如数据库、向量存储），但未提供可用性保证；错误消息未详细说明。扣分原因：静态审查无法验证运行，错误处理文档不足。
证据显示：面向PHP开发者，提供多种场景（RAG、Workflow等）；能力边界未明确；触发精度未详细说明；环境要求仅PHP 8.1，但依赖外部服务。扣分原因：能力边界和触发条件文档不足。
证据显示：README结构清晰，安装说明简单；命名稳定但未提供版本历史；示例丰富但FAQ缺失；已知限制未提及；MIT许可证明确；版本变更日志未提供；维护责任未明确。扣分原因：缺少FAQ、已知限制和变更日志。
证据显示：输出可用性高，提供结构化输出；边际价值高，提供独特功能；成本效益未评估。扣分原因：成本效益缺乏数据。
证据显示：README中的声明有文档链接，但未提供独立验证；跨来源佐证不足；事实与推断未明确区分。扣分原因：缺乏独立验证和事实/推断分离。
- 静态审查无法验证实际运行，所有评分基于源代码和文档。
- 未发现恶意代码，但需注意外部服务依赖和权限管理。
- 建议查阅官方文档获取更多细节，特别是安全性和错误处理。
这个 Agent 能做什么，适合哪些场景？
Neuron 是 PHP 生态中面向智能体应用开发的框架，提供从大语言模型接口、工具调用、向量数据库、记忆到多智能体协调、可观测性的一整套组件。它通过可扩展的 Agent 类、RAG 抽象和 Workflow 引擎，支持开发者构建从简单聊天到复杂自动化流程的各类应用。框架内置对多个主流 LLM 提供商的支持，并可通过 MCP 连接外部工具。Neuron 强调事件驱动、检查点和人机协同，适合需要将 AI 深度集成到现有 PHP 系统的团队。
Neuron 允许你通过 composer 安装后，使用 artisan 风格命令生成 Agent 类，并继承内置的 Agent 基类。你可以定义 provider() 来指定 LLM 提供商（如 Anthropic、OpenAI），通过 instructions() 设置系统提示词，通过 tools() 注册工具或工具包（如 MySQLToolkit）。Agent 会自动管理对话记忆、函数调用和 RAG。Workflow 组件让你可以将各组件（如 LLM、嵌入、数据加载器）作为独立模块编排自定义流程，并支持 human-in-the-loop 中断和恢复。框架还提供结构化输出支持（通过 PHP 属性和 SchemaProperty），以及通过 Inspector 进行监控和调试。
- PHP 开发者希望在现有 Laravel 或 Symfony 项目中快速集成 AI 助手，而不重写整个架构。
- 数据分析团队需要从 SQL 数据库生成报告，可通过 MySQLToolkit 让智能体查询并总结数据。
- 自动化流程需要人工审批节点，可使用 Workflow 的 human-in-the-loop 功能实现关键步骤审核。
- 需要将外部 MCP 服务器（如 modelcontextprotocol/server-everything）的工具连接到智能体，以扩展功能。
- 希望构建 RAG 应用，通过向量数据库（如 Pinecone）和嵌入提供程序（如 Voyage）检索私有文档。
- 开发者需要在多个 LLM 提供商之间切换，而不改变业务逻辑。
这个 Agent 有哪些优点和局限？
- 专为 PHP 设计，与 PHP 生态深度集成，提供类似 Laravel 的开发体验。
- 支持多种 LLM 提供商（Anthropic, OpenAI, Ollama 等），可轻松切换。
- 内置 MCP 连接器，可接入外部工具，扩展性强。
- Workflow 组件支持 human-in-the-loop，适合需要人工干预的复杂流程。
- 提供结构化输出和 RAG 支持，满足多种应用场景。
- 仅支持 PHP 8.1+，对旧版 PHP 项目不友好。
- 监控功能依赖第三方服务 Inspector，增加外部依赖。
- 框架相对年轻，社区和文档可能不如成熟 PHP 框架完善。
- 某些高级特性（如 MCP、RAG）需要额外的配置和组件，学习曲线较陡。
如何安装或部署这个 Agent？
要求 PHP ^8.1。使用 Composer 安装：composer require neuron-core/neuron-ai。
如何使用这个 Agent？
运行 vendor/bin/neuron make:agent DataAnalystAgent 生成智能体类，然后编辑该类，设置 provider() 和 instructions()。实例化并调用：$agent = DataAnalystAgent::make(); $response = $agent->chat(new UserMessage("Hi"))->getMessage(); 如需监控，设置环境变量 INSPECTOR_INGESTION_KEY。
这个 Agent 与同类方案有什么区别？
README 提到与任何其他 PHP 可用的选项相比，Neuron 是唯一的垂直生态，但未指名具体替代品。