Système de clarification à choix multiples
På denna sida
Leçon mise à jour le 2 novembre 2026. Les fichiers d’agents d’exemple utilisent désormais les clés documentées par Vibe :
instructions(et nonsystem_prompt),active_model(et nonmodel), des blocs[tools.<tool>]pour les approbations (la cléauto_approven’existe pas dans un fichier d’agent), et les noms réels des outils (edit, et nonedit_file; pas d’outillist_dir). Rappel de la leçon 3 :safetyest un indicateur visuel, pas une permission. Source : Référence de configuration.
Quand Vibe demande avant d’agir
Mistral Vibe n’est pas un outil qui exécute aveuglément tes instructions. Lorsqu’une demande est ambiguë ou que plusieurs approches sont défendables, le modèle peut présenter des options avant de procéder : c’est le système de clarification à choix multiples. Ce mécanisme repose sur un outil intégré, ask_user_question, disponible pour les agents mais pas pour les sous-agents, et il fonctionne de deux manières.
En mode programmatique (vibe --prompt …), Vibe désactive les outils interactifs comme ask_user_question : personne n’est là pour répondre. Un agent conçu pour fonctionner sans surveillance doit, comme un sous-agent, trouver des choix par défaut dans ses instructions.
La première méthode est le choix multiple : Vibe liste des options numérotées et tu réponds par un numéro ou le texte de l’option. C’est rapide et sans ambiguïté, ce qui en fait le format par défaut chaque fois qu’un nombre fini de réponses raisonnables existe.
Vibe: Quel framework de test utilises-tu ?
1. Vitest
2. Jest
3. Mocha
4. Pytest
5. Autre (préciser)
La seconde est la saisie de texte libre, réservée aux questions où la réponse ne peut pas être devinée : un nom de table, un identifiant, un chemin. Vibe attend alors une réponse textuelle.
Vibe: Quel est le nom de la table de base de données à migrer ?
> users_profiles
Les trois situations qui déclenchent une question
Le premier déclencheur est l’ambiguïté pure. Tu demandes de refactoriser « le composant de connexion » alors que le dépôt en contient deux ; plutôt que de parier sur l’un et de te laisser un travail à jeter, Vibe te laisse décider. Remarque la troisième option, qui évite les allers-retours lorsque la réponse est « les deux ».
Toi: Refactorise le composant de connexion
Vibe: J'ai identifié deux composants liés à la connexion :
1. src/components/LoginForm.tsx (formulaire)
2. src/components/LoginModal.tsx (modale)
Lequel veux-tu refactoriser ?
3. Les deux
Le deuxième déclencheur est une pluralité d’approches techniques. Ajouter une validation à un formulaire introduit une dépendance qui restera dans le projet pendant des années ; ce genre de décision t’appartient, pas au modèle.
Toi: Ajoute une validation au formulaire
Vibe: Quelle approche de validation préfères-tu ?
1. Zod (validation de schéma, typage TypeScript)
2. Yup (validation déclarative, écosystème Formik)
3. Validation manuelle (aucune bibliothèque)
4. Valibot (léger, éliminable par arbre)
Le troisième est une décision à fort impact. Une demande apparemment banale — « mettre à jour les dépendances » — peut cacher un changement de version majeure. Vibe classe alors les options du plus sûr au plus risqué, en indiquant explicitement le niveau de risque de chacune.
Toi: Mettre à jour les dépendances
Vibe: La mise à jour de React 18 vers 19 est un changement majeur.
1. Mettre à jour uniquement les correctifs (sûr)
2. Mettre à jour les versions mineures (faible risque)
3. Tout mettre à jour, y compris les versions majeures (vérification requise)
Ajuster le comportement agent par agent
Ce comportement n’est pas automatique : il dépend de ce que tu autorises. Pour qu’un agent te pose des questions, ask_user_question doit figurer dans ses outils autorisés.
display_name = "Développeur prudent"
safety = "neutral"
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep",
"ask_user_question" # Active les clarifications
]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
À l’inverse, un agent conçu pour fonctionner sans supervision — dans un pipeline, la nuit, ou simplement pour un travail répétitif que tu ne veux pas arbitrer — doit être privé de cet outil. Retirer ask_user_question ne suffit cependant pas : sans instructions de repli, l’agent se bloquerait ou choisirait au hasard. L’instruction système doit donc lui indiquer quoi faire à la place.
display_name = "Travailleur silencieux"
safety = "neutral"
instructions = """
Ne pose jamais de questions. En cas d'ambiguïté :
- Choisis l'option la plus conservative
- Documente ton choix dans un commentaire
"""
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep"
# Pas de ask_user_question
]
[tools.read_file]
permission = "always"
[tools.write_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Entre le tout et le rien, l’instruction permet un réglage fin. Un agent qui t’interrompt toutes les deux minutes pour choisir un nom de variable est aussi agaçant qu’un agent silencieux est risqué ; formule donc un seuil explicite pour qu’il ne te sollicite que sur ce qui compte vraiment.
instructions = """
Règles de clarification :
- Pose une question UNIQUEMENT si le choix affecte l'architecture
- Pour les décisions cosmétiques, suis les conventions du projet
- Propose toujours un maximum de 3 options
- Inclus toujours une option « Les deux » ou « Tous » lorsque c'est pertinent
"""
Le cas particulier des sous-agents
Rappel important : les sous-agents ne peuvent pas poser de questions. C’est une contrainte de conception, pas un oubli : un sous-agent doit être totalement autonome. Lorsqu’il rencontre une ambiguïté, il a trois recours : appliquer l’option par défaut documentée dans son instruction, documenter ce choix dans le résultat qu’il renvoie, et signaler l’ambiguïté à l’agent principal, qui pourra alors t’interroger. Rédiger ces valeurs par défaut n’est pas un luxe ; c’est la condition pour qu’un sous-agent produise un résultat utilisable.
# Sous-agent avec repli clair
agent_type = "subagent"
instructions = """
En cas d'ambiguïté, applique ces règles par défaut :
- Framework de test : Vitest
- Style de code : conventions du projet (détectées via la config)
- Format de sortie : Markdown
Documente chaque choix par défaut dans ton rapport.
"""
En pratique, réserve les clarifications aux décisions qui engagent l’architecture ou la sécurité, et laisse l’agent décider seul du formatage ou des noms de variables temporaires. Limite-toi à trois à cinq options pour éviter de transformer chaque question en formulaire, et place toujours en premier le choix qui servirait de raisonnable par défaut. Le compromis est simple à énoncer : moins de questions offrent plus de fluidité, mais augmentent le risque d’un mauvais choix silencieux.
Viktiga punkter
- Vibe utilise
ask_user_questionpour demander des clarifications avec des choix multiples ou une saisie de texte libre - Le système s’active lorsque la demande est ambiguë ou que plusieurs approches sont possibles
- Inclus
ask_user_questiondansenabled_toolspour activer les clarifications - Les sous-agents ne peuvent pas poser de questions — ils doivent être autonomes
- Guide le comportement de clarification via l’instruction système
- Moins de questions = plus de fluidité, mais risque plus élevé de mauvais choix silencieux