Sistema di chiarimento a scelta multipla
In questa pagina
Lezione aggiornata il 2 novembre 2026. I file degli agenti di esempio utilizzano ora le chiavi documentate da Vibe:
instructions(nonsystem_prompt),active_model(nonmodel), blocchi[tools.<tool>]per le approvazioni (la chiaveauto_approvenon esiste in un file agente) e nomi reali degli strumenti (edit, nonedit_file; nessuno strumentolist_dir). Promemoria dalla Lezione 3:safetyè un indicatore visivo, non un permesso. Fonte: Riferimento alla configurazione.
Quando Vibe chiede prima di agire
Mistral Vibe non è uno strumento che esegue ciecamente le tue istruzioni. Quando una richiesta è ambigua o sono possibili più approcci difendibili, il modello può presentare delle opzioni prima di procedere: questo è il sistema di chiarimento a scelta multipla. Il meccanismo si basa su uno strumento integrato, ask_user_question, disponibile per gli agenti ma non per i sotto-agenti, e funziona in due modi.
In modalità programmatica (vibe --prompt …), Vibe disabilita gli strumenti interattivi come ask_user_question: non c’è nessuno lì per rispondere. Un agente progettato per essere eseguito senza supervisione deve, come un sotto-agente, trovare scelte predefinite nelle sue istruzioni.
Il primo metodo è la scelta multipla: Vibe elenca opzioni numerate e tu rispondi con un numero o il testo dell’opzione. È veloce e inequivocabile, rendendolo il formato predefinito ogni volta che esiste un numero finito di risposte ragionevoli.
Vibe: Quale framework di test utilizzi?
1. Vitest
2. Jest
3. Mocha
4. Pytest
5. Altro (specificare)
Il secondo è l’input di testo libero, riservato alle domande in cui la risposta non può essere indovinata: un nome di tabella, un identificatore, un percorso. Vibe si aspetta quindi una risposta testuale.
Vibe: Qual è il nome della tabella del database da migrare?
> users_profiles
Le tre situazioni che attivano una domanda
Il primo innesco è la pura ambiguità. Chiedi di refattorizzare “il componente di login” quando il repository ne contiene due; invece di scommettere su uno e consegnarti un lavoro da buttare, Vibe ti lascia decidere. Nota la terza opzione, che evita il tira e molla quando la risposta è “entrambi”.
Tu: Refattorizza il componente di login
Vibe: Ho identificato due componenti relativi al login:
1. src/components/LoginForm.tsx (modulo)
2. src/components/LoginModal.tsx (modale)
Quale vuoi refattorizzare?
3. Entrambi
Il secondo innesco è una pluralità di approcci tecnici. Aggiungere la validazione a un modulo introduce una dipendenza che rimarrà nel progetto per anni; questo tipo di decisione spetta a te, non al modello.
Tu: Aggiungi la validazione al modulo
Vibe: Quale approccio di validazione preferisci?
1. Zod (validazione dello schema, tipizzazione TypeScript)
2. Yup (validazione dichiarativa, ecosistema Formik)
3. Validazione manuale (nessuna libreria)
4. Valibot (leggero, tree-shakable)
Il terzo è una decisione ad alto impatto. Una richiesta apparentemente banale come “aggiornare le dipendenze” può nascondere un cambiamento di versione principale. Vibe classifica quindi le opzioni dalla più sicura alla più rischiosa, dichiarando esplicitamente il livello di rischio di ciascuna.
Tu: Aggiorna le dipendenze
Vibe: L'aggiornamento di React da 18 a 19 è un cambiamento importante.
1. Aggiorna solo le patch (sicuro)
2. Aggiorna le versioni minori (basso rischio)
3. Aggiorna tutto, incluse le versioni principali (verifica richiesta)
Regolazione del cursore agente per agente
Questo comportamento non è automatico: dipende da ciò che autorizzi. Affinché un agente ti faccia delle domande, ask_user_question deve apparire nei suoi strumenti consentiti.
display_name = "Sviluppatore Attento"
safety = "neutral"
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep",
"ask_user_question" # Abilita i chiarimenti
]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Al contrario, un agente progettato per essere eseguito senza supervisione—in una pipeline, durante la notte, o semplicemente per lavori ripetitivi che non vuoi arbitrare—deve essere privato di questo strumento. Rimuovere ask_user_question non basta però: senza istruzioni di ripiego, l’agente si bloccherebbe o sceglierebbe a caso. Il prompt di sistema deve quindi dirgli cosa fare invece.
display_name = "Lavoratore Silenzioso"
safety = "neutral"
instructions = """
Non fare mai domande. In caso di ambiguità:
- Scegli l'opzione più conservativa
- Documenta la tua scelta in un commento
"""
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep"
# Nessun ask_user_question
]
[tools.read_file]
permission = "always"
[tools.write_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Tra il tutto e il niente, il prompt consente una messa a punto fine. Un agente che ti interrompe ogni due minuti per scegliere un nome di variabile è fastidioso quanto un agente silenzioso è rischioso; formula quindi una soglia esplicita in modo che ti solleciti solo su ciò che conta davvero.
instructions = """
Regole di chiarimento:
- Fai una domanda SOLO se la scelta influisce sull'architettura
- Per le decisioni estetiche, segui le convenzioni del progetto
- Proponi sempre un massimo di 3 opzioni
- Includi sempre un'opzione "Entrambi" o "Tutti" quando rilevante
"""
Il caso speciale dei sotto-agenti
Promemoria importante: i sotto-agenti non possono fare domande. Questo è un vincolo di progettazione, non una svista: un sotto-agente deve essere completamente autonomo. Quando incontra un’ambiguità, ha tre risorse: applicare l’opzione predefinita documentata nel suo prompt, documentare tale scelta nel risultato che restituisce e segnalare l’ambiguità all’agente principale, che potrà poi interrogarti. Scrivere questi valori predefiniti non è un lusso; è la condizione affinché un sotto-agente produca un risultato utilizzabile.
# Sotto-agente con ripiego chiaro
agent_type = "subagent"
instructions = """
In caso di ambiguità, applica queste regole predefinite:
- Framework di test: Vitest
- Stile del codice: convenzioni del progetto (rilevate tramite config)
- Formato di output: Markdown
Documenta ogni scelta predefinita nel tuo report.
"""
In pratica, riserva i chiarimenti alle decisioni che impegnano l’architettura o la sicurezza e lascia che l’agente decida da solo la formattazione o i nomi delle variabili temporanee. Attieniti a tre-cinque opzioni per evitare di trasformare ogni domanda in un modulo e posiziona sempre per prima la scelta che fungerebbe da predefinito ragionevole. Il compromesso è semplice da enunciare: meno domande significano maggiore fluidità, ma aumentano il rischio di una scelta errata silenziosa.
Punti chiave
- Vibe utilizza
ask_user_questionper richiedere chiarimenti con scelte multiple o input di testo libero - Il sistema si attiva quando la richiesta è ambigua o sono possibili più approcci
- Includi
ask_user_questioninenabled_toolsper abilitare i chiarimenti - I sotto-agenti non possono fare domande: devono essere autonomi
- Guida il comportamento di chiarimento tramite il prompt di sistema
- Meno domande = più fluidità, ma rischio più elevato di scelte errate silenziose