Fiches des blocs Studio

Cette page décrit le rôle, la configuration et les sorties des huit blocs principaux. Tous partagent les informations de base, la configuration avancée et les liens de sortie.

Message simple

Renvoie un texte fixe ou enrichi avec des variables. Utilisez-le pour une réponse sans LLM, une confirmation, un fallback ou un diagnostic temporaire.

Champ	Obligatoire	Description
Message	Oui	Texte renvoyé ; accepte les variables et helpers

Sortie : message, par exemple {{simpleMessage-1.message}}.

Bonjour {{userData.givenName}}, votre demande concerne : {{userMessage}}

Pour inspecter une valeur pendant la mise au point :

{{codeblock documents.body}}

Bonnes pratiques : gardez les messages courts, reliez les erreurs techniques à un message lisible et retirez les blocs de debug avant publication.

Erreurs fréquentes : message vide, variable mal orthographiée, fallback non relié ou donnée sensible affichée par un helper de debug.

Requête HTTP

Appelle une API interne ou externe pour interroger un service métier, lancer une recherche spécialisée ou envoyer des données.

RAG actuel

Pour la recherche documentaire RAG, utilisez le MCP Retriever avec MCP - Liste d'outils et MCP - Appel d'outils. Le bloc HTTP reste utile pour les API métier qui ne proposent pas d’interface MCP.

Champ	Obligatoire	Défaut	Description
URL	Oui	-	Adresse de l’API
Méthode HTTP	Oui	-	GET, POST, PUT, PATCH ou DELETE
En-têtes HTTP	Non	{}	Objet JSON d’en-têtes
Délai d’expiration	Oui	30	Timeout en secondes
Arrêter si la requête échoue	Non	true	Déclenche la branche d’échec
Codes HTTP acceptés	Oui	[200]	Tableau JSON de codes considérés comme succès
Type du corps	Non	raw	raw, formData ou x-www-form-urlencoded
Corps de la requête	Non	-	Données envoyées
Format de la réponse	Non	JSON	JSON, Text ou Binary

En-têtes :

{
  "Authorization": "Bearer {{customParams.mcpAccessToken}}",
  "Content-Type": "application/json"
}

Codes acceptés :

[200, 201, 204]

Corps de recherche :

{
  "query": "{{userMessage}}",
  "limit": 5
}

Sorties : body et metadata, par exemple {{http-1.body}}.

Bonnes pratiques : testez l’API hors Studio, utilisez un alias métier comme customer-api, ajoutez le bon Content-Type et reliez Après échec.

Erreurs fréquentes : URL invalide, objet d’en-têtes ou tableau de codes mal formé, référence incorrecte, format de réponse erroné ou timeout trop court.

Variables

Crée ou recalcule des valeurs pour simplifier une référence, partager une donnée entre plusieurs blocs ou la conserver pendant la conversation.

Champ	Obligatoire	Défaut	Description
Portée	Oui	REQUEST	REQUEST ou CONVERSATION
Nom	Oui	-	Nom unique de la variable
Valeur	Oui	-	Valeur ou expression à stocker

REQUEST limite la valeur au parcours courant. CONVERSATION la conserve entre plusieurs messages.

Portée : REQUEST
Nom : emailUtilisateur
Valeur : {{userData.email}}

Ce bloc crée directement {{emailUtilisateur}} et ne produit pas de sorties classiques préfixées par son identifiant.

Bonnes pratiques : préférez REQUEST, utilisez des noms courts sans accents ni espaces et évitez les doublons.

Condition

Choisit une route selon une ou plusieurs règles : résultat disponible, score suffisant, profil autorisé ou appels d’outils demandés.

Champ	Obligatoire	Description
Expression	Oui	Règle évaluée
Bloc suivant	Oui	Destination si la règle est vraie
Sinon	Recommandé	Destination si aucune règle ne correspond

Le champ Expression n’est pas un template de texte : n’entourez pas l’expression complète avec {{ et }}.

Besoin	Expression
Appels d’outils présents	gt (length chatCompletion-1.genericToolCalls) 0
Score et domaine email	and (gte score 70) (match userData.email "@wikit\\.ai$")
Priorité haute ou message urgent	or (eq ticket.priority "high") (contains userMessage "urgent")
Entre un et cinq documents	and (gte (length documents.body) 1) (lte (length documents.body) 5)
Aucun document ou faible confiance	or (isEmpty documents.body) (lt confidenceScore 0.5)

Opérateurs disponibles : égalité et différence, comparaisons gt/gte/lt/lte, and, or, not, match, contains et isEmpty.

Sorties : hasMatch, matchedIndex et nextStep.

Bonnes pratiques : gardez les règles simples, nommez clairement les destinations, prévoyez Sinon et testez chaque branche.

Instruction LLM

