Sistema de esclarecimento de múltipla escolha
Nesta página
Lição atualizada em 2 de novembro de 2026. Os ficheiros de agente de exemplo utilizam agora as chaves documentadas pela Vibe:
instructions(e nãosystem_prompt),active_model(e nãomodel), blocos[tools.<tool>]para aprovações (a chaveauto_approvenão existe num ficheiro de agente) e nomes reais de ferramentas (edit, e nãoedit_file; sem ferramentalist_dir). Lembrete da Lição 3:safetyé um indicador visual, não uma permissão. Fonte: Referência de configuração.
Quando a Vibe pergunta antes de agir
O Mistral Vibe não é uma ferramenta que executa cegamente as suas instruções. Quando um pedido é ambíguo ou existem várias abordagens defensáveis, o modelo pode apresentar opções antes de prosseguir: este é o sistema de esclarecimento de múltipla escolha. O mecanismo baseia-se numa ferramenta integrada, ask_user_question, disponível para agentes, mas não para subagentes, e funciona de duas formas.
No modo programático (vibe --prompt …), a Vibe desativa ferramentas interativas como ask_user_question: não há ninguém para responder. Um agente concebido para funcionar sem supervisão deve, tal como um subagente, encontrar escolhas padrão nas suas instruções.
A primeira forma é a múltipla escolha: a Vibe lista opções numeradas e o utilizador responde com um número ou o texto da opção. É rápido e inequívoco, tornando-se o formato padrão sempre que existe um número finito de respostas razoáveis.
Vibe: Qual framework de testes utiliza?
1. Vitest
2. Jest
3. Mocha
4. Pytest
5. Outro (especifique)
A segunda é a entrada de texto livre, reservada a perguntas onde a resposta não pode ser adivinhada: um nome de tabela, um identificador, um caminho. A Vibe espera então uma resposta em texto.
Vibe: Qual é o nome da tabela da base de dados a migrar?
> users_profiles
As três situações que desencadeiam uma pergunta
O primeiro gatilho é a ambiguidade pura. Pede para refatorar “o componente de login” quando o repositório contém dois; em vez de apostar num e entregar-lhe trabalho para deitar fora, a Vibe deixa-o decidir. Repare na terceira opção, que evita idas e voltas quando a resposta é “ambos”.
Você: Refatora o componente de login
Vibe: Identifiquei dois componentes relacionados com o login:
1. src/components/LoginForm.tsx (formulário)
2. src/components/LoginModal.tsx (modal)
Qual deles deseja refatorar?
3. Ambos
O segundo gatilho é uma pluralidade de abordagens técnicas. Adicionar validação a um formulário introduz uma dependência que permanecerá no projeto durante anos; este tipo de decisão pertence-lhe, não ao modelo.
Você: Adiciona validação ao formulário
Vibe: Qual abordagem de validação prefere?
1. Zod (validação de esquema, tipagem TypeScript)
2. Yup (validação declarativa, ecossistema Formik)
3. Validação manual (sem biblioteca)
4. Valibot (leve, tree-shakable)
O terceiro é uma decisão de alto impacto. Um pedido aparentemente banal — “atualizar dependências” — pode esconder uma mudança de versão principal. A Vibe classifica então as opções da mais segura para a mais arriscada, indicando explicitamente o nível de risco de cada uma.
Você: Atualiza as dependências
Vibe: Atualizar o React 18 → 19 é uma alteração importante.
1. Atualizar apenas correções (seguro)
2. Atualizar versões menores (baixo risco)
3. Atualizar tudo, incluindo versões principais (verificação necessária)
Ajustar o agente cursor, agente por agente
Este comportamento não é automático: depende do que autoriza. Para que um agente lhe faça perguntas, ask_user_question deve constar nas suas ferramentas permitidas.
display_name = "Desenvolvedor Cuidadoso"
safety = "neutral"
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep",
"ask_user_question" # Ativa os esclarecimentos
]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Pelo contrário, um agente concebido para funcionar sem supervisão — num pipeline, durante a noite, ou simplesmente para trabalho repetitivo que não deseja arbitrar — deve ser privado desta ferramenta. Remover ask_user_question não é suficiente, contudo: sem instruções de fallback, o agente ficaria bloqueado ou escolheria ao acaso. O prompt do sistema deve, portanto, indicar-lhe o que fazer em alternativa.
display_name = "Trabalhador Silencioso"
safety = "neutral"
instructions = """
Nunca faças perguntas. Em caso de ambiguidade:
- Escolhe a opção mais conservadora
- Documenta a tua escolha num comentário
"""
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep"
# Sem ask_user_question
]
[tools.read_file]
permission = "always"
[tools.write_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Entre o tudo e o nada, o prompt permite um ajuste fino. Um agente que o interrompe a cada dois minutos para escolher um nome de variável é tão irritante quanto um agente silencioso é arriscado; formule, portanto, um limiar explícito para que só o solicite no que realmente importa.
instructions = """
Regras de esclarecimento:
- Faz uma pergunta APENAS se a escolha afetar a arquitetura
- Para decisões cosméticas, segue as convenções do projeto
- Propõe sempre um máximo de 3 opções
- Inclui sempre uma opção "Ambos" ou "Todos" quando relevante
"""
O caso especial dos subagentes
Lembrete importante: os subagentes não podem fazer perguntas. Esta é uma restrição de design, não um esquecimento — um subagente deve ser totalmente autónomo. Quando encontra ambiguidade, tem três recursos: aplicar a opção padrão documentada no seu prompt, documentar essa escolha no resultado que devolve e sinalizar a ambiguidade ao agente principal, que poderá então questioná-lo. Escrever estes valores padrão não é um luxo; é a condição para um subagente produzir um resultado utilizável.
# Subagente com fallback claro
agent_type = "subagent"
instructions = """
Em caso de ambiguidade, aplica estas regras padrão:
- Framework de testes: Vitest
- Estilo de código: convenções do projeto (detetadas via config)
- Formato de saída: Markdown
Documenta cada escolha padrão no teu relatório.
"""
Na prática, reserve os esclarecimentos para decisões que comprometam a arquitetura ou a segurança, e deixe o agente decidir a formatação ou nomes de variáveis temporárias por si próprio. Limite-se a três a cinco opções para evitar transformar cada pergunta num formulário e coloque sempre a escolha que serviria de padrão razoável em primeiro lugar. O compromisso é simples de enunciar: menos perguntas geram mais fluidez, mas aumentam o risco de uma má escolha silenciosa.
Pontos-chave
- A Vibe utiliza
ask_user_questionpara solicitar esclarecimentos com múltiplas escolhas ou entrada de texto livre - O sistema ativa-se quando o pedido é ambíguo ou são possíveis várias abordagens
- Inclua
ask_user_questionemenabled_toolspara ativar os esclarecimentos - Os subagentes não podem fazer perguntas — devem ser autónomos
- Oriente o comportamento de esclarecimento através do prompt do sistema
- Menos perguntas = mais fluidez, mas maior risco de más escolhas silenciosas