---
title: Iteração
slug: iteracao
createdAt: 2024-09-05T14:42:32.861Z
---

### Definição

Executa múltiplos passos em uma array até que todos os resultados sejam produzidos.

A etapa de iteração executa os mesmos passos em cada item de uma lista. Para usar a iteração, certifique-se de que o valor de entrada esteja formatado como um objeto de lista. O nó de iteração permite que workflows de IA lidem com uma lógica de processamento mais complexa. É uma versão simplificada do nó de loop, fazendo alguns compromissos em personalização para permitir que usuários não técnicos comecem rapidamente.

### Cenários

**Exemplo 1: Gerador de Iteração de Artigos Longos**

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/hf9tYc3jtdRbcrkqTPYp1_image.png)

- **Gerador de História Longa**
  Insira o título e o esboço da história no Nó de Início.
  Use um Nó de Geração de Subtítulos e Esboços para utilizar o LLM para gerar o conteúdo completo a partir da entrada do usuário.
  Use um Nó de Extração de Subtítulos e Esboços para converter o conteúdo completo em um formato de array.
  Use um Nó de Iteração para envolver um Nó LLM e gerar conteúdo para cada capítulo por meio de várias iterações.
  Adicione um Nó de Resposta Direta dentro do nó de iteração para obter saída em streaming após cada iteração.

**Passos Detalhados de Configuração**

1. Configure o título da história (*title*) e o esboço (*outline*) no Nó de Início.
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/Y2tgZjBcCrIWI90ZrRDgj_image.png)
2. Use um Nó de Geração de Subtítulos e Esboços para converter o título e o esboço da história em texto completo.
   1. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/ETPZ-B4bmBsO8J1SpPeRX_image.png)
3. Use um Nó de Extração de Subtítulos e Esboços para converter o texto da história em uma estrutura de array (Array). O parâmetro a ser extraído é *sections*, e o tipo de parâmetro é Array\[Object].
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/WCDAQWhOrqgrYMyfqX9dq_image.png)
4. Use o esboço da história em formato de array como entrada para o nó de iteração e processe-o dentro do nó de iteração usando um Nó LLM.
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/epdKju5aWYiv0pq6GL_BR_image.png)
5. Configure as variáveis de entrada *GenerateOverallOutline/output* e *Iteration/item* no Nó LLM.
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/HVALI4aJlnmOXDzzh8HNn_image.png)
6. Variáveis internas para iteração:
   - **items\[object]** representa o item de entrada para cada iteração;
   - **index\[number]** representa a rodada de iteração atual.
7. Configure um Nó de Resposta Direta dentro do nó de iteração para obter saída em streaming após cada iteração.
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/wbbr4WqxXIp8ZSZ1MCFRr_image.png)
8. Complete a depuração e a pré-visualização.
   1.

      ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/R0HrYkLxPaHcBn-qdrvZX_image.png)

**Exemplo 2: Outro Arranjo para Gerador de Iteração de Artigos Longos**

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/xnICw8UNcH6ngu1KHfTm6_image.png)

- Insira o título e o esboço da história no Nó de Início.
- Use um Nó LLM para gerar subtítulos e conteúdo correspondente para o artigo.
- Use um Nó de Código para converter o conteúdo completo em formato de array.
- Use um Nó de Iteração para envolver um Nó LLM e gerar conteúdo para cada capítulo por meio de várias iterações.
- Use um Nó de Conversão de Template para converter a saída do array de strings do nó de iteração de volta para uma string.
- Por fim, adicione um Nó de Resposta Direta para sair diretamente o texto convertido.

### O que é Conteúdo de Array

Uma lista é um tipo de dado específico onde elementos são separados por vírgulas e delimitados por \[ e ]. Por exemplo:

- Numérico:

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

- String:

```python
["Segunda-feira", "Terça-feira", "Quarta-feira", "Quinta-feira"]
```

- Objeto JSON:

```python
[
    {
        "nome": "Alice",
        "idade": 30,
        "email": "alice@example.com"
    },
    {
        "nome": "Bob",
        "idade": 25,
        "email": "bob@example.com"
    },
    {
        "nome": "Charlie",
        "idade": 35,
        "email": "charlie@example.com"
    }
]
```

**Nós que Suportam Retorno em Formato de Array**

- Nó de Código
- Extração de Parâmetros
- Recuperação de Base de Conhecimento
- Iteração
- Ferramentas
- Requisição HTTP

### Como Obter Conteúdo Formatado em Array

**Retorno Usando o Nó de CÓDIGO**

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/PSqTBigSsQAoaLRli-asO_image.png)

**Retorno Usando o Nó de Extração de Parâmetros**

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/ndOYe9UJCSifRlt_2c8EY_image.png)

**Como Converter um Array para Texto**
A variável de saída do nó de iteração está em formato de array e não pode ser diretamente exibida. Você pode usar um passo simples para converter o array de volta para texto.

**Converter Usando um Nó de Código**

**Conversão com o Nó de Código**
Exemplo de CÓDIGO:

```python
def main(articleSections: list):
    data = articleSections
    return {
        "result": "/n".join(data)
    }
```

**Converter Usando um Nó de Template**

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/_ZN93xTqsOTbFKvB6c-qA_image.png)

Exemplo de CÓDIGO:

```jinja
{{ articleSections | join("/n") }}
```