> 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/flujo-de-trabajo/middleware.md).

# Middleware

Controla y personaliza la ejecución del agente en cada paso

### ¿Qué es un middleware?

Middleware proporciona una forma de interceptar la ejecución del flujo de trabajo y, por lo tanto, también del Agente y RAG, ya que ellos también son flujos de trabajo.

La ejecución central del Workflow implica llamar a nodos en función de los eventos devueltos por otros nodos. Middleware expone hooks para intervenir `antes de` y `después de` la ejecución de los nodos:

<figure><img src="https://4076695836-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGHx4l2LknIex7vFIUg1R%2Fuploads%2FPhEdX3C3TkEM9TtU7lN9%2Fmiddleware.png?alt=media&amp;token=d9a13cda-5e25-475f-b9b9-385bf69c3f52" alt=""><figcaption></figcaption></figure>

### ¿Qué puede hacer el middleware?

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Control</strong></td><td>Transformar prompts, la selección de herramientas y el formato de salida.</td></tr><tr><td><strong>Guardrails</strong></td><td>Añadir reintentos, límites de tasa, implementar medidas de protección, rechazo de prompts.</td></tr><tr><td><strong>Inyección</strong></td><td>Middleware puede proporcionar recursos a los nodos o a middleware posterior sobre la marcha.</td></tr></tbody></table>

### Creación de middleware

Puedes usar el comando siguiente para crear una clase de middleware:

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

```bash
vendor/bin/neuron make:middleware CustomMiddleware
```

{% endtab %}

{% tab title="Windows" %}

```powershell
.\vendor\bin\neuron make:middleware CustomMiddleware
```

{% endtab %}
{% endtabs %}

Se creará una nueva clase en tu proyecto con la estructura predeterminada de middleware:

```php
<?php

namespace App\Neuron\Middleware;

class CustomMiddleware implements WorkflowMiddleware
{
    /**
     * Ejecutar antes de que el nodo se ejecute.
     */
    public function before(
        NodeInterface $node, 
        Event $event, 
        WorkflowState $state, 
        WorkflowResources $resources,
    ): void {
        // ...
    }
    
    /**
     * Ejecutar después de que el nodo se ejecute.
     */
    public function after(
        NodeInterface $node, 
        Event $event, 
        WorkflowState $state, 
        WorkflowResources $resources,
    ): void {
        // ...
    }
}
```

### Registro de middleware

Si deseas asignar middleware a nodos específicos, puedes sobrescribir el `middleware` método al definir el flujo de trabajo:

```php
class MyWorkflow extends Workflow
{
    /**
     * Define el middleware de los nodos.
     */
    protected function middleware(): array
    {
        return [
            NodeOne::class => new CustomMiddleware(),
        ];
    }
}
```

También puedes asignar varios middleware a un nodo, definiendo un array:

```php
class MyWorkflow extends Workflow
{
    /**
     * Define el middleware de los nodos.
     */
    protected function middleware(): array
    {
        return [
            NodeOne::class => [
                new CustomMiddleware(),
                new AnotherMiddleware(),
            ]
        ];
    }
}
```

### Middleware global

Si quieres que el middleware se ejecute antes y después de cada nodo, puedes añadirlo a la pila global de middleware en el flujo de trabajo:

```php
class MyWorkflow extends Workflow
{
    /**
     * Define el middleware global.
     */
    protected function globalMiddleware(): array
    {
        return [
            new CustomMiddleware(),
        ];
    }
}
```

### Ejemplos

Neuron proporciona middleware preconstruido para casos de uso comunes, como la aprobación de herramientas o la resumación del contexto. Puedes verlos en la sección Agent:

{% content-ref url="/pages/b17ff1200828767959e6ec06f777645020907a3a" %}
[Middleware](https://docs.neuron-ai.dev/neuron-v3-es/agente/middleware.md)
{% endcontent-ref %}
