Permettre à l’agent de poser des questions de clarification

Utilisez cette option lorsqu’un Agent a besoin d’une précision, comme une destination ou une date, pour terminer sa tâche. La question apparaît dans la conversation existante, pas dans un portail de validation séparé.

Prérequis

• Configurez un fournisseur LLM et un modèle opérationnels.
• Utilisez une conversation Webchat, une session d’un canal API ou le panneau d’exécution interactif de la console.
• Activez Envoyer la réponse au canal et désactivez Sortie structurée.

Activer les questions

1. Ouvrez le flow et sélectionnez son nœud Agent.
2. Dans Outils, activez Autoriser les questions de clarification.
3. Définissez le Nombre maximal de questions : un entier de 1 à 5, 2 par défaut, par activation de l’Agent, y compris dans Loop/Repeat.
4. Prévoyez assez de Tours de raisonnement pour les outils, les questions et la réponse finale. La reprise ne réinitialise pas ce budget.
5. Précisez dans le prompt système quand demander une clarification. Par exemple : « Si la destination manque, demandez à l’utilisateur quel site il souhaite. Proposez Paris et Lyon. »
6. Enregistrez et testez le flow dans la console, son Webchat ou via son canal API.

Vérifier une conversation

Envoyez une demande sans destination. Lorsque le modèle décide de poser une question :

1. L’exécution et l’étape Agent passent à WAITING_HUMAN. La question et ses suggestions apparaissent, sans réponse finale de l’Agent.
2. Répondez dans la même conversation. Une question restreinte impose une suggestion ; une réponse invalide entraîne une nouvelle demande sans consommer de tour LLM.
3. La même exécution et la même étape reprennent. Les appels d’outils précédents et les itérations Loop/Repeat terminées ne sont pas rejoués.
4. Vérifiez la réponse finale et les nombres cumulés de tours et de tokens. L’historique conserve la question et la réponse acceptée.

Le modèle décide s’il doit demander une précision. L’activation ne force pas une question à chaque requête.

Sur un canal API, l’appel mis en pause renvoie status: "pending" avec le texte de la question dans output.messages, exactement comme un nœud Question. Rappelez /execute avec le même session_id et la réponse dans payload.user_message. Les suggestions ne sont pas renvoyées dans des champs distincts ; une réponse invalide à une question restreinte renvoie une nouvelle question qui liste les valeurs acceptées. Consultez Poursuivre une session et répondre à un nœud Question.

Si l’agent ne pose pas de question

• Vérifiez l’activation : l’option est désactivée par défaut dans les flows existants.
• L’outil n’est pas proposé aux exécutions Slack, Microsoft Teams ou WhatsApp, ni aux nœuds sans sortie vers le canal ou dont la publication attend une validation.
• Une fois le budget de questions épuisé, le modèle reçoit une erreur d’outil lui demandant de poursuivre en explicitant son hypothèse.
• La limite de raisonnement arrête les appels LLM supplémentaires. Augmentez-la uniquement si la tâche nécessite davantage de cycles.

Ce mécanisme ne remplace pas une autorisation ou une validation métier. Les outils ordinaires d’une même réponse du modèle sont exécutés avant la question. Conservez les contrôles d’autorisation et des actions irréversibles dans leur logique métier.

Aucune nouvelle tâche d’expiration ni notification par e-mail ou Slack n’est ajoutée. Une question sans réponse reste en attente selon la politique de conservation des exécutions. Les nouvelles tentatives de l’agent entier sont supprimées pendant le questionnement pour éviter de répéter les effets des outils.

Consultez les options de clarification de l’Agent pour la configuration, les limites de persistance et l’observabilité.