Tento Open Source Framework přináší plnohodnotné agenty AI do vaší aplikace PHP

V posledních několika měsících jsem intenzivně pracoval na tom, abych posunul integraci agentů AI do mého produktu SaaS na vyšší úroveň. Byla to velmi dlouhá cesta, která začala před více než rokem prvními experimenty. Musel jsem říci, že pochopení všech pohyblivých částí systému řízeného umělou inteligencí nebylo zdaleka snadné.

Jako vývojář PHP jsem se hodně trápil, hlavně proto, že ekosystém PHP vyvíjet tento druh „agentních“ funkcí do stávajících aplikací není tak vyspělý a bohatý jako u jiných technologií.

Python a Javascript „řídí autobus“ a samozřejmě další vývojáři pracující s různými programovacími jazyky vytvářejí své artefakty, aby také dostali příležitost začít svou cestu.

Před šesti měsíci, když jsem začal pracovat na této kapitole, jsem vzal v úvahu některé balíčky, které získaly pozornost, jako je LLPHant nebo Prism . Za těmito balíčky byl velký vývoj a spoustu věcí již implementovaly. Ale pro mé potřeby mají příliš vážné slabiny na to, aby zvážili vybudování základů této kapitoly pro mé podnikání na těchto knihovnách. Prism je výhradně pro Laravel, takže jste zamčeni a LLPHant má spoustu různých tříd a vypadá spíše jako knihovna než rámec. Chybí mu také funkce jako paměť, historie chatu, pozorovatelnost.

Neudržitelná cesta

Od začátku jsem si uvědomoval, že se nemohu dívat na jiné programovací jazyky. Není to udržitelné. A jsem si jistý, že je to stejné pro většinu vývojářů, kteří se specializují na konkrétní technologii.

Pokud máte aplikaci PHP, nemůžete implementovat agenta v javascriptu nebo Pythonu, protože potřebují vaše aplikační data a kontext ke generování svého kouzla. Přenos těchto dat a kontextu do externí entity napsané v jiném jazyce vede k velké duplicitě kódu nebo k technickým omezením, které také nejsou udržitelné.

Zajímalo by mě, jestli jsem to byl jen já, nebo jestli jsou tyto pocity stejné jako u jiných PHP vývojářů.

Začal jsem si myslet, že nástroj, který jsem si pro sebe vytvořil, byl opravdu dobrý, alespoň z mého pohledu.

Rozhodl jsem se tedy vydat tento interní nástroj jako open source projekt: Neuron AI , open source Framework pro integraci plně vybavených agentů AI do vaší stávající PHP aplikace.

https://neuron.inspector.dev

Proč jsem se rozhodl udělat to open source

Cesta, kterou bych rád prozkoumal, je inspirována LangChainem, který dává lidem sílu vytvářet Agentické entity do aplikací PHP s kompletní sadou nástrojů s otevřeným zdrojovým kódem. A poskytovat podporu a dlouhodobou viditelnost díky profesionální službě monitorování a ladění založené na Inspector.dev

Zároveň věřím, že to může skutečně pomoci vývojářům PHP „naskočit do sběrnice AI“ se silnějšími základy.

Zdálo se mi to jako jasná příležitost. Doufám, že vám může poskytnout odpovědi, které hledáte, abyste mohli pokračovat ve vytváření skvělého softwaru s vaším preferovaným programovacím jazykem.

Zde je návod, jak je systém organizován:

Klíčové pojmy

Neuron AI je navržen tak, aby vám poskytl kompletní sadu nástrojů pro implementaci aplikací řízených umělou inteligencí, což usnadňuje integraci do vašeho stávajícího systému.

Většina komponent frameworku Neuron AI neimplementuje aktivní konstruktory, pouze vám poskytují funkce pro implementaci vašeho vlastního agentního chování. Dvě nejdůležitější třídy, Agent a RAG , jsou navrženy tak, aby byly rozšířeny a vytvořily vaši konkrétní implementaci. Zřídka se používají jako samostatné objekty.

