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.
Which authentication strategies should I implement in the refactored module? The current module uses JWT tokens with refresh rotation. I found 3 auth strategies in the codebase.Question from Agent
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
- L'agent pose la question — Il envoie le texte de la question, le type souhaité et les options éventuelles.
- 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.
- L'utilisateur répond — Il remplit le formulaire et soumet sa réponse, ou choisit d'ignorer la question.
- 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
checkboxCases à cocher parmi une liste d'options. Sélection simple ou multiple.
Texte libre
textZone de saisie pour une réponse ouverte avec texte indicatif optionnel.
Mixte
mixedCases à cocher et zone de texte combinées. Texte obligatoire ou optionnel.
Déroulement
De la question posée par l'agent à la reprise de son exécution.
Disjoncteur automatique
Mécanisme de protection qui bloque les questions quand l'utilisateur ne répond pas.