> ## 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.

# Variáveis

> Atribua variáveis para tornar dinâmica as suas tarefas de squads

# Uso de Variáveis em Tasks de Squad

No Orkeia, você pode usar variáveis em campos como `description`, `expectedResult` de tarefas para torná-las dinâmicas, reutilizáveis e personalizadas em tempo de execução.

## Sintaxe

As variáveis seguem o seguinte formato:

```
#{NOME_DA_VARIAVEL}
```

## Como Funciona

As variáveis são substituídas automaticamente no momento da execução da Squad. Com base no que é passado, seja no **\_description \_**ou ***expectedResult***\*.\*

### Exemplo

```json theme={null}
{
  "description": "Revisar o contrato do cliente #{CLIENTE_NOME} com o número #{CONTRATO_ID}.",
  "expectedResult": "Contrato #{CONTRATO_ID} deve estar validado no sistema até #{DATA_LIMITE}."
}
```

### Payload correspondente

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

### Resultado renderizado

* **Descrição:** Revisar o contrato do cliente Matheus Matos com o número CT-2025-123.
* **Resultado Esperado:** Contrato CT-2025-123 deve estar validado no sistema até 10/09/2025.

## Casos de Uso Comuns

| Variável                 | Uso comum                         |
| ------------------------ | --------------------------------- |
| `#{CLIENTE_NOME}`        | Nome do cliente                   |
| `#{CONTRATO_ID}`         | Código de contrato/documento      |
| `#{DATA_LIMITE}`         | Data de vencimento ou entrega     |
| `#{USUARIO_RESPONSAVEL}` | Nome do usuário responsável       |
| `#{EMAIL}`               | E-mail de notificação             |
| `#{ENDERECO}`            | Endereço ou localização relevante |

## Observações

* As variáveis devem estar **`exatamente no formato #{VARIAVEL}`**.
* Variáveis ausentes no payload não serão substituídas e aparecerão no texto final como estão.
* Utilize nomes claros e padronizados para facilitar a reutilização.

## Onde posso usar variáveis?

As variáveis são utilizadas dentro das Tasks, podendo aparecer em dois campos em específicos:

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

Assim, em tempo de execução, elas são aplicadas nas tarefas dos Squads.