Pular para o conteúdo principal
Cuando conectas bloques, entender la estructura de datos de las diferentes salidas de bloques es importante porque la estructura de datos de salida del bloque de origen determina qué valores están disponibles en el bloque de destino. Cada tipo de bloque produce una estructura de salida específica a la que puedes hacer referencia en bloques posteriores.
Entender estas estructuras de datos es esencial para utilizar eficazmente las etiquetas de conexión y acceder a los datos correctos en tus flujos de trabajo.

​
Estructuras de salida de bloques

Diferentes tipos de bloques producen diferentes estructuras de salida. Esto es lo que puedes esperar de cada tipo de bloque:
  • Tab Title
  • Tab Title
  • Tab Title
  • Tab Title
  • Tab Title
  • Tab Title
{
  "content": "The generated text response",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "toolCalls": [...],
  "cost": [...],
  "usage": [...]
}

​
Campos de salida del bloque de agente

  • content: La respuesta de texto principal generada por el agente
  • model: El modelo de IA utilizado (p. ej., “gpt-4o”, “claude-3-opus”)
  • tokens: Estadísticas de uso de tokens
    • prompt: Número de tokens en el prompt
    • completion: Número de tokens en la respuesta
    • total: Total de tokens utilizados
  • toolCalls: Array de llamadas a herramientas realizadas por el agente (si las hay)
  • cost: Array de objetos de costo para cada llamada a herramienta (si las hay)
  • usage: Estadísticas de uso de tokens para toda la respuesta

​
Estructuras de salida personalizadas

Algunos bloques pueden producir estructuras de salida personalizadas según su configuración:
  1. Bloques de agente con formato de respuesta: Al usar un formato de respuesta en un bloque de agente, la estructura de salida coincidirá con el esquema definido en lugar de la estructura estándar.
  2. Bloques de función: El campo result puede contener cualquier estructura de datos devuelta por el código de tu función.
  3. Bloques de API: El campo data contendrá lo que devuelva la API, que podría ser cualquier estructura JSON válida.
Verifica siempre la estructura de salida real de tus bloques durante el desarrollo para asegurarte de que estás referenciando los campos correctos en tus conexiones.

​
Estructuras de datos anidadas

Muchas salidas de bloques contienen estructuras de datos anidadas. Puedes acceder a estas utilizando la notación de punto en las etiquetas de conexión: 
<blockName.path.to.nested.data>
Por ejemplo:
  • <agent1.tokens.total> - Accede al total de tokens desde un bloque de Agente
  • <api1.data.results[0].id> - Accede al ID del primer resultado de una respuesta de API
  • <function1.result.calculations.total> - Accede a un campo anidado en el resultado de un bloque de Función