Tags

Tags de conexão são representações visuais dos dados disponíveis a partir de blocos conectados, fornecendo um jeito fácil de referenciar dados entre blocos e saídas de blocos anteriores no seu workflow.

O que são Tags de Conexão?

Tags de conexão são elementos interativos que aparecem quando blocos são conectados. Elas representam os dados que podem fluir de um bloco para outro e permitem que você:

Visualize dados disponíveis a partir de blocos de origem
Referencie campos de dados específicos em blocos de destino
Crie fluxos de dados dinâmicos entre blocos

Tags de conexão facilitam ver quais dados estão disponíveis de blocos anteriores e usá-los no seu bloco atual sem precisar lembrar de estruturas de dados complexas.

Usando Tags de Conexão

Existem duas formas principais de usar tags de conexão no seu workflow:

Arrastar e Soltar

Clique em uma tag de conexão e arraste para campos de entrada de blocos de destino. Um dropdown vai aparecer mostrando os valores disponíveis.

Passe o mouse sobre uma tag de conexão para ver dados disponíveis
Clique e arraste a tag para um campo de entrada
Selecione o campo de dados específico do dropdown
A referência é inserida automaticamente

Sintaxe de Colchetes Angulares

Digite <> em campos de entrada para ver um dropdown dos valores de conexão disponíveis a partir de blocos anteriores.

Clique em qualquer campo de entrada onde você quer usar dados conectados
Digite <> para ativar o dropdown de conexão
Navegue e selecione os dados que você quer referenciar
Continue digitando ou selecione do dropdown para completar a referência

Sintaxe de Tags

Tags de conexão usam uma sintaxe simples para referenciar dados:

<blockName.path.to.data>

Onde:

blockName é o nome do bloco de origem
path.to.data é o caminho para o campo de dados específico

Por exemplo:

<agent1.content> - Referencia o campo content de um bloco com ID "agent1"
<api2.data.users[0].name> - Referencia o nome do primeiro usuário na array de usuários do campo data de um bloco com ID "api2"

Referências de Tags Dinâmicas

Tags de conexão são avaliadas em tempo de execução, o que significa:

Elas sempre referenciam os dados mais atuais
Elas podem ser usadas em expressões e combinadas com texto estático
Elas podem ser aninhadas dentro de outras estruturas de dados

Exemplos

// Reference in text
"The user's name is <userBlock.name>"

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

// Reference in code
const greeting = "Hello, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // Add 10% tax

Quando usar tags de conexão em contextos numéricos, tenha certeza que os dados referenciados são realmente um número para evitar problemas de conversão de tipo.