> 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/managing-the-state.md).

# Gestión del estado

Aprende cómo pasar datos a través del flujo de trabajo

Hablando en general, el propósito de un flujo de trabajo es obtener un estado inicial como entrada, permitir que los nodos manipulen este estado durante la ejecución y devolver el estado final cuando el flujo de trabajo se completa.

### Entrada/Salida del flujo de trabajo

El valor de retorno final del flujo de trabajo en sí es una instancia del estado del flujo de trabajo. Por lo tanto, si necesitas recopilar el resultado de la ejecución del flujo de trabajo, los nodos deben poder escribir y leer del estado hasta que el flujo de trabajo termine y devolver el estado final al script padre.

También puedes proporcionar un estado inicial al flujo de trabajo para introducir valores de entrada.

```php
// 1. Proporciona un estado inicial como entrada del flujo de trabajo para introducir algunos datos
$workflow = Workflow::make(state: new WorkflowState(['query' => 'Hi!']))
    ->setWorkflowId('wk_id')
    ->addNode(new InitialNode())
    ->addNode(...)
    ->addNode(...);

// 2. Ejecuta el flujo de trabajo y obtén el estado final
$finalState = $workflow->run();

// 3. Usa los datos del estado final
echo $finalState->get('message');
```

### Uso del estado en los nodos

En nuestros ejemplos hasta ahora, hemos pasado datos de nodo a nodo usando propiedades de eventos personalizados. Esta es una forma poderosa de pasar datos, pero tiene limitaciones. Por ejemplo, si quieres pasar datos entre pasos que no están conectados directamente, necesitas pasar los datos a través de todos los nodos intermedios. Esto puede hacer que tu código sea más difícil de leer y mantener.

Por estas razones tenemos el `WorkflowState` objeto disponible para cada nodo en el flujo de trabajo. Para usarlo, el flujo de trabajo inyecta la instancia de WorkflowState como el segundo argumento del nodo.

```php
use NeuronAI\Workflow\WorkflowState;

class InitialNode extends Node
{
    public function __invoke(
        StartEvent $event, 
        WorkflowState $state,
        WorkflowResources $resources
    ): StopEvent {
        $state->set('message', 'Hello World!');
        
        return new StopEvent();
    }
}
```

### Estado personalizado

La `WorkflowState` clase predeterminada es un contenedor para llevar datos durante la ejecución del flujo de trabajo. Puede ser útil crear una clase de estado personalizada para definir propiedades estrictamente tipadas y lograr un mejor autocompletado en el código de tus nodos, validación de datos y depuración general.

Crea una `CustomState` clase para introducir propiedades personalizadas:

```php
use App\Models\User;
use NeuronAI\Workflow\WorkflowState;

class CustomState extends WorkflowState
{
    protected User $user;
    
    public function setUser(User $user): CustomState
    {
        $this->user = $user;
        return $this;
    }
    
    public function getUser(): User
    {
        return $this->user;
    }
}
```

Los nodos pueden aceptar una instancia de `CustomState` en lugar del `WorkflowState`:

```php
class ExampleNode extends Node 
{
    public function __invoke(
        StartEvent $event, 
        CustomState $state,
        WorkflowResources $resources
    ): StopEvent {
        // Usa las propiedades del estado en tus nodos
        if ($state->getUser()->isAdmin()) {
            //...
        }
        
        return new StopEvent();
    }
}
```

Inyecta el `CustomState` en la creación del flujo de trabajo:

```php
$state = new CustomState();
$state->setUser($user);

$finalState = MyWorkflow::make(state: $state)
    ->setWorkflowId('wk_id')
    ->run();

echo $finalState->getUser()->email;
```
