Sistema de aclaración de opción múltiple
En esta página
Lección actualizada el 2 de noviembre de 2026. Los archivos de agente de ejemplo usan ahora las claves documentadas por Vibe:
instructions(nosystem_prompt),active_model(nomodel), bloques[tools.<tool>]para aprobaciones (la claveauto_approveno existe en un archivo de agente) y nombres reales de herramientas (edit, noedit_file; sin herramientalist_dir). Recordatorio de la Lección 3:safetyes un indicador visual, no un permiso. Fuente: Referencia de configuración.
Cuándo Vibe pregunta antes de actuar
Mistral Vibe no es una herramienta que ejecute ciegamente tus instrucciones. Cuando una solicitud es ambigua o existen varios enfoques defendibles, el modelo puede presentar opciones antes de proceder: este es el sistema de aclaración de opción múltiple. El mecanismo se basa en una herramienta integrada, ask_user_question, disponible para los agentes pero no para los subagentes, y funciona de dos formas.
En modo programático (vibe --prompt …), Vibe desactiva las herramientas interactivas como ask_user_question: no hay nadie para responder. Un agente diseñado para ejecutarse sin supervisión debe, al igual que un subagente, encontrar opciones por defecto en sus instrucciones.
La primera forma es la opción múltiple: Vibe enumera opciones numeradas y tú respondes con un número o el texto de la opción. Es rápido y no deja lugar a dudas, por lo que es el formato predeterminado siempre que exista un número finito de respuestas razonables.
Vibe: ¿Qué framework de pruebas usas?
1. Vitest
2. Jest
3. Mocha
4. Pytest
5. Otro (especificar)
La segunda es la entrada de texto libre, reservada para preguntas cuya respuesta no se puede adivinar: un nombre de tabla, un identificador, una ruta. Vibe espera entonces una respuesta en texto.
Vibe: ¿Cuál es el nombre de la tabla de la base de datos que hay que migrar?
> users_profiles
Las tres situaciones que activan una pregunta
El primer desencadenante es la ambigüedad pura. Pides refactorizar «el componente de inicio de sesión» cuando el repositorio contiene dos; en lugar de apostar por uno y entregarte un trabajo que tendrás que desechar, Vibe te deja decidir. Observa la tercera opción, que evita idas y venidas cuando la respuesta es «ambos».
Tú: Refactoriza el componente de inicio de sesión
Vibe: He identificado dos componentes relacionados con el inicio de sesión:
1. src/components/LoginForm.tsx (formulario)
2. src/components/LoginModal.tsx (modal)
¿Cuál quieres refactorizar?
3. Ambos
El segundo desencadenante es la pluralidad de enfoques técnicos. Añadir validación a un formulario introduce una dependencia que permanecerá en el proyecto durante años; este tipo de decisión te corresponde a ti, no al modelo.
Tú: Añade validación al formulario
Vibe: ¿Qué enfoque de validación prefieres?
1. Zod (validación de esquemas, tipado TypeScript)
2. Yup (validación declarativa, ecosistema Formik)
3. Validación manual (sin biblioteca)
4. Valibot (ligero, susceptible de tree-shaking)
El tercero es una decisión de alto impacto. Una solicitud aparentemente trivial —«actualizar dependencias»— puede ocultar un cambio de versión mayor. Vibe clasifica entonces las opciones de la más segura a la más arriesgada, indicando explícitamente el nivel de riesgo de cada una.
Tú: Actualiza las dependencias
Vibe: Actualizar React 18 → 19 es un cambio mayor.
1. Actualizar solo parches (seguro)
2. Actualizar versiones menores (bajo riesgo)
3. Actualizar todo, incluidas las versiones mayores (requiere verificación)
Ajuste del agente cursor agente por agente
Este comportamiento no es automático: depende de lo que autorices. Para que un agente te haga preguntas, ask_user_question debe aparecer en sus herramientas permitidas.
display_name = "Desarrollador cuidadoso"
safety = "neutral"
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep",
"ask_user_question" # Habilita las aclaraciones
]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Por el contrario, un agente diseñado para ejecutarse sin supervisión —en una tubería, durante la noche o simplemente para trabajos repetitivos que no quieres arbitrar— debe carecer de esta herramienta. Sin embargo, eliminar ask_user_question no es suficiente: sin instrucciones de respaldo, el agente se bloquearía o elegiría al azar. Por tanto, el mensaje del sistema debe indicarle qué hacer en su lugar.
display_name = "Trabajador silencioso"
safety = "neutral"
instructions = """
Nunca hagas preguntas. En caso de ambigüedad:
- Elige la opción más conservadora
- Documenta tu elección en un comentario
"""
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep"
# Sin ask_user_question
]
[tools.read_file]
permission = "always"
[tools.write_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Entre el todo y la nada, el mensaje permite un ajuste fino. Un agente que te interrumpe cada dos minutos para elegir un nombre de variable es tan molesto como riesgoso es un agente silencioso; por tanto, formula un umbral explícito para que solo te solicite ayuda en lo que realmente importa.
instructions = """
Reglas de aclaración:
- Haz una pregunta SOLO si la elección afecta a la arquitectura
- Para decisiones cosméticas, sigue las convenciones del proyecto
- Propón siempre un máximo de 3 opciones
- Incluye siempre una opción "Ambos" o "Todos" cuando sea relevante
"""
El caso especial de los subagentes
Recordatorio importante: los subagentes no pueden hacer preguntas. Esta es una restricción de diseño, no un descuido; un subagente debe ser totalmente autónomo. Cuando se encuentra con ambigüedad, tiene tres recursos: aplicar la opción por defecto documentada en su mensaje, documentar esa elección en el resultado que devuelve y señalar la ambigüedad al agente principal, que podrá entonces preguntarte a ti. Escribir estos valores por defecto no es un lujo; es la condición para que un subagente produzca un resultado utilizable.
# Subagente con respaldo claro
agent_type = "subagent"
instructions = """
En caso de ambigüedad, aplica estas reglas por defecto:
- Framework de pruebas: Vitest
- Estilo de código: convenciones del proyecto (detectadas vía config)
- Formato de salida: Markdown
Documenta cada elección por defecto en tu informe.
"""
En la práctica, reserva las aclaraciones para decisiones que comprometan la arquitectura o la seguridad, y deja que el agente decida por sí mismo el formato o los nombres de variables temporales. Limítate a tres a cinco opciones para evitar convertir cada pregunta en un formulario, y coloca siempre en primer lugar la elección que serviría como valor por defecto razonable. La compensación es sencilla de enunciar: menos preguntas aportan más fluidez, pero aumentan el riesgo de una elección errónea silenciosa.
Puntos clave
- Vibe usa
ask_user_questionpara solicitar aclaraciones con opciones múltiples o entrada de texto libre - El sistema se activa cuando la solicitud es ambigua o son posibles varios enfoques
- Incluye
ask_user_questionenenabled_toolspara habilitar las aclaraciones - Los subagentes no pueden hacer preguntas; deben ser autónomos
- Guía el comportamiento de aclaración mediante el mensaje del sistema
- Menos preguntas = más fluidez, pero mayor riesgo de elecciones erróneas silenciosas