> 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/resumen/readme.md).

# Introducción

Tu próxima aplicación será agéntica. Construye con la tecnología que amas.

### Qué es Neuron

Neuron es un framework PHP para desarrollar aplicaciones agénticas. Al encargarse del trabajo pesado de la orquestación de proveedores, la gestión de memoria, la integración de la interfaz de usuario 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 completamente orquestado, tienes la libertad de construir entidades de IA que piensen y actúen exactamente como las imaginas.

Proporcionamos herramientas para todo el ciclo de vida del desarrollo de aplicaciones agénticas, desde interfaces LLM hasta la carga de datos, la orquestación multiagente y la supervisión y depuración. Además, ofrecemos [tutoriales y otro contenido educativo](https://docs.neuron-ai.dev/neuron-v3-es/resumen/fast-learning-by-video.md) para ayudarte a empezar a usar Agentes de IA en tus proyectos.

<figure><img src="https://content.gitbook.com/content/GHx4l2LknIex7vFIUg1R/blobs/WIjdF4h01xkBuRjveyhK/neuron-ai-architecture.png" alt=""><figcaption><p>Arquitectura de Neuron</p></figcaption></figure>

### Empieza con un solo prompt

Copia y pega este prompt inicial para decirle a tu agente de codificación cómo instalar y configurar Neuron AI en tu proyecto.

```
Vas a configurar Neuron AI, un framework PHP para construir aplicaciones con agentes, 
en este proyecto, y debes seguir tres pasos en orden. 

- Primero, instala el framework: revisa composer.json, y si neuron-core/neuron-ai aún no está requerido, 
ejecuta `composer require neuron-core/neuron-ai`. 
- Segundo, instala las habilidades del agente que se incluyen 
con el paquete ejecutando `npx skills add ./vendor/neuron-core/neuron-ai/skills -y` desde 
la raíz del proyecto. Las habilidades están enlazadas simbólicamente, así que se mantienen actualizadas cada vez que Neuron 
se actualiza mediante Composer. A partir de entonces, carga la habilidad relevante antes de escribir cualquier código 
de Neuron en lugar de confiar en lo que recuerdas sobre el framework, porque tu memoria puede 
describe una versión anterior. 
- Tercero, determina qué tipo de aplicación es esta. Mira composer.json 
y la estructura del proyecto para saber si es una aplicación Laravel o una aplicación Symfony, y luego 
activa la habilidad correspondiente: neuron-laravel-integration o neuron-symfony-integration. 
Si Neuron ya forma parte de la aplicación, revisa la lista de verificación de fundamentos de la habilidad 
elemento por elemento. Informa qué difiere de la configuración recomendada. 

Si Neuron aún no está en la aplicación, sigue la misma lista de verificación para hacer la configuración inicial. 
Si la aplicación no usa ninguno de los dos frameworks, empieza desde un agente PHP puro usando la habilidad neuron-agent. 
Termina con un breve resumen de lo que instalaste y lo que encontraste.
```

### Soporte para múltiples proveedores

Neuron utiliza una interfaz común para los proveedores de LLM (`AIProviderInterface`) así como para los demás componentes, como [memoria](https://docs.neuron-ai.dev/neuron-v3-es/agente/chat-history-and-memory.md), [embeddings](https://docs.neuron-ai.dev/neuron-v3-es/rag/embeddings-provider.md), [almacenes vectoriales](https://docs.neuron-ai.dev/neuron-v3-es/rag/vector-store.md), [kits de herramientas](https://docs.neuron-ai.dev/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 de LLM, ajustes los backends de memoria o escales en múltiples servidores.

Aquí hay 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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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()
    ->setThreadId('chat_id')
    ->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](https://docs.neuron-ai.dev/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](https://docs.neuron-ai.dev/neuron-v3-es/resumen/fast-learning-by-video.md#video)

### Por qué Neuron

Tu próxima aplicación será agéntica. Una parte cada vez mayor del software nuevo ya no es una aplicación web con funciones de IA añadidas sobre la marcha, sino una aplicación nacida agéntica, donde el agente es la propia arquitectura, impulsando cómo el sistema razona, actúa y se comunica con la interfaz de usuario. Construir este tipo de aplicación requiere un conjunto específico de fundamentos: flujos de trabajo impulsados por eventos con puntos de control, human-in-the-loop, interrupción, orquestación multiagente, streaming y protocolos de interfaz de usuario agéntica como AG-UI y el protocolo Vercel AI SDK, MCP y ejecución asíncrona.

En el ecosistema PHP, este conjunto de fundamentos existe en un solo lugar. Cada uno es un capítulo de esta documentación: [Flujo de trabajo](https://docs.neuron-ai.dev/workflow/getting-started.md), [Humano en el bucle](https://docs.neuron-ai.dev/neuron-v3-es/agente/tool-approval.md), [Streaming y protocolos de UI](https://docs.neuron-ai.dev/neuron-v3-es/agente/streaming.md#stream-adapters), [MCP](https://docs.neuron-ai.dev/neuron-v3-es/agente/mcp-connector.md), [Asincronía](https://docs.neuron-ai.dev/neuron-v3-es/agente/async.md), [Middleware](https://docs.neuron-ai.dev/neuron-v3-es/flujo-de-trabajo/middleware.md), [Evaluaciones](https://docs.neuron-ai.dev/neuron-v3-es/agente/evaluation.md).

Tampoco hay un segundo framework esperándote cuando el proyecto crece. El mismo Workflow que ejecuta tu primer agente en la guía de primeros pasos ejecuta en producción un sistema multiagente con estado, bucles y aprobaciones humanas. Lo que aprendes el primer día es lo que entregas en proyectos futuros.

### 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 ensamblar la suya propia a partir de piezas dispersas.

Para una empresa de software, este es un lugar para ser reconocida como especialista y no como un equipo más que afirma tener experiencia en IA. Para una empresa que necesita una base agéntica en la que pueda confiar durante años, significa estandarizar sobre 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 - "Comienza 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 se ha ido ampliando en los últimos años. Mientras los desarrolladores de Python disfrutan de una gran cantidad de bibliotecas y marcos de trabajo 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 rehacer 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 GooglePlay</a>

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

Regístrate en el boletín 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, comprender 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 PHP que trabajan en Neuron para crear sus aplicaciones agénticas. Esperamos que:

* Hagas preguntas sobre las que tienes dudas.
* Compartas ideas.
* Interactúes con otros miembros de la comunidad.
* Dés la bienvenida a otros y seas de mente abierta.

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

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

Rastrea y evalúa el flujo de ejecución de tus agentes para ayudarte a mantener implementaciones listas para producción con confianza. Consulta las [**integraciones de monitoreo**](https://docs.neuron-ai.dev/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-code/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/>
