> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Variables

> Asigne variables para hacer dinámicas sus tareas de squads

# Uso de Variables en Tasks de Squad

En Orkeia, puedes usar variables en campos como `description`, `expectedResult` de tareas para hacerlas dinámicas, reutilizables y personalizadas en tiempo de ejecución.

## Sintaxis

Las variables siguen el siguiente formato:

```
#{NOMBRE_DE_LA_VARIABLE}
```

## Cómo Funciona

Las variables se sustituyen automáticamente en el momento de la ejecución del Squad. Basado en lo que se pasa, sea en el **\_description \_** o ***expectedResult***\*.\*

### Ejemplo

```json theme={null}
{
  "description": "Revisar el contrato del cliente #{CLIENTE_NOMBRE} con el número #{CONTRATO_ID}.",
  "expectedResult": "Contrato #{CONTRATO_ID} debe estar validado en el sistema hasta #{DATA_LIMITE}."
}
```

### Payload correspondiente

```json theme={null}
{
  "CLIENTE_NOMBRE": "Matheus Matos",
  "CONTRATO_ID": "CT-2025-123",
  "DATA_LIMITE": "10/09/2025"
}
```

### Resultado renderizado

* **Descripción:** Revisar el contrato del cliente Matheus Matos con el número CT-2025-123.
* **Resultado Esperado:** Contrato CT-2025-123 debe estar validado en el sistema hasta 10/09/2025.

## Casos de Uso Comunes

| Variable                 | Uso común                       |
| ------------------------ | ------------------------------- |
| `#{CLIENTE_NOMBRE}`      | Nombre del cliente              |
| `#{CONTRATO_ID}`         | Código de contrato/documento    |
| `#{DATA_LIMITE}`         | Fecha de vencimiento o entrega  |
| `#{USUARIO_RESPONSAVEL}` | Nombre del usuario responsable  |
| `#{EMAIL}`               | E-mail de notificación          |
| `#{ENDERECO}`            | Dirección o ubicación relevante |

## Observaciones

* Las variables deben estar **`exactamente en el formato #{VARIABLE}`**.
* Variables ausentes en el payload no se sustituirán y aparecerán en el texto final como están.
* Utiliza nombres claros y estandarizados para facilitar la reutilización.

## ¿Dónde puedo usar variables?

Las variables se utilizan dentro de las Tasks, pudiendo aparecer en dos campos específicos:

* `task.description`
* `task.expectedResult`

Así, en tiempo de ejecución, se aplican en las tareas de los Squads.