To zajišťuje přenositelnost implementace vašeho agenta, protože všechny pohyblivé části jsou zapouzdřeny do jediné entity, kterou můžete spouštět kdekoli ve své aplikaci.

 namespace App\Agents; use NeuronAI\Agent; use NeuronAI\Providers\Anthropic; use NeuronAI\Tools\Tool; class SEOAgent extends Agent { public function provider(): AIProviderInterface { // return an AI provider instance (Anthropic, OpenAI, Mistral, etc.) return new Anthropic( key: 'ANTHROPIC_API_KEY', model: 'ANTHROPIC_MODEL', ); } public function instructions() { return "Act as an expert of SEO (Search Engine Optimization). ". "Your role is to analyze a text and provide suggestions on how the content can be improved to better rank on Google search."; } public function tools(): array { return [ Tool::make( "get_file_content", "Use the url to get the content in plain text." )->addProperty( new ToolPropertry( name: 'url', type: 'string', description: 'The URL of the article you want to analyze.', required: true ) )->setCallable(function (string $url) { return file_get_contents($url); }) ]; } }

Promluvte si s agentem

 use NeuronAI\Chat\Messages\UserMessage; $response = SEOAgent::make($user) ->chat( new UserMessage("Give me your feedback about this article: https://inspector.dev/introduction-to-neuron-ai-create-full-featured-ai-agents-in-php/") ); echo $response->getContent(); // It seems like a good job has been done on the article, // however I can give you some tips to improve SEO:...

Závislosti balíčku

Záměrně jsme se rozhodli postavit Neuron tak, aby byl co nejvíce osvobozen od externích závislostí. Balíček se dodává pouze s jednou závislostí: „guzzlehttp/guzzle“: „^7.0“

Aniž byste do své aplikace vnesli desítky závislostí, neriskujete, že budete uzamčeni z Neuronu, pokud potřebujete upgradovat vaši současnou architekturu, jako je framework webových aplikací (Laravel, Symfony, CodeIgniter atd.), na novější verzi nebo integrovat nové závislosti.

Na základě našich zkušeností může být špatný řetězec závislostí velmi nepříjemným překvapením, když je příliš pozdě. Už jste vynaložili mnoho úsilí na implementaci svých interakcí s umělou inteligencí a najednou se to stalo úzkým hrdlem, protože závislosti znemožňují upgradovat a vyvíjet zbytek vašeho systému.

Chceme, abyste věděli, že s Neuron AI tomu tak není.

Rozšiřitelnost

Každá součást frameworku závisí na svém vlastním rozhraní. To vám zaručuje možnost vytvářet nové konkrétní implementace každé součásti pro interakci s externími systémy a s jistotou je předávat vašim agentům.

V dokumentaci komponent najdete vyhrazenou část, jak implementovat novou, v podstatě rozšiřující její rozhraní.

Chcete zavést nový obchod Vector Store nebo poskytovatele vkládání ? Postupujte podle dokumentace a neváhejte nám poslat PR s vaším novým modulem. Rádi je začleníme jako součást frameworku, abychom zajistili podporu a údržbu první strany.

Pozorovatelnost agentů AI

Neuron je navržen s vestavěným systémem, aby byly vaše implementace agenta a RAG pozorovatelné. Můžete začít sledovat aktivity a výkon svých agentů pomocí jediného řádku kódu. Podívejte se do vyhrazené sekce v sekci pozorovatelnosti .

Neuron AI Toolkit

Chcete-li vytvořit plně funkčního agenta AI, musíte zajistit, aby několik věcí fungovalo společně. Kromě LLM musíte neustále zpracovávat data, vytvářet a ukládat vložení, abyste svému agentovi poskytli čerstvé informace.

Cílem projektu je poskytnout snadno implementovatelná a rozšířitelná řešení do všech těchto oblastí.

Co bude dál po spuštění

Ve společnosti Inspector podporujeme organický růst. Rádi bychom tedy začali pomáhat vývojářům vytvářet jejich první agenty, aby objevili okrajové případy, nové potřeby a samozřejmě opravu chyb.

Již nyní pracujeme s naší interní uživatelskou základnou +10 000 PHP vývojářů, kteří právě nyní spouštějí své agenty, a stále se objevuje spousta zajímavých věcí.

Skutečné případy použití budou hnacím motorem evoluce frameworku, takže nás neváhejte kontaktovat, pokud chcete získat nějaké znalosti z našich zkušeností. Jsme tu, abychom vám pomohli.

Závěr

Pokud vás vaši zákazníci tlačí k implementaci funkcí AI do vaší aplikace, vyzkoušejte Neuron, implementace vašeho prvního plnohodnotného agenta zabere jen pár řádků kódu.

Děkuji, že jste si přečetli tento článek, zvu vás, abyste mě kontaktovali v případě jakýchkoli dotazů, zajímavostí nebo mi jen poskytli zpětnou vazbu. A pokud si myslíte, že by tento nástroj mohl být užitečný pro ostatní vývojáře PHP, sdílejte jej prosím na svém blogu, sociálních sítích a kanálech YouTube.

Více o inspektoru se dozvíte na webu: https://inspector.dev

Nejlepší,

Valerio