Collecter des informations

Un numéro de contrat, le motif d'un appel, une note de satisfaction : ces informations sont dites par l'appelant au fil de la conversation. Pour qu'elles servent, il faut que l'IA les recueille sous une forme précise, que le flow les garde, puis qu'elles arrivent quelque part : une base de données, la fin de session, votre CRM.

Cette page suit le trajet d'une information, de la bouche de l'appelant jusqu'à vos systèmes. La syntaxe des variables ({{…}}, valeurs de repli, chemins) est décrite dans Variables et données dynamiques.

Le trajet d'une informationCopier le lien

Vous n'avez pas besoin de toutes les étapes à chaque fois : une note de satisfaction peut aller directement dans les paramètres de fin, une adresse de livraison directement dans une base.

Faire recueillir une information par l'IACopier le lien

L'IA recueille une information quand elle appelle une fonction qui en a besoin. Les informations attendues sont les paramètres de l'outil que la fonction appelle : c'est en les décrivant bien que vous obtenez des valeurs exploitables.

Les écritures d'étatCopier le lien

Les écritures s'appliquent dans l'ordre, après l'exécution de la fonction.

La valeur est un texte fixe ou un chemin :

Une fois rangée, la valeur est disponible dans tous les blocs suivants : dans un prompt ({{state.parameters.numero_contrat}}), dans une condition de Sortie Conditionnelle, dans un champ de bloc qui accepte un chemin (state.parameters.numero_contrat).

Enregistrer dans une base de donnéesCopier le lien

Deux façons d'écrire dans une base pendant l'appel :

Dans le bloc Datastore, chacun des Champs de l'enregistrement reçoit un texte fixe ou un chemin state.*, par exemple state.parameters.numero_contrat. Voir Référence des blocs.

Transmettre en fin de conversationCopier le lien

Les Paramètres de fin du bloc Raccrocher attachent des informations à la session au moment où elle se termine. Ils sont enregistrés sur la transcription de la session, et inclus dans son export JSON.

1. Sélectionnez le bloc Raccrocher.
2. Sous Paramètres de fin, cliquez sur Paramètre libre (ou sur Paramètre si la liste contient déjà une ligne).
3. Saisissez la clé, par exemple numero_contrat (lettres, chiffres et _ uniquement).
4. Basculez la valeur en path et saisissez state.parameters.numero_contrat, ou laissez-la en abc pour une valeur fixe, par exemple issue = resolu.

Une valeur fixée ici n'est jamais écrasée par l'IA. Utilisez des valeurs fixes pour décrire l'issue que représente chaque bloc Raccrocher, et des chemins pour les informations recueillies.

En chat, les paramètres de fin sont reçus avec la fin de session.

Envoyer à vos systèmesCopier le lien

Un webhook de fin de session rattaché à l'agent envoie le transcript complet de chaque session d'appel à votre serveur, dès qu'elle se termine. Votre équipe technique y retrouve les échanges et les appels d'outils, avec leurs arguments. Voir Webhooks.

Pour envoyer une information pendant l'appel plutôt qu'après, appelez un outil HTTP / API depuis une fonction, ou un bloc Outil MCP (voir Outils).

Cas d'un agent sans flow : la sortie structuréeCopier le lien

Un agent qui ne suit pas de flow peut répondre directement au format JSON grâce à la capacité Sortie structurée (JSON) : vous décrivez les Propriétés du schéma (nom, type, description, requis) et chaque réponse de l'agent respecte ce schéma. Voir Définir une sortie structurée.

Cette option convient à un agent de traitement, par exemple le template Extraction de données, qui renvoie nom, e-mail, téléphone et sujet à partir d'un texte libre. Elle ne convient pas à un agent qui dialogue avec un client : sa réponse entière devient un objet JSON.

Vérifier ce qui a été collectéCopier le lien

1. Ouvrez le testeur de l'agent, activez Debug avant le premier message, puis menez la conversation.
2. Ouvrez la session dans Transcriptions.
3. Le journal de diagnostic affiche chaque écriture de variable (nom de la fonction, variable, nouvelle valeur) et, en cliquant sur une ligne Entrée dans « Nœud », toutes les variables connues à cet instant.

Un avertissement orange signale une variable utilisée dans un prompt mais absente à l'entrée du bloc : l'écriture d'état attendue n'a pas eu lieu, ou son chemin est mal orthographié.

Exemple : enquête de satisfaction en fin d'appelCopier le lien

Vous voulez une note de 1 à 5, le motif de la note et l'accord du client pour être recontacté.

1. Dans Datastores, créez la base satisfaction avec les champs note (Entier), motif (Texte) et recontact (Texte, « oui » ou « non »), puis générez son outil Ajouter : ajouter_satisfaction.
2. Dans le bloc Agent LLM « Enquête », Prompt de tâche : « Demande au client une note de 1 à 5, puis la raison de cette note, puis s'il accepte d'être recontacté. Appelle ensuite ajouter_satisfaction. »
3. Ajoutez la fonction ajouter_satisfaction, avec les écritures set parameters.note ← args.note et set parameters.recontact ← args.recontact.
4. Sortie Conditionnelle : branche state.parameters.note ≤ inf. ou égal 2 vers un Agent LLM « Rattrapage » qui s'excuse et propose un rappel ; repli sinon vers le bloc Raccrocher.
5. Dans le bloc Raccrocher, ajoutez les paramètres de fin note → state.parameters.note et recontact → state.parameters.recontact, en path.

Chaque réponse est enregistrée dans la base satisfaction, consultable et exportable en CSV depuis Datastores, et la note reste attachée à la session.

Bonnes pratiquesCopier le lien

• Un nom de variable par information, stable d'un flow à l'autre (numero_contrat, motif) : vos exports et vos règles côté serveur restent lisibles.
• Demandez une information à la fois dans le prompt, et faites confirmer les valeurs dictées (numéros, adresses) avant d'appeler la fonction.
• Décrivez le format dans le paramètre de l'outil, pas seulement dans le prompt : c'est la description que l'IA lit au moment de remplir l'argument.
• Vérifiez en mode debug que chaque écriture d'état se produit, avant de publier.

LimitesCopier le lien

• Il n'y a pas d'extraction automatique en fin d'appel : une information n'est rangée que si une fonction l'a reçue en argument, ou si un outil l'a renvoyée.
• Les arguments d'une fonction ne se modifient pas dans l'éditeur de flow : ils viennent de l'outil appelé.
• Les écritures d'état ne visent que des chemins qui commencent par parameters..

Pour aller plus loinCopier le lien