neuron-core/neuron-ai

Neuron AI – 用于构建 代理型 应用的 PHP 框架

它是什么

• 一个可通过 Composer 安装的 PHP 库，让您直接在 PHP 代码库中创建、编排和运行 AI 代理。
• 为 LLM 提供商、记忆、工具包、RAG、结构化输出、多代理工作流和人在环路处理提供一流的抽象。
• 面向希望 代理 成为其应用核心架构而非事后功能的开发者。

关键概念与组件

组件	作用
Agent（继承 NeuronAI\Agent\Agent）	具有内置记忆、流式传输和工具调用的对话式 AI 基类。
RAG（继承 NeuronAI\RAG\RAG）	结合提供商、嵌入服务和向量存储（例如 Pinecone）用于检索增强生成。
工具 / 工具包	通过函数调用向 LLM 暴露具体操作（例如 MySQL 查询）的 PHP 对象。
MCP 连接器	连接到外部 模型上下文协议 服务器，以便远程提供工具。
Workflow	一个低层、基于组件的流水线，让您将提供商、加载器、向量存储等连接成自定义代理流程，并支持检查点和人在环路步骤。
结构化输出	使用 #[SchemaProperty] 属性装饰 PHP 类；代理返回类型化对象而非原始文本。

支持的 LLM 提供商（通过单个 provider() 方法即插即用）：Anthropic、OpenAI（包括 Azure 和兼容 API）、Ollama、Gemini、Mistral、HuggingFace、Deepseek、Grok、AWS Bedrock、Cohere、ZAI、阿里巴巴 DashScope，以及通用的 Neuron Router。

典型工作流

1. 安装 – composer require neuron-core/neuron-ai。
2. 添加技能 – npx skills add ./vendor/neuron-core/neuron-ai/skills -y（符号链接保持其最新）。
3. 选择框架集成 – 运行相应的技能（neuron-laravel-integration 或 neuron-symfony-integration）或使用纯 PHP 技能。
4. 创建代理 – vendor/bin/neuron make:agent MyAgent 并实现 provider()、instructions() 以及可选的 tools()。
5. 交互 – 实例化代理，设置线程 ID，并调用 $agent->chat(new UserMessage('…'))。
6. 扩展 – 添加工具包、RAG、结构化输出或组合完整的 Workflow 以处理复杂的多步骤流程。

示例 – 数据分析师代理

class DataAnalystAgent extends Agent {
    protected function provider(): AIProviderInterface {
        return new Anthropic(key: 'ANTHROPIC_API_KEY', model: 'ANTHROPIC_MODEL');
    }
    protected function instructions(): SystemMessage {
        return new SystemMessage('You are a data analyst expert in creating reports from SQL databases.');
    }
    protected function tools(): array {
        return [MySQLToolkit::make(\DB::connection()->getPdo())
                ->only([MySQLSchemaTool::class, MySQLSelectTool::class])];
    }
}

$resp = DataAnalystAgent::make()->setThreadId('demo')
        ->chat(new UserMessage('How many orders did we receive today?'))
        ->getMessage();
echo $resp->getContent();

该代理会记住对话，可以安全地运行只读 SQL，并且只需一行更改即可切换到另一个 LLM 提供商。

生态系统与社区

• 一个专门为代理型 PHP 应用构建的 扩展注册表（技能、集成、工具包）。
• 官方渠道：文档站点、新闻通讯、Inspector 监控服务、电子书和社交媒体。
• 设计为 垂直 堆栈：驱动单代理演示的同一 Workflow 也可扩展到多代理生产系统。

开发与测试

• 需要 PHP ≥ 8.1。
• 测试套件在 Docker Compose 中运行（docker compose up -d 然后 vendor/bin/phpunit）。
• 安全问题报告至 support@inspector.dev。

谁应该考虑 Neuron AI？

• 希望 AI 代理成为其架构一等公民的 PHP 团队（Laravel、Symfony 或纯 PHP）。
• 构建内部工具、数据分析机器人或任何需要 AI 具有记忆、工具访问或检索增强生成的产品公司。
• 寻找统一方式切换 LLM 提供商、添加自定义工具并编排复杂工作流而无需拼接不同库的开发者。

---

所有细节均直接取自仓库的 README；未推断任何额外功能。