> 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/getting-started.md).

# Instalación

Instrucciones paso a paso sobre cómo instalar Neuron en tu aplicación y crear un Agente.

### Requisitos

* PHP: ^8.1

### 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 vienen 
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 
describir 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 no está 
todavía en la aplicación, sigue la misma lista de verificación para hacer la configuración inicial. Si la aplicación usa 
ninguno de los dos frameworks, empieza con un agente PHP básico usando la habilidad neuron-agent. 
Termina con un breve resumen de lo que instalaste y lo que encontraste.
```

### Instalar

Ejecuta el comando siguiente para instalar la última versión:

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

### Crear un agente

Puedes crear fácilmente tu primer agente con la CLI de Neuron:

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

```bash
./vendor/bin/neuron make:agent App\\Neuron\\MyAgent
```

{% endtab %}

{% tab title="Windows" %}

```powershell
.\vendor\bin\neuron make:agent App\Neuron\MyAgent
```

{% endtab %}
{% endtabs %}

```php
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Agent\SystemPrompt;
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',
        );
    }

    public function instructions(): string
    {
        return (string) new SystemPrompt(
            background: ["Eres un agente de IA amigable creado con el framework Neuron."],
        );
    }
}
```

### Habla con el agente

Envía un prompt al agente para obtener una respuesta del LLM subyacente:

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

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

echo $message->getContent();
// Soy un agente de IA amigable construido con Neuron, ¿cómo puedo ayudarte hoy?
```

### Monitoreo y depuración

Muchas de las aplicaciones que construyas con Neuron contendrán múltiples pasos con múltiples invocaciones de llamadas a LLM. A medida que estas aplicaciones se vuelven cada vez más complejas, resulta crucial poder inspeccionar exactamente qué está ocurriendo dentro de tu sistema agéntico. La mejor manera de hacerlo es con [Inspector](https://inspector.dev/).

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}

### Tutorial en video

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