Conexões

Uma conexão liga um bloco ao próximo e define a ordem em que eles rodam. Como os blocos passam dados cobre o conceito: depois que um bloco roda, sua saída fica guardada sob o nome do bloco, e qualquer bloco posterior a lê por referência. Esta página é a referência da sintaxe da tag de conexão e dos formatos de saída que você vai acessar.

Sintaxe da tag

Uma tag de conexão referencia um valor da saída de um bloco anterior:

<blockName.path.to.data>

• blockName é o nome do bloco de origem. Os nomes dos blocos são normalizados antes do matching, então ficam em minúsculas e sem espaços. <My Agent.content> e <myagent.content> resolvem para o mesmo bloco.
• path.to.data é o caminho até o valor dentro da saída daquele bloco. O caminho do campo é case-sensitive.

A mesma sintaxe com colchetes angulares também lê variáveis de workflow (<variable.name>) e contexto de loop ou parallel (<loop.index>); uma tag de conexão é especificamente o caso de saída de bloco.

Você raramente digita uma tag na mão. Em qualquer campo de entrada, digite < para abrir um dropdown dos valores disponíveis de blocos anteriores e escolha um, ou arraste um valor de um bloco conectado direto para o campo.

Campos aninhados e arrays

Encadeie notação de ponto para entrar em objetos, e use índices entre colchetes para arrays. Os dois se combinam em um único caminho:

<agent1.tokens.total>
<api1.data.results[0].id>
<api2.data.users[0].name>

O resolvedor percorre o caminho em tempo de execução e substitui o valor. Vários níveis de indexação como items[0][1] também funcionam.

Usando tags em texto e código

As tags são resolvidas em tempo de execução e podem ficar em qualquer lugar de um campo, misturadas com texto estático:

// Em texto
"The user's name is <userBlock.name>"

// Em JSON
{
  "userName": "<userBlock.name>",
  "orderTotal": <apiBlock.data.total>
}

// Em um bloco Function
const greeting = `Hello, ${"<userBlock.name>"}!`
const total = <apiBlock.data.total> * 1.1

Os valores são formatados para caber no contexto. Em um bloco Function, um valor resolvido vira um literal de código, então strings ficam entre aspas, objetos são JSON e null permanece null, prontos para entrar em JavaScript ou Python. Em outros blocos, objetos são JSON-stringified e primitivos viram strings simples.

Quando um bloco referenciado não rodou no caminho atual — por exemplo, um bloco em uma ramificação não selecionada — sua tag resolve para um valor vazio. Na maioria dos blocos isso é uma string vazia; em blocos Function é null.

Saídas comuns de blocos

O caminho de uma tag depende do que o bloco de origem produziu. Estes são os formatos padrão dos blocos que você mais referencia. O painel de saída mostra a estrutura ao vivo de qualquer bloco.

{
  "content": "The generated text response",
  "model": "claude-sonnet-4-6",
  "tokens": { "input": 120, "output": 85, "total": 205 },
  "toolCalls": []
}

{
  "data": "Response body",
  "status": 200,
  "headers": { "content-type": "application/json" }
}

{
  "result": "Function return value",
  "stdout": "Console output"
}

{
  "conditionResult": true,
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Follow-up Agent"
  },
  "selectedOption": "condition-1"
}

{
  "content": "Routing decision",
  "model": "claude-sonnet-4-6",
  "tokens": { "input": 120, "output": 85, "total": 205 },
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Customer Service Agent"
  }
}

{
  "content": "Evaluation summary",
  "model": "claude-sonnet-4-6",
  "tokens": { "input": 120, "output": 85, "total": 205 },
  "metric1": 8.5,
  "metric2": 7.2
}

O result de um Function, o data de uma API e um Agent com response format retornam o que seu código, o serviço remoto ou seu schema produziram, então confira o painel de saída durante o desenvolvimento para confirmar o caminho que você está referenciando.

Próximos passos