> 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/liquid-template.md).

# Modelação Liquid

Uma introdução à nossa poderosa linguagem de modelação

## O que é o Liquid?

[Liquid](https://shopify.github.io/liquid/basics/introduction/) é uma linguagem de template criada pela Shopify e amplamente usada por outros para criar conteúdo dinâmico. É útil para referenciar variáveis, modificar texto (por exemplo, truncar) e criar lógica básica (declarações if, loops for etc).

O Liquid pode ser usado na maioria das áreas do nosso produto, incluindo:

* Campos de Entrada em Workflows
* Prompts de LLM
* Etapas de Texto
* Etapas de Pesquisa na Base de Conhecimento
* Etapas de JSON

{% hint style="info" %}
Etapas de Código NÃO usam a Sintaxe Liquid
{% endhint %}

## Como Referenciar Entradas com Liquid

Esta seção mostrará como referenciar as suas variáveis de entrada predefinidas.

1. Certifique-se de que você tenha [configurado uma etapa de entrada](https://docs.airops.com/docs/pt/acoes/workflow-concepts/application-inputs.md)
2. Se você não inseriu um nome de variável separado, use o nome de variável padrão para referenciar o valor de entrada
3. Clique no Seletor de Variáveis roxo para ver uma lista das suas entradas disponíveis e selecionar a entrada desejada

No exemplo abaixo, mostramos como usar o valor da nossa variável de entrada e referenciá-lo na nossa Etapa de LLM usando a sintaxe Liquid.

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

## Como Referenciar Saídas com Liquid

Assim como com as entradas, você pode referenciar as saídas de qualquer etapa anterior do seu Workflow em qualquer etapa subsequente.

Atualmente, os nomes das etapas são definidos automaticamente de forma incremental, por exemplo: `step_1` ,`step_2` , `step_3` , etc.

Para referenciar a saída de uma etapa, basta clicar no `step_number` botão em forma de pílula ou digitá-lo manualmente no formato `{{step_12.output}}` . Se essa etapa gerar JSON, então você pode referenciar qualquer uma das subchaves.

No exemplo abaixo, mostramos como você pode ver a lista completa de variáveis disponíveis e usar a sintaxe correta para chamá-las dentro do seu Workflow.

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

### Consolidando Saídas de Etapas usando Liquid

Uma das aplicações mais úteis da sintaxe Liquid é combiná-la com a nossa Etapa de Texto para realizar formatação adicional e garantir que a sua saída fique exatamente como você deseja.

A captura de tela abaixo mostra como referenciamos a saída das etapas anteriores (até mesmo extraindo elementos específicos de arrays como variáveis) para formatar o nosso "step\_2" em uma saída mais legível e organizada.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-83e87e1e0226e601aca3866b172832cd4462e8d0%2Fliquid-01-compile-research.png?alt=media" alt="Compile Research Text step whose Liquid template loops over Google Search results and formats the top competitor and company details"><figcaption><p>Use o Liquid para formatar as saídas de etapas anteriores.</p></figcaption></figure>

### Casos de Uso Avançados de Template Liquid

O template Liquid oferece recursos poderosos para lidar com estruturas de dados complexas nos seus Workflows. Abaixo estão técnicas avançadas para trabalhar com iteradores, arrays e dados estruturados.

#### Percorrendo Saídas de Iteradores

Ao trabalhar com a Etapa de Iteração, você pode usar os `para` loops do Liquid para processar os elementos do array de saída. Esse padrão é comumente usado para consolidar informações de múltiplas iterações em uma única saída:

```
{% for chunk in step_12.output %}
  {{ chunk }}
{% endfor %}
```

#### Processando Resultados de Pesquisa

**Extração Básica de Conteúdo**

Extraia e formate conteúdo de resultados de pesquisa ou buscas na Base de Conhecimento:

```
{% for result in step_3.output %}
  {{ result.content }}
{% endfor %}
```

**Tratamento de Metadados**

Acesse e formate metadados dos resultados de pesquisa da Base de Conhecimento:

```
{% for result in step_4.output %}
  Título: {{ result.metadata.title }}
  Descrição: {{ result.metadata.description }}
{% endfor %}
```

Ao dominar essas técnicas avançadas de template Liquid, você pode transformar estruturas de dados complexas em saídas bem formatadas que servem como entradas perfeitas para as etapas subsequentes do seu Workflow.

### Mais Informações

Para obter informações adicionais sobre o Liquid, recomendamos consultar [a Documentação da Shopify](https://shopify.github.io/liquid/).


---

# 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/liquid-template.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.
