Nó de Iteração

O nó de Iteração permite processar listas de itens de forma automática. Se você tem uma lista com 10 documentos e quer resumir cada um deles individualmente usando a mesma lógica, é este nó que você deve usar.

Como Funciona

Diferente dos outros nós, a Iteração cria um Sub-fluxo.

1. Entrada: Ele recebe uma lista (Array) de dados (ex: lista de arquivos, lista de e-mails).
2. Processamento: Ele executa os nós que estão dentro dele para cada item da lista.
3. Saída: Ele agrupa os resultados individuais e devolve uma nova lista com as respostas.

Configuração

No painel lateral, você define o que entra e o que sai do loop.

1. Entrada

Selecione a lista que será processada.

• Deve ser obrigatoriamente uma variável do tipo Lista/Array.
• Exemplo: {{ extrator_arquivos.contents }} (uma lista de textos extraídos).

2. Variáveis de Saída

Aqui você define quais dados do sub-fluxo você quer trazer para fora.

• Nome da Saída: O nome da nova lista que será criada (ex: resumos).
• Variável de Origem: Qual dado do sub-fluxo deve ser coletado (ex: a resposta da LLM de dentro do loop).

---

Construindo o Sub-fluxo

Ao adicionar um nó de Iteração, você notará que ele é visualmente maior e possui um Nó de Início (Azul) dentro dele.

O Nó de Início da Iteração

Este pequeno nó azul representa o item atual que está sendo processado. Ele fornece duas variáveis para os nós internos:

1. item: O conteúdo do item atual da lista.
2. index: O número da posição do item (0, 1, 2...).

Conectando a Lógica Interna

Para processar os dados, deve se clicar no círculo azul com o "+" a direita do nó e selecionar o novo nó a ser adicionado.

Exemplo de Configuração Interna:

1. Conecte o Início da Iteração a uma LLM.
2. No prompt da LLM, use: Resuma isto: {{ inicio_da_iteracao.item }}.

---

Exemplo Prático: Resumo de Múltiplos Arquivos

Imagine que você quer resumir 5 contratos PDF diferentes.

1. Nó Principal: Usa o Extrator de Arquivos para gerar uma lista de textos.
2. Nó de Iteração:
   • Entrada: Recebe a lista do extrator.
   • Sub-fluxo: Contém uma LLM com o prompt "Resuma este contrato".
   • Saída: Mapeia a resposta da LLM para uma variável chamada lista_de_resumos.
3. Nó Final: Recebe {{ iteracao.lista_de_resumos }} contendo os 5 resumos prontos.