> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-es/descripcion-general/readme.md).

# Introducción

### Qué es Neuron

Neuron es un framework de PHP para desarrollar aplicaciones agénticas. Al encargarse del trabajo pesado de la orquestación, la carga de datos y la depuración, Neuron te despeja el camino para que te concentres en el alma creativa de tu proyecto. Desde la primera línea de código hasta un sistema multiagente totalmente orquestado, tienes la libertad de construir entidades de IA que piensen y actúen exactamente como las imaginas.

Ofrecemos herramientas para todo el ciclo de vida del desarrollo de aplicaciones agénticas, desde interfaces LLM hasta carga de datos, orquestación multiagente, monitoreo y depuración. Además, ofrecemos [tutoriales y otro contenido educativo](/neuron-v3-es/descripcion-general/fast-learning-by-video.md) para ayudarte a empezar a usar agentes de IA en tus proyectos.

<figure><img src="/files/ac863b535b78dc978b7d55d5a1cf639b70d6f04b" alt=""><figcaption><p>Arquitectura de Neuron</p></figcaption></figure>

### Empezando en 3 pasos

**1) Instala** Neuron en tu proyecto:

```shellscript
composer require neuron-core/neuron-ai
```

**2) Crea** un agente que extienda el `Agente` clase:

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        // devuelve un proveedor de IA (Anthropic, OpenAI, Ollama, Gemini, etc.)
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }
}
```

**3) Habla** con el agente:

```php
use NeuronAI\Chat\Messages\UserMessage;

$message = MyAgent::make()
    ->chat(new UserMessage("Hola, ¿quién eres?"))
    ->getMessage();

echo $message->getContent();
// Soy un agente de IA amigable construido con el framework Neuron AI, ¿en qué puedo ayudarte hoy?
```

### Demo con Laravel

Neuron ofrece un patrón de encapsulación bien definido, permitiéndote trabajar en tus componentes de IA dentro de un espacio de nombres dedicado. Puedes disfrutar exactamente de la misma experiencia que con otros paquetes del ecosistema que ya te encantan, como Filament, Nova, Horizon, etc.

<a href="https://www.youtube.com/watch?v=oSA1bP_j41w" class="button primary" data-icon="youtube">Ver la demo</a>

<a href="https://github.com/neuron-core/neuron-ai" class="button primary" data-icon="laravel">Paquete oficial de Laravel</a>

### Demo con Symfony

Todos los componentes de Neuron pertenecen a su propia interfaz, por lo que puedes definir fácilmente dependencias y automatizar la creación de objetos usando el contenedor de servicios de Symfony. Mira cómo funciona en un proyecto real.

<a href="https://www.youtube.com/watch?v=JWRlcaGnsXw" class="button primary" data-icon="youtube">Symfony y Neuron</a>

### Compatibilidad con múltiples proveedores

Neuron utiliza una interfaz común para modelos de lenguaje grandes (`AIProviderInterface`) así como para los demás componentes, como [embeddings](/neuron-v3-es/rag/embeddings-provider.md), [almacenes vectoriales](/neuron-v3-es/rag/vector-store.md), [kits de herramientas](/neuron-v3-es/agente/tools.md#toolkits-composable-agent-capabilities), etc. La arquitectura modular te permite intercambiar componentes según sea necesario, ya sea que cambies de proveedor LLM, ajustes los backends de memoria o escales a través de múltiples servidores.

Aquí tienes un par de ejemplos:

{% tabs %}
{% tab title="Anthropic" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("¡Hola!"))
    ->getMessage();

echo $message->getContent();
// Hola, ¿en qué puedo ayudarte hoy?
```

{% endtab %}

