> 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/workflow-steps/flow/iteration.md).

# Iteração

Execute uma etapa várias vezes sobre uma lista de objetos

## Como funciona o Passo de Iteração?

O Passo de Iteração executa o(s) mesmo(s) passo(s) em cada entrada de uma lista. O único pré-requisito para usar um Passo de Iteração é garantir que os seus valores de entrada já foram formatados num objeto de lista.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5908d89cc09763f9eaca59287abd7d1e726b3854%2Fiteration-step-01-loop.png?alt=media" alt="Ranking Page Analyzer Workflow with an Iteration step that wraps a Prompt LLM step"><figcaption><p>O passo de Iteração executa os passos dentro dele uma vez por item da lista.</p></figcaption></figure>

## O que é uma lista?

Uma lista é um tipo de dado específico com elementos separados por vírgulas que começa com `[` e termina com `]` . Por exemplo:

**Uma lista de números:**

```
[1,2,3,4,5]
```

**Uma lista de strings:**

```
["vendas", "marketing", "finanças"]
```

**Uma lista de objetos JSON:**

```
[
  {
    "link": "https://openai.com/",
    "título": "OpenAI",
    "fonte": "OpenAI"
  },
  {
    "link": "https://www.youtube.com/@OpenAI",
    "título": "OpenAI",
    "fonte": "YouTube"
  },
  {
    "link": "https://en.wikipedia.org/wiki/OpenAI",
    "título": "OpenAI",
    "fonte": "Wikipedia"
  }
]
```

## Como crio uma lista?

As listas podem ser geradas de várias formas diferentes, incluindo através de um passo de LLM, um passo de código, Pesquisa Google ou um passo de API. No fim, tudo depende do que funciona melhor para o seu caso de uso, e fornecemos alguns exemplos abaixo para ajudar.

### Criar uma lista através de um Passo de LLM

Como os nossos Passos de LLM permitem ajustar o prompt até alcançar o resultado desejado, basta especificar o formato de lista no seu prompt.

Vamos analisar um exemplo de fluxo de trabalho que recebe o nome de um país como entrada e devolve as 5 principais cidades desse país. Vamos ajustar o fluxo de trabalho existente para devolver essas 5 principais cidades num formato de lista:

### Criar uma lista através de um Passo de Código

Como o nosso [Passo de Código](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/logic-steps/code.md) permite utilizar tanto JavaScript como Python, pode codificar manualmente a sua instrução de retorno para corresponder ao formato de lista desejado, por exemplo:

```javascript
return(["São Francisco", "Nova Iorque", "Miami"]);
```

### Gerar uma lista através de um Passo de Pesquisa Google

O nosso Passo de Pesquisa Google permite selecionar a formatação específica da pesquisa resultante:

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1cca0e01cb9c8a0672dce25b2e13e8dc82512a6f%2Fiteration-step-02-links-list.png?alt=media" alt="Google Search step Find ranking pages with the result type set to Links Only (List)"><figcaption><p>Escolha Apenas Links (Lista) para obter uma lista para o passo de Iteração.</p></figcaption></figure>

O resultado do Passo de Pesquisa Google será formatado assim:

```javascript
// Saída do Passo de Pesquisa Google com Apenas Links
[
  "https://www.mckinsey.com/featured-insights/mckinsey-explainers/what-is-prompt-engineering",
  "https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/",
  "https://www.techtarget.com/searchenterpriseai/definition/AI-prompt-engineer",
  "https://en.wikipedia.org/wiki/Prompt_engineering",
  "https://www.datacamp.com/blog/what-is-prompt-engineering-the-future-of-ai-communication",
  "https://www.iit.edu/blog/unlock-career-opportunities-ai-how-become-ai-prompt-engineer",
  "https://aws.amazon.com/what-is/prompt-engineering/",
  "https://hbr.org/2023/06/ai-prompt-engineering-isnt-the-future",
  "https://time.com/6272103/ai-prompt-engineer-job/",
  "https://www.promptingguide.ai/"
]
```

## O que é o elemento e o índice do elemento?

Um elemento é o objeto/valor real (por exemplo, string, número ou objeto) na sua lista.

O índice do elemento é a posição do elemento dentro da lista, começando com o primeiro elemento no índice 0.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a24a17379343efce73a640eaa9cbcd59ce79cf2f%2Fiteration-step-04-element-variables.png?alt=media" alt="Variables Menu opened from the Prompt LLM step inside an Iteration, with the Iterate through each department step expanded to Output, Element, and Element_index"><figcaption><p>Consulte o Element e o Element_index atuais da Iteração no Menu de Variáveis.</p></figcaption></figure>

## Como faço referência ao elemento?

Pode referenciar o elemento clicando na pill `step_x.element` dentro do seu Passo de Iteração:

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0aebdf05490a74e8c5ee74f69c0fa1907fc39d44%2Fiteration-step-03-element.png?alt=media" alt="Prompt LLM step inside an Iteration step, with a user message that references the current element from step_1.element"><figcaption><p>Referencie o elemento atual com step_x.element.</p></figcaption></figure>

No exemplo acima, o passo de LLM será executado 3 vezes, e o `{{step_1.element}]` será substituído por `vendas` , `marketing` , e `finanças` da seguinte forma:

* `Dê-me 3 personas no departamento de vendas`
* `Dê-me 3 personas no departamento de marketing`
* `Dê-me 3 personas no departamento de finanças`

## O índice do elemento é obrigatório?

O índice do elemento é opcional, mas pode ser usado para executar lógica poderosa.

Por exemplo, no caso do nosso redator de blog SEO, usamos o `element_index` para nos ajudar a escrever as nossas introduções. Como o nosso objetivo é fazer com que o redator *escreva apenas para a primeira secção* do blog, o índice do elemento é útil para aplicar o passo apenas nesse parágrafo.

Então, adicionamos um [**Passo** **Condicional**](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/flow/conditional.md) com:

* `step_x.element_index == 0`

o que nos permite usar um Passo de LLM separado com a introdução apenas para a primeira secção do blog.

## Como é que o resultado fica?

O passo de iteração também devolverá uma lista.

O resultado de cada iteração será adicionado à lista na mesma ordem da entrada.

## Como transformo a lista em texto?

Pode transformar o array novamente em texto com um simples **Texto** passo que usa Liquid:

```liquid
// Substitua step_x.output

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


---

# 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/workflow-steps/flow/iteration.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.
