Sistema de clarificación de opción múltiple
Šiame puslapyje
Lección actualizada el 2 de noviembre de 2026. Los archivos de agente de ejemplo ahora usan 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 múltiples enfoques defendibles, el modelo puede presentar opciones antes de proceder: este es el sistema de clarificació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 maneras.
En modo programático (vibe --prompt …), Vibe desactiva las herramientas interactivas como ask_user_question: no hay nadie allí para responder. Un agente diseñado para ejecutarse sin supervisión debe, al igual que un subagente, encontrar opciones predeterminadas en sus instrucciones.
La primera 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 donde la respuesta no puede adivinarse: un nombre de tabla, un identificador, una ruta. Vibe espera entonces una respuesta de texto.
Vibe: ¿Cuál es el nombre de la tabla de la base de datos a 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 trabajo para desechar, Vibe te deja decidir. Observa la tercera opción, que evita idas y vueltas 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 una 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 librería)
4. Valibot (ligero, eliminable del árbol)
El tercero es una decisión de alto impacto. Una solicitud aparentemente mundana —“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ú: Actualizar 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 (verificación requerida)
Ajustando el agente cursor 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 clarificaciones
]
[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. 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; así que formula un umbral explícito para que solo te solicite en lo que realmente importa.
instructions = """
Reglas de clarificació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 predeterminada documentada en su mensaje, documentar esa elección en el resultado que devuelve y señalar la ambigüedad al agente principal, que luego puede preguntarte. Escribir estos valores predeterminados 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 predeterminadas:
- Framework de pruebas: Vitest
- Estilo de código: convenciones del proyecto (detectadas vía config)
- Formato de salida: Markdown
Documenta cada elección predeterminada en tu informe.
"""
En la práctica, reserva las clarificaciones 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 primero la elección que serviría como predeterminado razonable. El compromiso es simple de enunciar: menos preguntas generan más fluidez, pero aumentan el riesgo de una mala elección silenciosa.
Svarbiausi punktai
- Vibe usa
ask_user_questionpara solicitar clarificaciones con opciones múltiples o entrada de texto libre - El sistema se activa cuando la solicitud es ambigua o son posibles múltiples enfoques
- Incluye
ask_user_questionenenabled_toolspara habilitar las clarificaciones - Los subagentes no pueden hacer preguntas; deben ser autónomos
- Guía el comportamiento de clarificación a través del mensaje del sistema
- Menos preguntas = más fluidez, pero mayor riesgo de malas elecciones silenciosas