Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Sistema di chiarimento a scelta multipla

Lezione 10 di 14 Aggiornata il 2 novembre 2026 Avanzato
In questa pagina
  1. Quando Vibe chiede prima di agire
  2. Le tre situazioni che attivano una domanda
  3. Regolazione del cursore agente per agente
  4. Il caso speciale dei sotto-agenti
  5. Punti chiave

Lezione aggiornata il 2 novembre 2026. I file degli agenti di esempio utilizzano ora le chiavi documentate da Vibe: instructions (non system_prompt), active_model (non model), blocchi [tools.<tool>] per le approvazioni (la chiave auto_approve non esiste in un file agente) e nomi reali degli strumenti (edit, non edit_file; nessuno strumento list_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_question per 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_question in enabled_tools per 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