Estrutura de Dados

Quando você conecta blocos, entender a estrutura de dados das diferentes saídas de blocos é importante porque a estrutura de dados de saída do bloco de origem determina quais valores estão disponíveis no bloco de destino. Cada tipo de bloco produz uma estrutura de saída específica que você pode referenciar nos blocos subsequentes.

Entender essas estruturas de dados é essencial para usar efetivamente tags de conexão e acessar os dados certos nos seus workflows.

Estruturas de Saída de Blocos

Diferentes tipos de blocos produzem diferentes estruturas de saída. Aqui está o que você pode esperar de cada tipo de bloco:

{
  "content": "The generated text response",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "toolCalls": [...],
  "cost": [...],
  "usage": [...]
}

Campos de Saída do Bloco Agent

content: A resposta principal de texto gerada pelo agente
model: O modelo de IA usado (por exemplo, "gpt-4o", "claude-3-opus")
tokens: Estatísticas de uso de tokens
- prompt: Número de tokens no prompt
- completion: Número de tokens na conclusão
- total: Total de tokens usados
toolCalls: Array de chamadas de ferramenta feitas pelo agente (se houver)
cost: Array de objetos de custo para cada chamada de ferramenta (se houver)
usage: Estatísticas de uso de tokens para toda a resposta

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

Campos de Saída do Bloco API

data: Os dados de resposta da API (pode ser de qualquer tipo)
status: Código de status HTTP da resposta
headers: Headers HTTP retornados pela API

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

Campos de Saída do Bloco Function

result: O valor retornado pela função (pode ser de qualquer tipo)
stdout: Saída do console capturada durante a execução da função

{
  "content": "Evaluation summary",
  "model": "gpt-5",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "metric1": 8.5,
  "metric2": 7.2,
  "metric3": 9.0
}

Campos de Saída do Bloco Evaluator

content: Resumo da avaliação
model: O modelo de IA usado para avaliação
tokens: Estatísticas de uso de tokens
[metricName]: Pontuação para cada métrica definida no avaliador (campos dinâmicos)

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

Campos de Saída do Bloco Condition

content: O conteúdo original passado
conditionResult: Resultado booleano da avaliação da condição
selectedPath: Informações sobre o caminho selecionado
- blockId: ID do próximo bloco no caminho selecionado
- blockType: Tipo do próximo bloco
- blockTitle: Título do próximo bloco
selectedConditionId: ID da condição selecionada

{
  "content": "Routing decision",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Customer Service Agent"
  }
}

Campos de Saída do Bloco Router

content: O texto da decisão de roteamento
model: O modelo de IA usado para roteamento
tokens: Estatísticas de uso de tokens
selectedPath: Informações sobre o caminho selecionado
- blockId: ID do bloco de destino selecionado
- blockType: Tipo do bloco selecionado
- blockTitle: Título do bloco selecionado

Estruturas de Saída Customizadas

Alguns blocos podem produzir estruturas de saída customizadas baseadas em sua configuração:

Blocos Agent com Response Format: Quando você usa um formato de resposta em um bloco Agent, a estrutura de saída vai corresponder ao schema definido em vez da estrutura padrão.
Blocos Function: O campo result pode conter qualquer estrutura de dados retornada pelo seu código de função.
Blocos API: O campo data vai conter o que a API retornar, que pode ser qualquer estrutura JSON válida.

Sempre verifique a estrutura de saída real dos seus blocos durante o desenvolvimento para garantir que você está referenciando os campos corretos nas suas conexões.

Estruturas de Dados Aninhadas

Muitas saídas de blocos contêm estruturas de dados aninhadas. Você pode acessar estas usando notação de ponto em tags de conexão:

<blockName.path.to.nested.data>

Por exemplo:

<agent1.tokens.total> - Acesse o total de tokens de um bloco Agent
<api1.data.results[0].id> - Acesse o ID do primeiro resultado de uma resposta API
<function1.result.calculations.total> - Acesse um campo aninhado no resultado de um bloco Function

Estrutura de Dados

On this page