Configurer les champs à collecter

Définissez les informations que votre chatbot doit collecter auprès du visiteur avant d'exécuter une action.

Qu’est-ce qu’un champ à collecter ?

Les champs à collecter (collect fields) sont des informations que votre chatbot doit obtenir du visiteur avant d’exécuter une action. Contrairement aux paramètres techniques du webhook, ces champs représentent des données conversationnelles.

Exemple concret

Vous avez une action « Créer un ticket JIRA ». Le template JIRA nécessite déjà un résumé et une description. Mais vous souhaitez aussi collecter l’email du client et son numéro de commande pour les inclure dans le ticket.

Plutôt que de modifier le template, ajoutez ces informations comme champs à collecter :

Comment ça fonctionne ?

1. Les champs à collecter sont ajoutés au schéma de l’outil (tool) envoyé au LLM
2. Le LLM demande naturellement ces informations au visiteur lors de la conversation
3. Une fois l’action exécutée, les valeurs collectées sont concaténées dans un champ cible (par défaut, la description du ticket/message — configurable par le template)
4. Les champs à collecter ne sont pas envoyés comme paramètres webhook — ils enrichissent le contexte

Format d’injection

Les informations collectées sont ajoutées à la fin de la description :

Description originale du ticket...

---
Informations collectées :
- Adresse email du client : jean.dupont@example.com
- Numéro de commande concerné : CMD-2024-1234

Configurer les champs

1. Dans l’onglet Actions, cliquez sur une action existante (ou créez-en une)
2. Dans le modal de configuration, trouvez la section Champs à collecter
3. Cliquez sur Ajouter un champ
4. Remplissez :
   • Nom : identifiant technique du champ (ex : email, numero_commande)
   • Description : texte explicatif que le LLM utilisera pour comprendre quoi demander (ex : « Adresse email du client »)
   • Requis : cochez si le champ est obligatoire avant l’exécution
5. Enregistrez l’action

Champs requis vs optionnels

• Requis : le LLM ne déclenchera pas l’action tant que le visiteur n’a pas fourni cette information
• Optionnel : le LLM peut exécuter l’action même si le visiteur n’a pas fourni cette information

Conseil : Limitez les champs requis au strict nécessaire. Chaque champ requis ajoute un échange supplémentaire dans la conversation.

Bonnes pratiques

• Descriptions claires : écrivez des descriptions qui aident le LLM à poser la bonne question (« Adresse email professionnelle du client » plutôt que « email »)
• Noms techniques : utilisez des noms courts sans espaces ni accents (ex : email, nom_complet, numero_commande)
• Pas de doublons : ne créez pas un champ qui existe déjà dans les paramètres du template
• Maximum 10 champs : au-delà, la conversation devient trop longue

Différence avec les guidance rules

Pour en savoir plus sur les guidance rules : Guidance rules.