Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Sistema de esclarecimento de múltipla escolha

Aula 10 de 14 Atualizada a 2 de novembro de 2026 Avancado
Nesta página
  1. Quando a Vibe pergunta antes de agir
  2. As três situações que desencadeiam uma pergunta
  3. Ajustar o agente cursor, agente por agente
  4. O caso especial dos subagentes
  5. Pontos-chave

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ão system_prompt), active_model (e não model), blocos [tools.<tool>] para aprovações (a chave auto_approve não existe num ficheiro de agente) e nomes reais de ferramentas (edit, e não edit_file; sem ferramenta list_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_question para 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_question em enabled_tools para 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