> 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
As variáveis são um componente fundamental dos Workflows da AirOps, permitindo-lhe criar conteúdo dinâmico, personalizado e contextual. Saiba como referenciar variáveis nos seus Workflows, quer venham de inputs quer de saídas de passos.
### Tipos de Variáveis
Nos Workflows da AirOps, pode referenciar dois tipos principais de variáveis:
1. **Variáveis de Input**: Valores definidos no passo Start do seu Workflow, incluindo:
* Inputs personalizados (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 Input
As variáveis de input são referenciadas usando o Seletor de Variáveis (o ícone rosa no canto superior direito de um campo de input) ou usando a sintaxe Liquid com chavetas duplas: `{{ variable_name }}`
{% @arcade/embed url="" flowId="UOOVKYOIhh8WSNVTEosj" %}
#### Exemplo: Variáveis de Input Personalizadas
Quando define um input no passo Start do seu Workflow (como "topic" ou "keyword"), pode referenciá-lo 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 base:**
```
{{ 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:**
Ao usar colunas do Brand Kit em Grids, 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="" flowId="AgTu3iMw31nkpBdngDwu" %}
### Boas 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 em 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 Utilização Comuns
* Passe a input 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 da API: `{{ step_3.output.results[0].url }}`
* Formate texto com resultados de passos anteriores: `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 a inputs 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=&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.
