> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/variable-referencing.md).

# Referência de Variáveis

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a00ca1d37fed1751ea34623b8bb926a9a6890689%2Fvariable-referencing-01-variable-picker.png?alt=media" alt="Variables Menu listing the Brand Kit and keyword inputs, the Google Search, Prompt LLM, and Web Page Scrape steps, and Workspace Secrets"><figcaption><p>Referencie as entradas do Workflow e os resultados de passos anteriores a partir do Menu de Variáveis.</p></figcaption></figure>

As variáveis são um componente fundamental dos AirOps Workflows, permitindo criar conteúdo dinâmico, personalizado e contextual. Saiba como referenciar variáveis nos seus Workflows, quer venham de entradas quer de resultados de passos.

### Tipos de Variáveis

Nos AirOps Workflows, pode referenciar dois tipos principais de variáveis:

1. **Variáveis de Entrada**: Valores definidos no passo Iniciar do seu Workflow, incluindo:
   * Entradas personalizadas (texto, números, JSON, ficheiros, etc.)
   * Atributos do Brand Kit
2. **Variáveis de Saída de Passo**: Resultados gerados por passos anteriores no seu Workflow

### Referenciar Variáveis de Entrada

As variáveis de entrada são referenciadas usando o Seletor de Variáveis (o ícone rosa no canto superior direito de um campo de entrada) ou usando a sintaxe Liquid com chavetas duplas: `{{ variable_name }}`

{% @arcade/embed url="<https://app.arcade.software/share/UOOVKYOIhh8WSNVTEosj>" flowId="UOOVKYOIhh8WSNVTEosj" %}

#### Exemplo: Variáveis de Entrada Personalizadas

Quando define uma entrada no passo Iniciar do seu Workflow (como "topic" ou "keyword"), pode referenciá-la em passos subsequentes:

```
{{ topic }}
{{ keyword }}
```

#### Exemplo: Variáveis do Brand Kit

Se tiver ligado um Brand Kit ao seu Workflow, pode referenciar os seus atributos:

**Atributos fundamentais:**

```
{{ brand_kit.brand_name }}
{{ brand_kit.brand_domain }}
{{ brand_kit.brand_about }}
{{ brand_kit.writing_tone }}
{{ brand_kit.writing_persona }}
{{ brand_kit.writing_rules }}
```

**Linhas de Produto, Tipos de Conteúdo, Públicos e Regiões:**

Quando usa colunas do Brand Kit em Grelhas, pode aceder às dimensões selecionadas:

```
{{ brand_kit.product_lines }}
{{ brand_kit.content_type }}
{{ brand_kit.content_type.outline }}
{{ brand_kit.content_type.writing_rules }}
{{ brand_kit.audience }}
{{ brand_kit.audience.description }}
{{ brand_kit.audience.writing_rules }}
{{ brand_kit.region }}
{{ brand_kit.region.description }}
{{ brand_kit.region.writing_rules }}
```

### Referenciar Variáveis de Saída de Passo

Cada passo no seu Workflow gera uma saída que pode ser referenciada em passos subsequentes. Estas são referenciadas usando o número do passo e a `saída` propriedade:

```
{{ step_1.output }}
```

Para passos que devolvem dados estruturados (como JSON), pode aceder a propriedades específicas:

```
{{ step_2.output.title }}
{{ step_3.output.keywords[0] }}
```

{% @arcade/embed url="<https://app.arcade.software/share/AgTu3iMw31nkpBdngDwu>" flowId="AgTu3iMw31nkpBdngDwu" %}

### Melhores práticas

* Use o Seletor de Variáveis (botão em forma de cápsula roxa) para adicionar facilmente referências de variáveis sem escrever a sintaxe
* Pré-visualize as saídas no painel de Teste para compreender a sua estrutura antes de as referenciar
* Para saídas JSON, verifique a estrutura no painel de Teste para referenciar corretamente propriedades aninhadas
* Lembre-se de que as variáveis só podem referenciar passos anteriores, não passos futuros

### Casos de uso comuns

* Passe a entrada do utilizador para um prompt de LLM: `Escreva um artigo sobre {{ topic }}`
* Inclua a voz da marca nos prompts: `{{ brand_kit.writing_persona }}`
* Processe a saída de um LLM num passo subsequente: `{{ step_1.output }}`
* Extraia dados específicos de respostas de API: `{{ step_3.output.results[0].url }}`
* Formate texto com resultados do passo anterior: `O título gerado é: {{ step_2.output.headline }}`

Ao aproveitar eficazmente as variáveis nos seus Workflows, pode criar aplicações poderosas e dinâmicas que respondem às entradas e se constroem com base nos resultados de cada passo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/variable-referencing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
