Dados entre etapas

Toda etapa pode usar o que as anteriores produziram. No Studio, isso acontece pelo botão Dado — você nunca digita caminho técnico.

O que está disponível

Origem	Contém
Entrada	O que o agente recebeu quando foi acionado
Etapas anteriores	O que cada etapa concluída produziu
A execução	Ambiente, identificador, quem pediu e a tentativa atual
O acionador	Como a execução foi disparada

E, apenas dentro da etapa "Para cada item", duas origens locais:

Origem local	Contém
O item	O elemento da lista sendo tratado nesta volta
A posição	A ordem do item, começando em zero

Fora do laço elas não existem, e o seletor não as oferece. Se uma referência a elas escapar para fora, a publicação é recusada — em vez de virar vazio em silêncio durante a execução.

O seletor mostra o que existe naquele ponto

A lista de dados disponíveis é calculada para aquela etapa, naquele ponto do fluxo. Uma etapa que roda antes de outra não enxerga o que a outra produzirá.

Isso não é só conveniência: a publicação prova que toda referência aponta para uma etapa que roda antes. Uma referência impossível é recusada com o nome da etapa, e não descoberta em produção.

O que cada etapa produz

Etapa	Produz
Ação do fluxo (consulta HTTP)	Código, corpo em JSON, corpo em texto, cabeçalhos, se truncou
Executar automação	Resultado da automação, se houve alteração, duração
Tarefa com IA	Texto da resposta, quantas ferramentas usou e — se você declarou — os campos
Gerar com um modelo	Texto gerado, modelo usado, motivo da parada, tokens
Preparar dados	Exatamente o objeto montado
Condição	O valor avaliado e a leitura verdadeiro/falso
Escolher um caminho	O caminho escolhido, o valor avaliado e se algum casou
Combinar resultados	O dado combinado, as origens sem dado e quantas trouxeram
Para cada item	Os resultados, os que falharam, quantos foram tratados e o total
Aprovação humana	Se foi aprovado, quem decidiu e o comentário
Aguardar	Quando retomou e quanto esperou
Chamar outro agente	O identificador da execução filha e o resultado dela

Campos declarados valem ouro

Uma Tarefa com IA sem saída declarada produz apenas texto. Com campos declarados, cada campo fica disponível separadamente para as etapas seguintes — e a etapa passa a ser verificável.

É a diferença entre a etapa seguinte receber um parágrafo e receber categoria = "financeiro".

Preparar dados

Quando o que a próxima etapa precisa não é exatamente o que a anterior produziu, use Preparar dados: você monta campo a campo, escolhendo de onde vem cada valor. Nenhum código é executado.

Usos típicos:

• juntar dados de duas etapas em um objeto só;
• renomear campos para o formato que um sistema externo espera;
• fixar valores constantes ao lado de valores dinâmicos.

Dados ausentes

Um caminho que aponta para algo que não existe devolve vazio, e não quebra a execução. Isso é o que permite tratar campos opcionais.

Mas atenção: uma etapa que foi pulada por uma condição não produziu nada, e referenciá-la devolve vazio. Se o vazio ali for um problema, trate-o explicitamente — em Combinar resultados, por exemplo, escolhendo falhar quando uma origem não trouxer dado.

Limites

Limite	Valor
Tamanho do que entra em uma execução	256 KiB
Texto produzido por junção de dados	64 KiB

Próximos passos

• Caminhos e repetição
• Tarefa com IA
• Testar antes de publicar