{% tab title="Ollama" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Ollama\Ollama;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Ollama(
            url: 'OLLAMA_URL',
            model: 'OLLAMA_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("¡Hola!"))
    ->getMessage();

echo $message->getContent();
// Hola, ¿en qué puedo ayudarte hoy?
```

{% endtab %}

{% tab title="OpenAI" %}

```php
namespace App\Neuron;

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

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new OpenAI(
            key: 'OPENAI_API_KEY',
            model: 'OPENAI_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("¡Hola!"))
    ->getMessage();

echo $message->getContent();
// Hola, ¿en qué puedo ayudarte hoy?
```

{% endtab %}

{% tab title="Gemini" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Gemini\Gemini;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Gemini(
            key: 'GEMINI_API_KEY',
            model: 'GEMINI_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("¡Hola!"))
    ->getMessage();

echo $message->getContent();
// Hola, ¿en qué puedo ayudarte hoy?
```

{% endtab %}

{% tab title="Mistral" %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Chat\Messages\UserMessage;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\\Providers\\Gemini\\Mistral;

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Mistral(
            key: 'MISTRAL_API_KEY',
            model: 'MISTRAL_MODEL',
        );
    }
}

$message = MyAgent::make()
    ->chat(new UserMessage("¡Hola!"))
    ->getMessage();

echo $message->getContent();
// Hola, ¿en qué puedo ayudarte hoy?
```

{% endtab %}
{% endtabs %}

Consulta todos los proveedores compatibles en la [Proveedor de IA](/neuron-v3-es/proveedores/ai-provider.md) sección.

### Tutoriales en video

{% embed url="<https://www.youtube.com/watch?v=oSA1bP_j41w>" %}

Más recursos aquí: [Tutoriales en video](/neuron-v3-es/descripcion-general/fast-learning-by-video.md#video)

### Por qué Neuron es único

La mayoría de los frameworks agénticos te obligan a elegir un bando. Algunos son lo suficientemente simples como para aprenderlos en una tarde, y te topas con un muro la primera vez que tu caso de uso crece más allá de una demo. Otros son lo suficientemente potentes para un caso de uso, pero pasas semanas peleándote con sus abstracciones antes de lanzar algo real.

Neuron se construye sobre una arquitectura de Workflow que elimina esos compromisos. La primera chispa surgió del concepto de Workflow en LLmaindex, en el mundo de Python. Diseñado alrededor de los patrones del PHP moderno, el Workflow de Neuron es una solución nativa de PHP que ahora sigue su propio camino, uno que seguimos trazando a medida que el ecosistema agéntico en PHP toma forma a su alrededor.

**El resultado es una base que un principiante puede tomar desde el primer día, y que ya lleva debajo todo lo que necesita un agente serio**: capa unificada de mensajería, herramientas y toolkits, MCP, human-in-the-loop, protocolos de interfaz agéntica, interacciones multiagente, ejecución asíncrona y más. Nunca cambias de framework cuando tu proyecto se vuelve ambicioso. La arquitectura que aprendiste al comienzo de este viaje es la misma que ejecutará tu sistema más complejo en producción en el futuro.

### Un ecosistema vertical e independiente

Neuron es también el único ecosistema vertical para el desarrollo de aplicaciones agénticas en PHP. Alrededor del framework hay un registro de extensiones, herramientas y tecnologías diseñadas específicamente para aplicaciones agénticas, y un número creciente de empresas que construyen sobre la misma arquitectura en lugar de armar la suya propia a partir de piezas dispersas.

Para una empresa de software, este es un lugar para ser reconocida como especialista, en lugar de ser solo otro equipo que afirma tener experiencia en IA. Para una compañía que necesita una base agéntica en la que pueda confiar durante años, significa estandarizarse en una arquitectura cuya dirección completa es este espacio, no una biblioteca de propósito general donde los agentes son una función secundaria.

## Recursos

### [Libro electrónico - "Empieza con agentes de IA en PHP"](https://www.amazon.it/dp/B0F1YX8KJB)

La brecha entre las tecnologías agénticas modernas y el desarrollo tradicional en PHP ha ido ampliándose en los últimos años. Mientras los desarrolladores de Python disfrutan de una gran cantidad de bibliotecas y frameworks para crear agentes de IA, a menudo los desarrolladores de PHP se han quedado preguntándose cómo pueden participar en esta revolución tecnológica sin tener que cambiar por completo sus habilidades o reconstruir sus aplicaciones desde cero.

Neuron cambia todo eso.

Este libro sirve tanto como una introducción a los conceptos de agentes de IA para desarrolladores como una guía completa del framework Neuron.

<a href="https://www.amazon.com/dp/B0F1YX8KJB" class="button secondary" data-icon="amazon">Consíguelo en Amazon</a>

<a href="https://play.google.com/store/books/details?pcampaignid=books_read_action&#x26;id=agJPEQAAQBAJ&#x26;pli=1" class="button secondary" data-icon="google">Consíguelo en Google Play</a>

### [Boletín](https://neuron-ai.dev)

Regístrate en el interno de Neuron [boletín](https://neuron-ai.dev/) para obtener documentos informativos, artículos y buenas prácticas sobre cómo empezar con el desarrollo de IA en PHP.

Aprenderás cómo abordar los sistemas de IA de la manera correcta, entender los conceptos técnicos más importantes detrás de los LLM y cómo empezar a implementar tus soluciones de IA en tu aplicación PHP con el framework Neuron AI.

### [Foro](https://github.com/inspector-apm/neuron-ai/discussions)

Estamos usando [Discusiones](https://github.com/inspector-apm/neuron-ai/discussions) como un lugar para conectar con desarrolladores de PHP que trabajan con Neuron para crear sus aplicaciones agénticas. Esperamos que tú:

* Haz las preguntas que te estés planteando.
* Comparte ideas.
* Interactúa con otros miembros de la comunidad.
* Da la bienvenida a otras personas y sé de mente abierta.

### [**Inspector.dev**](https://inspector.dev)

Neuron forma parte del ecosistema de Inspector como una plataforma confiable para crear soluciones impulsadas por IA fiables y escalables.

Rastrea y evalúa el flujo de ejecución de tus agentes para ayudarte a mantener implementaciones de nivel de producción con confianza. Consulta las [**integraciones de monitoreo**](/neuron-v3-es/agente/observability.md).

## Mantente en contacto

* Sitio web y boletín: [https://neuron-ai.dev](https://neuron-ai.dev/)
* Repositorio: [https://github.com/neuron-core/neuron-ai](https://github.com/inspector-apm/neuron-ai)
* Inspector: <https://inspector.dev>
* Libro electrónico: <https://www.amazon.it/dp/B0F1YX8KJB>
* LinkedIn: <https://www.linkedin.com/company/neuron-ai-php-framework>
* X: <https://x.com/neuronai_php>
* Instagram: <https://www.instagram.com/neuronai_php_adk/>
