Pular para o conteúdo principal

Nó Agregador

O nó Agregador unifica variáveis de múltiplos ramos em uma única saída. Ele avalia os itens em ordem e retorna o primeiro valor válido.

Nó Agregador no Canvas

Como Funciona

  1. Você informa uma lista de fontes em ordem de prioridade.
  2. O Agregador testa a primeira fonte, depois a segunda, e assim por diante.
  3. Assim que encontrar um valor válido, ele para e retorna esse resultado.
  4. Se uma fonte estiver vazia, o fluxo segue para a próxima automaticamente.

Modos de Configuração

Você pode usar o Agregador de duas formas.

1. Saída não estruturada

Use este modo quando quiser retornar um único valor.

{
"config": {
"assign_variables": [
"{{primary.result}}",
"{{secondary.result}}",
"{{fallback.value}}"
]
}
}
{ "output": "value_from_first_valid_branch" }

Configuração

No painel lateral:

  1. Clique em Adicionar para incluir novas opções de entrada.
  2. Organize em ordem de prioridade (a primeira é a mais importante).
  3. Se quiser uma resposta com campos fixos, ative o modo de saída estruturada (abaixo).

Modo não estruturado do Agregador

2. Saída estruturada

Use este modo quando você precisar retornar um conjunto de campos fixos.

{
"config": {
"assign_variables": [
{"result": "{{branch1.result}}", "status": "{{branch1.status}}"},
{"result": "{{branch2.result}}", "status": "{{branch2.status}}"}
],
"output_schema": ["result", "status"]
}
}
{
"output": {
"result": "value_from_branch1",
"status": "success"
}
}

Configuração

No painel lateral:

  1. Adicione as chaves de saída no botão Adicionar Chave e escolha o nome.
  2. Adicione os grupos de variáveis que deseja comparar.
  3. Selecione as variáveis para cada chave em cada grupo.
  4. O Agregador irá comparar os grupos em ordem e retornar o primeiro conjunto de chaves com valores válidos e a saída terá a estrutura das chaves definidas.

Modo estruturado do Agregador

Saída

  • output no modo não estruturado: valor único.
  • output no modo estruturado: objeto com os campos definidos.

Exemplo Prático

Imagine que você quer buscar uma resposta em 3 lugares:

{
"assign_variables": [
"{{api_response.data}}",
"{{cache.value}}",
"{{default.value}}"
]
}

Resultado:

  1. O nó tenta api_response.data.
  2. Se estiver vazio, tenta cache.value.
  3. Se também estiver vazio, usa default.value.

Nós Relacionados