Prépare ce qui sera envoyé au modèle : instruction système, historique, documents, outils et budget de tokens. Ce bloc prépare les données mais ne génère pas la réponse finale.

Champ principal	Obligatoire	Description
Modèle LLM	Oui	Modèle utilisé pour préparer et estimer le prompt
Nom du connecteur LLM	Oui	Renseigné après sélection du modèle
Instruction	Non	Consigne système, avec variables éventuelles

Configuration avancée	Défaut	Description
Nombre maximum de tokens	128000	Budget du prompt
Outils	null	Référence vers les outils MCP
Configuration des documents	null	Tableau JSON de documents à injecter
Messages d’expiration	-	Remplacement des anciens documents/résultats d’outils

Configuration documentaire :

[
  {
    "varName": "{{documents.body}}",
    "documentType": "elasticsearch",
    "expiresAfter": 3,
    "maxDocumentsTokens": 16000
  }
]

Cette configuration reste disponible pour les sources déjà présentes dans une variable ou pour les intégrations historiques. Dans les nouveaux workflows RAG, les résultats de MCP Retriever sont ajoutés automatiquement à conversationHistory par MCP - Appel d'outils : laissez Configuration des documents désactivée.

Outils : {{listTools-1.tools}}.

Sorties : raw, metadata, messages, instruction et tools. La référence courante est {{generatePrompt-1.instruction}} ou l’équivalent via alias.

Tu réponds uniquement à partir des documents fournis.
Question utilisateur : {{userMessage}}

Bonnes pratiques : gardez l’instruction structurée, séparez règles et données dynamiques, et n’activez documents ou outils que si nécessaire.

Erreurs fréquentes : modèle absent, mauvaise référence de documents, outils activés sans catalogue MCP, JSON invalide ou budget trop faible.

Requête LLM

Appelle le modèle avec l’instruction préparée et produit une réponse textuelle ou des demandes d’outils.

Champ principal	Obligatoire	Défaut	Description
Modèle LLM	Oui	-	Modèle de génération
Nom du connecteur LLM	Oui	-	Renseigné automatiquement
Variable de l’instruction	Oui	-	Par exemple {{generatePrompt-1.instruction}}
URL de l’API du LLM	Oui	LiteLLM	Endpoint d’appel

Configuration avancée	Défaut	Description
En-têtes HTTP	{}	En-têtes de l’API LLM
Délai d’expiration	60	Timeout en secondes
Température	0.5	Variation entre 0 et 2
Limite de tokens	-	Maximum généré
Streaming	true	Diffusion progressive
Outils	null	Par exemple {{listTools-1.tools}}
Mode strict	true	Respect des schémas d’outils

Une température 0 convient aux réponses factuelles ; 0.5 équilibre stabilité et variation ; 1 ou plus augmente la créativité et l’imprévisibilité.

Sorties : content, genericToolCalls et metadata.

Bonnes pratiques : placez une Instruction LLM juste avant, gardez le streaming actif et ne modifiez l’URL technique que si nécessaire.

MCP - Liste d’outils

Charge les outils disponibles depuis un ou plusieurs serveurs MCP afin que le modèle puisse ensuite les demander.

Pour chaque serveur :

Champ	Obligatoire	Défaut	Description
Nom du serveur MCP	Oui	-	Libellé métier
URL du serveur MCP	Oui	-	Endpoint MCP
En-têtes du serveur MCP	Non	{}	Authentification et contexte
Outils	Non	[]	Outils autorisés
Meta	Non	{}	Métadonnées additionnelles

Utilisez Récupérer les outils pour interroger le serveur, puis limitez la sélection aux outils nécessaires.

{
  "Authorization": "{{customParams.mcpAuthorization}}"
}

{
  "conversationId": "{{queryExecutionId}}",
  "userEmail": "{{userData.email}}"
}

Sorties : tools, toolServerRouting et metadata.

Erreurs fréquentes : URL ou token incorrect, JSON invalide, accès réseau impossible, outils non récupérés ou sélection incohérente.

MCP - Appel d’outils

Exécute les appels demandés par une Requête LLM. Il consomme à la fois genericToolCalls et le routage préparé par la liste d’outils.

Champ	Obligatoire	Défaut	Description
Exécutions d’outils	Oui	-	{{chatCompletion-1.genericToolCalls}}
Serveur de routage des outils	Oui	-	{{listTools-1.toolServerRouting}}
Délai d’expiration	Oui	60	Timeout des appels

Sorties : metadata et toolCallResults.

Placez une condition avant ce bloc pour vérifier que des appels existent. Après l’exécution, préparez une nouvelle instruction si le LLM doit reformuler le résultat.

Erreurs fréquentes : référence vers le mauvais LLM ou catalogue, liste d’appels vide, token expiré ou timeout trop court.