paint-brush
Este marco de código abierto incorpora agentes de inteligencia artificial con todas las funciones a su aplicación PHPpor@valerio
204 lecturas Nueva Historia

Este marco de código abierto incorpora agentes de inteligencia artificial con todas las funciones a su aplicación PHP

por Inspector.dev7m2025/03/07
Read on Terminal Reader

Demasiado Largo; Para Leer

Si sus clientes lo presionan para que implemente funciones de IA en su aplicación, pruebe Neuron: solo se necesitan unas pocas líneas de código para implementar su primer agente con todas las funciones.
featured image - Este marco de código abierto incorpora agentes de inteligencia artificial con todas las funciones a su aplicación PHP
Inspector.dev HackerNoon profile picture

En los últimos meses trabajé intensamente para llevar la integración de agentes de IA a un nivel superior en mi producto SaaS. Fue un viaje muy largo, que comenzó hace más de un año con los primeros experimentos. Debo decir que comprender todas las partes móviles de un sistema impulsado por IA no fue nada fácil.


Como desarrollador PHP tuve que luchar mucho, principalmente porque el ecosistema PHP para desarrollar este tipo de características “Agentic” en aplicaciones existentes no es tan avanzado ni rico como lo es en otras tecnologías.


Python y Javascript están “manejando el autobús” y, obviamente, otros desarrolladores que trabajan con diferentes lenguajes de programación están creando sus artefactos para tener la oportunidad de comenzar su viaje también.


Hace seis meses, cuando empecé a trabajar en este capítulo, tomé en consideración algunos paquetes que estaban llamando la atención como LLPhant o Prism . Había mucho desarrollo detrás de estos paquetes y ya han implementado muchas cosas. Pero para mis necesidades tienen debilidades demasiado serias como para considerar construir la base de este capítulo para mi negocio sobre estas librerías. Prism es exclusivamente para Laravel, por lo que estás encerrado, y LLPhant tiene muchas clases diferentes y parece más una librería que un framework. También carece de características como Memory, historial de chat, observabilidad.

El camino insostenible

Desde el principio me di cuenta de que no podía mirar otros lenguajes de programación. No es sostenible. Y estoy seguro de que a la mayoría de los desarrolladores que se especializan en una tecnología en particular les pasa lo mismo.


Si tienes una aplicación PHP, no puedes implementar un agente en JavaScript o Python, porque necesitan los datos y el contexto de tu aplicación para generar su magia. Transferir estos datos y contexto a una entidad externa escrita en otro lenguaje genera una gran duplicación de código o una limitación técnica que tampoco es sostenible.


Tengo curiosidad por ver si fue solo yo el que tuvo problemas o si estos sentimientos son los mismos que los de otros desarrolladores de PHP.


Empecé a pensar que la herramienta que había creado para mí era realmente muy buena, al menos desde mi perspectiva.


Así que decidí lanzar esta herramienta interna como un proyecto de código abierto: Neuron AI , un marco de código abierto para integrar agentes de inteligencia artificial con todas las funciones en su aplicación PHP existente.


https://neuron.inspector.dev

¿Por qué decidí hacerlo de código abierto?

El camino que me gustaría explorar está inspirado en LangChain, que ofrece a las personas la posibilidad de crear entidades Agentic en aplicaciones PHP, con un conjunto completo de herramientas de código abierto, y brindar soporte y visibilidad a largo plazo gracias al servicio de monitoreo y depuración profesional impulsado por Inspector.dev.


Al mismo tiempo, creo que realmente puede ayudar a los desarrolladores de PHP a “subirse al autobús de la IA” con bases más sólidas.

Me pareció una oportunidad clara. Espero que te sirva para obtener las respuestas que buscas para seguir creando un gran software con tu lenguaje de programación preferido.


Así es como está organizado el sistema:

Conceptos clave

Neuron AI está diseñado para brindarle un conjunto de herramientas completo para implementar aplicaciones impulsadas por IA, lo que facilita la integración en su sistema existente.


