Return Output: por que a resposta vem sem o nome da variável
Ao usar o bloco Tool Output > Return Output no fim de uma Tool, o retorno chega ao agente só com o conteúdo, sem o nome da variável. Isso é esperado — não é bug.
O Return Output entrega exatamente o valor configurado, sem envelope. Isso mantém a resposta enxuta e evita gastar contexto do modelo com nomes internos do fluxo.
As duas opções de Response Type
| Response Type | O que devolve |
|---|---|
| Last HTTP Response (padrão) | O corpo cru da última requisição HTTP do fluxo, como a API respondeu |
| Custom JSON | Um JSON que você escreve, no campo Custom JSON |
Como fazer a resposta vir nomeada
Troque Response Type para Custom JSON e monte o objeto usando as variáveis do fluxo — por exemplo, um objeto com as chaves nome_cliente, status_pedido e prazo_entrega, cada uma recebendo a variável correspondente do fluxo. Assim o agente recebe os campos já nomeados.
Com Last HTTP Response você não controla o formato — quem define é a API chamada. Se a resposta for grande ou confusa, prefira Custom JSON e devolva só os campos que o agente precisa.
Se o Custom JSON não for um JSON válido, ele é devolvido como texto literal, sem erro visível. Valide o JSON antes de publicar.
Quando a Tool devolve o resultado bruto do fluxo
Se o fluxo terminar sem passar por um Return Output — ou com o output vazio — a Tool devolve o resultado completo da execução em JSON, em vez da resposta limpa. É o sinal clássico de que faltou o bloco no caminho percorrido.
Garanta que todos os caminhos do fluxo (inclusive os de exceção) terminem em um Return Output.
Um fluxo que registra erro em algum passo mas ainda emite um Return Output válido não é tratado como falha pela Tool: o agente recebe a resposta válida normalmente.