Iteração
Repetir um trecho do fluxo sobre cada item de uma lista.
O nó de Iteração processa listas item a item, aplicando a mesma lógica a cada um.
Diferente dos outros nós, ele cria um sub-fluxo: no canvas ele aparece como um bloco maior, com nós desenhados dentro dele.
O ciclo
- Entrada: recebe uma variável do tipo lista, como
{{ extrator_arquivos.contents }}. - Processamento: executa os nós internos uma vez por item.
- Saída: agrupa os resultados individuais em uma nova lista.
A entrada precisa ser uma lista. Apontar para um valor único faz o nó falhar na execução.
Dentro do laço
O nó Início da iteração aparece automaticamente dentro do bloco e fornece item e index aos nós internos.
Um encadeamento típico liga o Início da iteração a um nó LLM, cujo prompt usa {{ inicio_da_iteracao.item }}.
Variáveis de saída
É aqui que você declara o que sai do laço, com dois campos:
- Nome da saída: o nome da nova lista, por exemplo
resumos. - Variável de origem: qual dado do sub-fluxo alimenta cada posição, normalmente a resposta do nó LLM interno.
Sem declarar variáveis de saída, o laço executa e nada atravessa para os nós seguintes.
Cada nó dentro do laço executa uma vez por item. Um nó LLM sobre uma lista de 200 elementos são 200 chamadas ao modelo. Estime o custo antes de liberar o fluxo para o time.
Próximos passos
- Entenda o nó interno em Início da iteração.
- Veja um fluxo completo de lote em Extrair dados de documentos em lote.