Question utilisateur (UserQuestionTool)

Présentation

L'outil de question utilisateur permet à un agent de poser une question à l'utilisateur en cours d'exécution et d'attendre sa réponse. L'agent interrompt son travail, affiche une modale et reprend une fois la réponse soumise.

Cet outil est utile quand l'agent a besoin d'une clarification, d'un choix entre plusieurs options ou d'une information que seul l'utilisateur peut fournir.

Types de questions

L'outil propose trois types de questions, chacun adapté à un besoin différent.

Choix multiples

L'utilisateur sélectionne une ou plusieurs options dans une liste de cases à cocher. L'agent reçoit la liste des identifiants sélectionnés. Ce type est adapté aux choix fermés : sélection d'un fournisseur, choix d'une stratégie, validation d'éléments.

Texte libre

L'utilisateur rédige une réponse dans une zone de texte. Un texte indicatif peut être affiché dans la zone pour guider la saisie. Ce type est adapté aux réponses ouvertes : précisions, instructions détaillées, contenus à intégrer.

Mixte

Combine les deux précédents : cases à cocher et zone de texte dans la même modale. L'agent peut rendre la réponse textuelle obligatoire ou optionnelle. Ce type est adapté aux situations où l'agent a besoin d'un choix accompagné d'un commentaire ou d'une justification.

Déroulement d'une question

  1. L'agent pose la question — Il envoie le texte de la question, le type souhaité et les options éventuelles.
  2. La modale apparaît — L'interface affiche la question avec le formulaire adapté. Si le flux de travail n'est pas affiché, une notification informe l'utilisateur qu'une question est en attente.
  3. L'utilisateur répond — Il remplit le formulaire et soumet sa réponse, ou choisit d'ignorer la question.
  4. L'agent reçoit la réponse — Il reprend son exécution avec les données fournies par l'utilisateur.

Le délai maximal d'attente est de 5 minutes. Si l'utilisateur ne répond pas dans ce délai, la question expire et l'agent reçoit une erreur.

Contexte optionnel

L'agent peut joindre un texte de contexte à sa question. Ce texte est affiché dans un encadré distinct au-dessus du formulaire, permettant à l'utilisateur de comprendre pourquoi la question est posée et quel impact sa réponse aura sur la suite du travail.

Disjoncteur automatique

Pour éviter les questions répétitives quand l'utilisateur est absent, un disjoncteur automatique surveille les expirations consécutives :

  • Après 3 expirations consécutives, le disjoncteur s'ouvre et bloque temporairement les nouvelles questions.
  • Un délai de récupération de 60 secondes permet de réessayer.
  • Dès qu'une réponse est soumise (même après réouverture), le compteur se réinitialise.

Ignorer une question

L'utilisateur peut toujours ignorer une question en cliquant sur le bouton prévu à cet effet. L'agent reçoit alors une erreur indiquant que la question a été ignorée et doit adapter son comportement en conséquence.

Limites

  • Question : 2 000 caractères maximum
  • Options : 20 maximum, identifiant de 64 caractères, libellé de 256 caractères
  • Contexte : 5 000 caractères maximum
  • Réponse textuelle : 10 000 caractères maximum
  • Délai d'attente : 5 minutes
  • Disjoncteur : 3 expirations consécutives, récupération après 60 secondes

Types de questions

Trois types de questions adaptés à différents besoins d'interaction.

Choix multiples

checkbox

Cases à cocher parmi une liste d'options. Sélection simple ou multiple.

PostgreSQL
MySQL
SQLite

Texte libre

text

Zone de saisie pour une réponse ouverte avec texte indicatif optionnel.

Décrivez votre besoin...

Mixte

mixed

Cases à cocher et zone de texte combinées. Texte obligatoire ou optionnel.

Option A
Commentaire...

Déroulement

De la question posée par l'agent à la reprise de son exécution.

1
L'agent pose la question Texte, type, options et contexte optionnel sont envoyés
2
La modale apparaît Formulaire adapté au type de question. Notification si le flux n'est pas affiché.
3
L'utilisateur répond Soumet sa réponse ou ignore la question
4
L'agent reprend Exécution continue avec les données de la réponse
Délai maximal : 5 minutes

Si l'utilisateur ne répond pas dans ce délai, la question expire et l'agent reçoit une erreur.

Disjoncteur automatique

Mécanisme de protection qui bloque les questions quand l'utilisateur ne répond pas.

Fermé Fonctionnement normal, les questions sont autorisées
3 expirations consécutives
Ouvert Questions bloquées, l'agent reçoit une erreur immédiate
Après 60 secondes
Semi-ouvert Une seule question est autorisée en test
Réponse reçue → retour à fermé

Limites

Paramètre
Limite
Question
2 000 caractères
Nombre d'options
20 maximum
Identifiant d'option
64 caractères
Libellé d'option
256 caractères
Contexte
5 000 caractères
Réponse textuelle
10 000 caractères
Délai d'attente
5 minutes (300 secondes)
Seuil du disjoncteur
3 expirations consécutives
Récupération du disjoncteur
60 secondes
Ignorer une question ou laisser le délai expirer interrompt le flux de l'agent. L'agent reçoit une erreur et doit adapter son comportement, ce qui peut entraîner des résultats différents de ceux attendus.