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

# Persistencia

Conserva el estado del flujo de trabajo entre ejecuciones.

Cuando hablamos de persistencia en Neuron, hablamos de la capacidad del sistema para capturar y preservar el estado completo de un flujo de trabajo en ejecución en cualquier momento.

Piénsalo como una sofisticada función de "guardar partida", pero para procesos empresariales. En cualquier punto, cuando se solicita una interrupción desde un nodo, Neuron crea una instantánea del estado de tu flujo de trabajo y la almacena en la capa de persistencia. Más tarde, ya sean segundos, horas o semanas, el flujo de trabajo puede restaurarse exactamente donde se quedó y continuar como si nada hubiera pasado.

Como es habitual en Neuron, la capa de persistencia del Workflow está construida sobre una interfaz común, por lo que es extensible e intercambiable. A continuación, la capa de persistencia compatible.

### InMemoryPersistence

Mantiene los datos solo en memoria durante el ciclo de ejecución actual.

```php
use NeuronAI\Workflow\Persistence\InMemoryPersistence;
use NeuronAI\Workflow\Persistence\PersistenceInterface;

class MyWorkflow extends Workflow
{
    ...
    
    protected function persistence(): PersistenceInterface
    {
        return new InMemoryPersistence();
    }
}
```

### FilePersistence

Almacenará los datos y el estado del Workflow en un archivo local.

```php
use NeuronAI\Workflow\Persistence\FilePersistence;
use NeuronAI\Workflow\Persistence\PersistenceInterface;

class MyWorkflow extends Workflow
{
    ...
    
    protected function persistence(): PersistenceInterface
    {
        return new FilePersistence(__DIR__);
    }
}
```

### RedisPersistence (*recomendado*)

Usa Redis, o un almacén de datos compatible con Redis, para persistir los datos transitorios de ejecución del flujo de trabajo.

{% hint style="warning" %}
Este componente requiere que tengas instalada en tu sistema la extensión de PHP Redis [`phpredis`](https://github.com/phpredis/phpredis) instalada en tu sistema.
{% endhint %}

```php
use NeuronAI\Workflow\Persistence\RedisPersistence;
use NeuronAI\Workflow\Persistence\PersistenceInterface;

class MyWorkflow extends Workflow
{
    ...
    
    protected function persistence(): PersistenceInterface
    {
        return new RedisPersistence(
            client: new Redis(...)
        );
    }
}
```

### DatabasePersistence

Para persistir la interrupción del flujo de trabajo en la base de datos, necesitas pasar una `PDO` instancia. Si estás trabajando sobre un framework, puedes obtenerla fácilmente desde el ORM de la misma manera que la [SQLChatHistory](https://docs.neuron-ai.dev/neuron-v3-es/agente/chat-history-and-memory.md#sqlchathistory) para la persistencia del historial de chat.

```php
use NeuronAI\Workflow\Persistence\DatabasePersistence;
use NeuronAI\Workflow\Persistence\PersistenceInterface;

class MyWorkflow extends Workflow
{
    ...
    
    protected function persistence(): PersistenceInterface
    {
        return new DatabasePersistence(
            pdo: new \PDO(...)
        );
    }
}
```

Aquí están los scripts SQL para crear la tabla:

{% tabs %}
{% tab title="MySQL/MariaDB" %}

```sql
CREATE TABLE workflow_store (
    `partition` VARCHAR(255) NOT NULL,
    `key`       VARCHAR(255) NOT NULL,
    `value`     TEXT NOT NULL,
    created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (`partition`, `key`)
);
```

{% endtab %}

{% tab title="PostgreSQL/SQLite" %}

```sql
CREATE TABLE workflow_store (
    "partition" VARCHAR(255) NOT NULL,
    "key"       VARCHAR(255) NOT NULL,
    "value"     TEXT NOT NULL,
    created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY ("partition", "key")
);
```

{% endtab %}
{% endtabs %}

### EloquentPersistence

Deberías crear tu propio modelo Eloquent y pasar la cadena de la clase como argumento del constructor. El modelo puede tener relaciones, scopes, atributos, etc. personalizados, pero la estructura básica debe basarse en este script de migración:

```bash
php artisan make:migration create_workflow_interrupts_table --create=workflow_interrupts
```

```php
Schema::create('workflow_store', function (Blueprint $table) {
    $table->id();
    $table->string('partition');
    $table->string('key');
    $table->longText('value');
    $table->timestamps();
    
    $table->unique(['partition', 'key']);
});
```

#### modelo WorkflowInterrupt

Esta es la estructura mínima requerida:

```php
class WorkflowStep extends Model
{
    protected $fillable = ['partition', 'key', 'value'];
}
```

Úsalo en el Workflow:

```php
use App\Models\WorkflowInterrupt;
use NeuronAI\Workflow\Persistence\EloquentPersistence;
use NeuronAI\Workflow\Persistence\PersistenceInterface;

class MyWorkflow extends Workflow
{
    ...
    
    protected function persistence(): PersistenceInterface
    {
        return new EloquentPersistence(WorkflowInterrupt::class);
    }
}
```
