Perché funzionano 2-4 esempi
Sono sufficienti per definire uno schema, ma abbastanza pochi da restare generali.
Perché funzionano 2-4 esempi è una lezione Claude Architect gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Claude Architect, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Claude Architect include 4 lezioni in totale.
L'idea fondamentale
Il prompting few-shot funziona perché Claude generalizza a partire dagli esempi: non si limita a memorizzarli e ripeterli. La scheda riassuntiva è precisa sulla quantità: utilizzi 2-4 esempi mirati per ogni ambiguità.
Questo intervallo non è arbitrario. È sufficiente per impostare uno schema, ma abbastanza ristretto da permettere al modello di generalizzare. Questa lezione spiega perché questo punto ottimale è valido nel lavoro di produzione.
Gli esempi insegnano una regola, non una tabella di corrispondenza
Quando mostra a Claude 2-4 esempi, sta dimostrando una regola: questa forma di input corrisponde a quella forma di output. Il modello deduce lo schema sottostante e lo applica a input nuovi e mai visti.
Per questo il few-shot è lo strumento di riferimento per coerenza, casi limite, formato dell'output e riduzione delle allucinazioni: sono tutti ambiti in cui un'istruzione vaga lascia troppo spazio a variazioni.
system = (
"Classify each support message as: billing, technical, or other.\n"
"Examples:\n"
"Message: 'My card was charged twice' -> billing\n"
"Message: 'The app crashes on login' -> technical\n"
"Message: 'Do you have a dark mode?' -> other"
)
# 3 examples set the mapping rule; Claude generalizes to new messages.Perché non zero esempi?
Lo zero-shot si basa interamente sulla formulazione delle istruzioni. Per i compiti realmente ambigui, le sole parole non definiscono con sufficiente precisione il confine. La scheda riassuntiva sottolinea che i criteri espliciti sono migliori delle indicazioni vaghe; tuttavia, anche criteri precisi a volte hanno bisogno di una dimostrazione concreta per essere fissati.
Un esempio scelto bene risolve un'ambiguità che un paragrafo di prosa non riuscirebbe a chiarire. Questo rappresenta il limite inferiore dell'intervallo 2-4: almeno un paio di dimostrazioni per ogni decisione ambigua.
Perché non un solo esempio?
Un solo esempio è rischioso: il modello potrebbe adattarsi eccessivamente alle sue caratteristiche superficiali, come una formulazione o una lunghezza specifica, oppure a un dettaglio casuale, considerandolo parte della regola.
Un secondo e un terzo esempio permettono a Claude di triangolare ciò che varia davvero rispetto a ciò che rimane costante. La struttura condivisa diventa il segnale; le differenze accidentali diventano rumore da ignorare.
# One example: model may copy the exact tone/length.
# Two+ examples reveal what is INVARIANT (the JSON shape)
# versus INCIDENTAL (the specific values).
examples = [
{"review": "Loved it, fast shipping!", "out": {"sentiment": "positive"}},
{"review": "Broke after a day.", "out": {"sentiment": "negative"}},
]
# The constant is the {"sentiment": ...} schema, not the wording.Perché non 20 esempi?
Se pochi esempi sono utili, perché non riempire il prompt? Per due motivi.
- Eccessiva specializzazione: con troppi esempi, Claude potrebbe iniziare a rispecchiarne lo stile esatto e smettere di generalizzare; si restringerebbe al set di addestramento invece di apprendere la regola.
- Costo del contesto: blocchi lunghi di esempi consumano la finestra di contesto e peggiorano il fenomeno lost-in-the-middle, per cui il modello presta meno attenzione ai contenuti sepolti nel mezzo.
2-4 esempi mantengono nitida la dimostrazione e snello il prompt.
Rimanga generale: copra la decisione, non ogni caso
L'obiettivo del few-shot è definire uno schema, non enumerare ogni possibilità. Se si accorge di aggiungere un decimo esempio per gestire un altro caso, è un segnale: probabilmente il compito ha bisogno di criteri più chiari o di uno schema di output strutturato, non di altri esempi.
Esempi in contrasto tra loro o accumulati senza criterio confondono la regola e diluiscono l'attenzione. Si assicuri che ogni dimostrazione abbia una funzione precisa.
Un set per ogni ambiguità
Legga attentamente la formulazione della scheda riassuntiva: 2-4 esempi per ogni ambiguità. Il budget si applica a ogni distinto punto di confusione, non all'intero prompt.
Se un'attività presenta due decisioni ambigue separate, ad esempio come classificare e come formattare la data, fornisca un piccolo set mirato per ciascuna. Non è limitato a quattro esempi complessivi; il limite riguarda un numero ridotto e mirato per ogni decisione da disambiguare.
# Ambiguity 1: category boundary (3 examples)
# Ambiguity 2: date normalization (2 examples)
# Each ambiguity gets its own small, targeted set.
prompt = f"""
Category examples:
'refund my order' -> billing
'page is blank' -> technical
'how do I export' -> other
Date examples:
'next Tuesday' -> 2026-06-16
'06/10' -> 2026-06-10
Now process: {user_message}
"""Scelga esempi che segnino il confine
La qualità conta più della quantità. Due esempi collocati esattamente sul confine decisionale insegnano più di dieci esempi ovvi. Scelga casi facili da classificare erroneamente: il quasi-caso, il caso limite, l'input che sembra appartenere a una categoria ma in realtà appartiene a un'altra.
È proprio per questo che la scheda riassuntiva collega il few-shot ai casi limite: un paio di coppie contrastive ben posizionate definiscono la regola molto meglio di una massa di esempi centrali e privi di ambiguità.
Few-shot e output strutturato
Per la forma dell'output, abbini un paio di esempi a uno schema JSON tramite tool_use. Lo schema impone i campi obbligatori ed elimina gli errori di sintassi; i 2-4 esempi insegnano il giudizio che lo schema non può esprimere: quale valore inserire in quale campo quando l'input è complesso.
Ricordi la regola dello schema: contrassegni un campo come obbligatorio solo se è sempre presente. Non renda mai obbligatorio un campo che potrebbe essere assente, altrimenti il modello ne inventerà uno.
tools = [{
"name": "record_ticket",
"description": "Save a classified support ticket.",
"input_schema": {
"type": "object",
"properties": {
"category": {"enum": ["billing", "technical", "other"]},
"priority": {"enum": ["low", "high"]},
},
"required": ["category"], # priority may be absent -> not required
},
}]
# tool_choice="any" guarantees a structured call; examples teach the judgment.Few-shot e nuovo tentativo con feedback
Non confonda i due concetti. Il few-shot imposta lo schema in anticipo, affinché la prima risposta sia corretta. Il nuovo tentativo con feedback corregge una risposta specifica errata dopo che è stata prodotta, inviando nuovamente l'input originale, l'output errato e l'errore di validazione preciso.
Aggiungere altri esempi non risolverà un errore dovuto a informazioni mancanti; neppure un nuovo tentativo può recuperare informazioni semplicemente assenti dalla fonte. Utilizzi gli esempi per definire il comportamento e i nuovi tentativi per correggere errori di formato o di aritmetica.
Una procedura pratica
Per qualsiasi prompt ambiguo:
- Scriva prima i criteri espliciti (le istruzioni vaghe sono la base debole).
- Aggiunga 2-4 esempi per ogni ambiguità rimanente, scelti sul confine decisionale.
- Utilizzi uno schema quando il problema riguarda la forma dell'output, non il giudizio.
- Se continua ad aggiungere esempi, si fermi: corregga invece i criteri o lo schema.
Quanto basta per definire uno schema, ma abbastanza poco da mantenere la generalità.
system = """Flag a code comment ONLY when it contradicts the code.
Examples:
Code: x = a + b Comment: 'subtract b' -> FLAG (contradicts)
Code: x = a + b Comment: 'sum a and b' -> OK
Code: retry(3) Comment: 'retry twice' -> FLAG (count wrong)
"""
# Explicit criterion + 3 boundary examples = consistent, general behavior.Punto di controllo: scegliere il numero di esempi
Domanda dello scenario: scelga la risposta migliore.
Riepilogo
Punti chiave:
- 2-4 esempi per ogni ambiguità rappresentano il punto ottimale: Claude generalizza a partire da essi, non si limita a ripeterli.
- Troppo pochi (0-1) lasciano la specifica insufficiente o inducono un adattamento eccessivo ai dettagli superficiali; troppi causano un'eccessiva specializzazione e sprecano contesto, riducendo l'attenzione verso la parte centrale.
- Scelga esempi sul confine decisionale: la qualità conta più della quantità.
- Abbini gli esempi a criteri espliciti e, per la forma dell'output, a uno schema JSON; non renda mai obbligatorio un campo che potrebbe essere assente.
- Se continua ad aggiungere esempi, corregga invece i criteri o lo schema.
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 26
- Lezioni
- 104
Domande Frequenti
La lezione «Perché funzionano 2-4 esempi» è gratuita?
Sì — il testo completo di «Perché funzionano 2-4 esempi» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Claude Architect, passa a CoddyKit PRO. Il corso Claude Architect include 4 lezioni in totale.
Cosa imparerò in «Perché funzionano 2-4 esempi»?
Sono sufficienti per definire uno schema, ma abbastanza pochi da restare generali. Eserciti Claude Architect con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Claude Architect?
Non è richiesta alcuna esperienza precedente. Claude Architect su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.
Quanto tempo richiede la lezione «Perché funzionano 2-4 esempi»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Claude Architect?
Sì. Ogni lezione Claude Architect include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Perché funzionano 2-4 esempi
- Esempi per formato e casi limite
- Generalizzazione vs ripetizione
- Few-shot per ridurre le allucinazioni