La mayoría de los componentes del marco de trabajo Neuron AI no implementan constructores activos, solo le brindan funciones para implementar su propio comportamiento de agente. Las dos clases más importantes, Agent y RAG , están diseñadas para extenderse y crear su implementación específica. Rara vez se usan como objetos independientes.


Esto garantiza la portabilidad de la implementación de su agente porque todas las partes móviles están encapsuladas en una sola entidad que puede ejecutar donde quiera en su aplicación.


 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); }) ]; } }


Hablar con el agente


 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:...

Dependencias del paquete

Decidimos intencionalmente crear Neuron lo más libre posible de dependencias externas. El paquete se entrega con una sola dependencia: “guzzlehttp/guzzle”: “^7.0”


Al no incorporar docenas de dependencias dentro de su aplicación, no corre el riesgo de quedar excluido de Neuron si necesita actualizar su arquitectura actual, como el marco de aplicación web (Laravel, Symfony, CodeIgniter, etc.) a una versión más nueva o integrar nuevas dependencias.


Según nuestra experiencia, una mala cadena de dependencias puede ser una sorpresa muy desagradable cuando ya es demasiado tarde. Ya ha dedicado mucho esfuerzo a implementar sus interacciones de IA y, de repente, se ha convertido en un cuello de botella porque las dependencias hacen imposible actualizar y hacer evolucionar el resto de su sistema.


Queremos que sepas que con Neuron AI no es así.

Extensibilidad

Cada componente del framework depende de su propia interfaz. Esto le garantiza la capacidad de crear nuevas implementaciones concretas de cada componente para interactuar con sistemas externos y pasárselas a sus agentes con confianza.


En la documentación de los componentes encontrarás la sección dedicada a cómo implementar uno nuevo, básicamente ampliando su interfaz.

¿Quieres implementar una nueva tienda de vectores o un proveedor de integraciones ? Sigue la documentación y no dudes en enviarnos una solicitud de incorporación de cambios con tu nuevo módulo. Estaremos encantados de integrarlos como parte del marco de trabajo para garantizar el soporte y el mantenimiento de primera mano.

Observabilidad de los agentes de IA

Neuron está diseñado con un sistema integrado para que las implementaciones de RAG y de su agente sean observables. Puede comenzar a monitorear las actividades y el rendimiento de sus agentes con solo una línea de código. Eche un vistazo a la sección dedicada en la sección de observabilidad .

Kit de herramientas de inteligencia artificial de Neuron

Para crear un agente de IA completamente funcional, hay que hacer que varias cosas funcionen juntas. Además del LLM, hay que procesar datos constantemente, crear y almacenar integraciones para alimentar al agente con información actualizada.


El proyecto tiene como objetivo proporcionar soluciones fáciles de implementar y extender en todas estas áreas.

¿Qué sigue después del lanzamiento?

En Inspector, nos entusiasma el crecimiento orgánico. Por eso, nos gustaría comenzar a ayudar a los desarrolladores a crear sus primeros agentes para descubrir casos extremos, nuevas necesidades y, obviamente, corregir errores.


Ya estamos trabajando con nuestra base de usuarios internos de más de 10 000 desarrolladores PHP que están iniciando sus Agentes ahora mismo y todavía están surgiendo muchas cosas interesantes.


Los casos de uso reales serán el motor de la evolución del marco, así que no dude en ponerse en contacto con nosotros si desea adquirir conocimientos a partir de nuestra experiencia. Estamos aquí para ayudar.

Conclusión

Si sus clientes lo presionan para que implemente funciones de IA en su aplicación, pruebe Neuron: solo se necesitan unas pocas líneas de código para implementar su primer agente con todas las funciones.


Gracias por leer este artículo, te invito a que me contactes para cualquier duda, curiosidad o simplemente para darme tu opinión. Y si crees que esta herramienta puede ser útil para otros desarrolladores PHP, por favor compártela en tu blog, redes sociales y canales de YouTube.

Obtenga más información sobre el inspector en el sitio web: https://inspector.dev


Mejor,

Valerio