Hyperf 构建 RAG 应用

张

张建站

2026/4/22 2:57:02

10分钟阅读

一、inspector-apm/neuron-ai推荐首选功能最完整开箱即用2025 年活跃维护。composerrequire inspector-apm/neuron-ai 文档入库 use NeuronAI\RAG\DataLoader\PdfLoader;use NeuronAI\RAG\DataLoader\WebPageLoader;use NeuronAI\RAG\DataLoader\MarkdownLoader;use NeuronAI\Providers\OpenAI\Embeddings;use NeuronAI\RAG\VectorStores\PGVector\PGVectorStore;$vectorStorenew PGVectorStore(connection:$pdo, table:documents,);$embeddingsnew Embeddings(key: getenv(OPENAI_API_KEY), model:text-embedding-3-small,);// 支持 PDF / Markdown / HTML / Webpage / YouTube 等$loadernew PdfLoader(/path/to/manual.pdf);$documents$loader-getDocuments();foreach($documentsas$doc){$doc-embedding$embeddings-embedText($doc-content);$vectorStore-addDocument($doc);}问答 use NeuronAI\RAG\RAG;use NeuronAI\Providers\Anthropic\Anthropic;use NeuronAI\Chat\Messages\UserMessage;$ragRAG::make(provider: new Anthropic(key: getenv(ANTHROPIC_API_KEY), model:claude-sonnet-4-6,), embeddings:$embeddings, vectorStore:$vectorStore,);$answer$rag-chat(new UserMessage(产品退换货政策是什么));echo$answer-getContent();在 Hyperf 中注册为单例 // config/autoload/dependencies.php use NeuronAI\RAG\RAG;return[RAG::classfunction(){returnRAG::make(provider: new\NeuronAI\Providers\Anthropic\Anthropic(key: env(ANTHROPIC_API_KEY), model:claude-sonnet-4-6,), embeddings: new\NeuronAI\Providers\OpenAI\Embeddings(key: env(OPENAI_API_KEY), model:text-embedding-3-small,), vectorStore: new\NeuronAI\RAG\VectorStores\PGVector\PGVectorStore(connection: app(\PDO::class), table:rag_documents,),);},];// app/Controller/RagController.php use NeuronAI\RAG\RAG;use NeuronAI\Chat\Messages\UserMessage;class RagController{publicfunction__construct(private RAG$rag){}#[PostMapping(/ask)]publicfunctionask(RequestInterface$request): array{$answer$this-rag-chat(new UserMessage($request-input(question)));return[answer$answer-getContent()];}}支持的 Vector StorePinecone / ChromaDB / MongoDB / PGVector / TypeDB 支持的 EmbeddingsOpenAI / Voyage AI / Gemini 文档 LoaderPDF / CSV / JSON / Markdown / HTML / Webpage / YouTube --- 二、LLPhant/LLPhantPHP LangChain 功能对标 Python LangChain支持 Chain、Agent、RAG。composerrequire llphant/llphant use LLPhant\Embeddings\DataReader\FileDataReader;use LLPhant\Embeddings\DocumentSplitter\DocumentSplitter;use LLPhant\Embeddings\EmbeddingGenerator\OpenAI\OpenAI3SmallEmbeddingGenerator;use LLPhant\Embeddings\VectorStores\Doctrine\DoctrineVectorStore;use LLPhant\Query\SemanticSearch\QuestionAnswering;use LLPhant\OpenAIConfig;// 入库$readernew FileDataReader(/docs/);// 批量读取目录$documents$reader-getDocuments();$splitternew DocumentSplitter(500,50);//chunkSize500,overlap50$chunks$splitter-splitDocuments($documents);$embeddernew OpenAI3SmallEmbeddingGenerator();$storenew DoctrineVectorStore($entityManager, YourDocumentEntity::class);$store-addDocuments($embedder-embedDocuments($chunks));// 问答$confignew OpenAIConfig();$config-modelgpt-4o;$qanew QuestionAnswering($store,$embedder, new OpenAIChat($config));echo$qa-answerQuestion(如何申请退款);特点支持 Doctrine ORM、MongoDBAgent Tool Calling和 Hyperf 的 DB 层集成需要适配。 --- 三、symfony/aiSymfony 官方出品 Symfony7.4新增PHP 生态最正规的实现与 Hyperf 无框架绑定可单独使用。composerrequire symfony/ai use Symfony\AI\Store\Document\Metadata;use Symfony\AI\Store\Document\VectorDocument;use Symfony\AI\Platform\Bridge\OpenAI\Embeddings;use Symfony\AI\Store\Bridge\Qdrant\Store as QdrantStore;// 向量写入$storenew QdrantStore($qdrantClient,my_collection);$embeddernew Embeddings($openAiClient);$vector$embedder-create(文档内容...);$store-add(new VectorDocument(id: Uuid::v4(), vector:$vector, metadata: new Metadata([sourcepolicy.pdf]),));// 检索$queryVector$embedder-create(退款流程);$results$store-query($queryVector, options:[limit5]);支持的 StoreQdrant / MongoDB / pgvector / Azure AI Search / Chroma 适合场景需要细粒度控制或已有 Symfony 组件依赖。 --- 四、对比总结 ┌──────────────┬─────────────────┬───────────────────────────┬────────────┐ │ │ neuron-ai │ LLPhant │ symfony/ai │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ 安装复杂度 │ 低 │ 中 │ 中 │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ RAG 开箱即用 │ ✅ 一行 │ ✅ 较多配置 │ 需手动组装 │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ Hyperf 集成 │ 直接注入 │ 需适配 │ 需适配 │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ 向量库支持 │5种 │4种 │6种 │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ Agent 支持 │ ✅ │ ✅ │ 部分 │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ MCP 支持 │ ✅ │ ❌ │ ❌ │ ├──────────────┼─────────────────┼───────────────────────────┼────────────┤ │ 推荐场景 │ Hyperf 快速集成 │ 复杂 LangChain 风格流水线 │ 精细控制 │ └──────────────┴─────────────────┴───────────────────────────┴────────────┘ Hyperf 项目首选 inspector-apm/neuron-ai直接注入 DI 容器五分钟跑通 RAG 问答。