Structure des données de connexion
Comprendre la structure des données des sorties des différents blocs
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
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
resultpeut contenir n'importe quelle structure de données retournée par votre code de fonction. -
Blocs API : Le champ
datacontiendra 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