Structure des données de connexion

Lorsque vous connectez des blocs, la structure des données de sortie du bloc source détermine les valeurs disponibles dans le bloc de destination. Chaque type de bloc produit une structure de sortie spécifique que vous pouvez référencer dans les blocs en aval.

Comprendre ces structures de données est essentiel pour utiliser efficacement les balises de connexion et accéder aux bonnes données dans vos workflows.

Structures de sortie des blocs

Les différents types de blocs produisent des structures de sortie différentes. Voici ce que vous pouvez attendre de chaque type de bloc :

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

Champs de sortie du bloc Agent

content : La réponse textuelle principale générée par l'agent
model : Le modèle d'IA utilisé (ex. "gpt-4o", "claude-3-opus")
tokens : Statistiques d'utilisation des tokens
- prompt : Nombre de tokens dans le prompt
- completion : Nombre de tokens dans la complétion
- total : Total des tokens utilisés
toolCalls : Tableau des appels d'outils effectués par l'agent (le cas échéant)
cost : Tableau des objets de coût pour chaque appel d'outil (le cas échéant)
usage : Statistiques d'utilisation des tokens pour l'ensemble de la réponse

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

Champs de sortie du bloc API

data : Les données de réponse de l'API (peut être de n'importe quel type)
status : Code de statut HTTP de la réponse
headers : En-têtes HTTP retournés par l'API

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

Champs de sortie du bloc Fonction

result : La valeur de retour de la fonction (peut être de n'importe quel type)
stdout : Sortie console capturée pendant l'exécution de la fonction

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

Champs de sortie du bloc Évaluateur

content : Résumé de l'évaluation
model : Le modèle d'IA utilisé pour l'évaluation
tokens : Statistiques d'utilisation des tokens
[metricName] : Score pour chaque métrique définie dans l'évaluateur (champs dynamiques)

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

Champs de sortie du bloc Condition

content : Le contenu original transmis
conditionResult : Résultat booléen de l'évaluation de la condition
selectedPath : Informations sur le chemin sélectionné
- blockId : Identifiant du prochain bloc dans le chemin sélectionné
- blockType : Type du prochain bloc
- blockTitle : Titre du prochain bloc
selectedConditionId : Identifiant de la condition sélectionnée

{
  "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"
  }
}

Champs de sortie du bloc Routeur

content : Le texte de la décision de routage
model : Le modèle d'IA utilisé pour le routage
tokens : Statistiques d'utilisation des tokens
selectedPath : Informations sur le chemin sélectionné
- blockId : Identifiant du bloc de destination sélectionné
- blockType : Type du bloc sélectionné
- blockTitle : Titre du bloc sélectionné

Structures de sortie personnalisées

Certains blocs peuvent produire des structures de sortie personnalisées en fonction de leur configuration :

Blocs Agent avec format de réponse : Lorsqu'un format de réponse est utilisé dans un bloc Agent, la structure de sortie correspondra au schéma défini plutôt qu'à la structure standard.
Blocs Fonction : Le champ result peut contenir n'importe quelle structure de données retournée par votre code de fonction.
Blocs API : Le champ data contiendra ce que l'API retourne, ce qui peut être n'importe quelle structure JSON valide.

Vérifiez toujours la structure de sortie réelle de vos blocs pendant le développement pour vous assurer que vous référencez les bons champs dans vos connexions.

Structures de données imbriquées

De nombreuses sorties de blocs contiennent des structures de données imbriquées. Vous pouvez y accéder en utilisant la notation pointée dans les balises de connexion :

<blockId.path.to.nested.data>

Par exemple :

<agent1.tokens.total> - Accéder au nombre total de tokens d'un bloc Agent
<api1.data.results[0].id> - Accéder à l'identifiant du premier résultat d'une réponse API
<function1.result.calculations.total> - Accéder à un champ imbriqué dans le résultat d'un bloc Fonction

Structure des données de connexion

Sur cette page