php
10-01-2026

Neuron ai en php: cómo integrar ia en aplicaciones

Neuron AI es un framework open-source para PHP diseñado específicamente para crear y orquestar agentes de IA agentic (es decir, agentes autónomos que razonan, usan herramientas, toman decisiones y ejecutan tareas complejas) directamente en tu código PHP, sin necesidad de cambiar de lenguaje a Python o JavaScript. Es el framework más popular y maduro dentro del ecosistema PHP para este tipo de desarrollo, y muchos lo consideran el equivalente PHP a LangChain + LangGraph (el combo más usado en Python para agentes y workflows agentic).

¿Qué te permite hacer Neuron AI?

  • Implementar RAG (Retrieval Augmented Generation) fácilmente
  • Agentes que colaboran entre sí.
  • Soporte nativo para múltiples LLMs (OpenAI, Anthropic/Claude, Groq, Gemini, Ollama local, etc...).
  • Vector stores flexibles: filesystem (simple), pgvector (Postgres), Pinecone, Weaviate, etc...
  • Tools & Toolkits (MySQL, APIs externas, cálculos, emails, etc.).
  • Structured Output (forzar respuestas en JSON/schema).
  • Observabilidad integrada (con Inspector.dev) → monitorizas ejecuciones, costos, errores, loops infinitos.
  • MCP (Model Context Protocol) → conectar agentes a servicios externos (Stripe, Slack, etc...).
  • CLI para scaffolding rápido: php vendor/bin/neuron make:agent, make:rag, etc...

Ejemplos de uso

  • Agentes de soporte al cliente con base de conocimiento interna.
  • Analistas de datos que consultan SQL en lenguaje natural.
  • Chatbots RAG con documentación técnica o PDFs.
  • Automatización de procesos de negocio (facturas → extracción → aprobación).
  • Resumen de videos de YouTube.
  • Agentes de investigación profunda (deep research).
  • Integraciones en Laravel/Symfony para features "AI-powered".

Ventajas principales

  • Modularidad extrema → bajo vendor lock-in (cambias LLM, vector DB, etc. sin romper nada).
  • Tipado fuerte → PHPStan 100%, autocompletado excelente en IDE.
  • Observabilidad nativa → muy útil para producción (donde los agentes pueden fallar de formas raras).
  • Integración perfecta con ecosistemas PHP existentes (no te obliga a refactorizar).
  • Comunidad activa y creciendo (newsletter, Discord/Discussions, contribuciones reales).
Para instalar Neuron AI hay que ejecutar el comando de composer:

 Instalación: composer require neuron-core/neuron-ai

Ejemplo de como crear un multi agente de IA

  1. Crear agente investigador:

    use NeuronAI\Agent;
use NeuronAI\Providers\OpenAI\OpenAI;
use NeuronAI\Chat\Messages\UserMessage;

class ResearchAgent extends Agent
{
protected function provider()
{
return new OpenAI(
  key: 'TU_API_KEY',
  model: 'gpt-4.1'
);
}

protected function instructions(): string
{
return "Eres un agente investigador. Responde con datos claros y objetivos.";
}
}">
  2. Crear agente redactor:

    use NeuronAI\Agent;
namespace App\Agents;

use NeuronAI\Agent;
use NeuronAI\Providers\OpenAI\OpenAI;
use NeuronAI\Providers\AIProviderInterface
class WriterAgent extends Agent
{
protected function provider()
{
return new OpenAI(
  key: 'TU_API_KEY',
  model: 'gpt-4.1'
);
}

protected function instructions(): string
{
return "Eres un redactor profesional. Resume la información de forma clara y corta.";
}
}
  3. Crear agente multi-agente:

    use NeuronAI\Agent;
require 'vendor/autoload.php';

use NeuronAI\Chat\Messages\UserMessage;

// Crear agentes
$researcher = ResearchAgent::make();
$writer = WriterAgent::make();

// Paso 1: investigar
$investigacion = $researcher->chat(
new UserMessage("¿Qué es la inteligencia artificial?")
)->getContent();

// Paso 2: redactar
$resumen = $writer->chat(
new UserMessage("Resume lo siguiente:\n" . $investigacion)
)->getContent();

// Resultado final
echo "Investigación:\n";
echo $investigacion;

echo "Resumen final:\n";
echo $resumen;