Aggiungere dettagli concreti
Numeri, nomi, formati ed esempi che ancorano l'output dell'IA
Aggiungere dettagli concreti è una lezione AI Prompt Engineering gratuita su CoddyKit. Questa è la lezione 3 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 AI Prompt Engineering, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso AI Prompt Engineering include 4 lezioni in totale.
I dettagli concreti sono ancoraggi
I dettagli concreti sono informazioni specifiche, misurabili e verificabili. Ancorano l'output del modello alla situazione reale invece di lasciarlo a un'interpretazione generica.
Senza ancoraggi, il modello genera contenuti per l'utente medio immaginario. Con gli ancoraggi, genera contenuti per Lei.
Il conteggio delle parole come vincolo concreto
Il conteggio delle parole è uno dei dettagli concreti più semplici ed efficaci che si possano aggiungere. Confronti:
- Vago: «Scriva una breve descrizione»
- Concreto: «Scriva una descrizione di 75 parole»
Il modello conterà i token e cercherà di raggiungere il valore obiettivo. Se lo manca di poco, può chiedere un conteggio preciso. Il conteggio delle parole elimina intere categorie di riscritture.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
'After the description, output the word count in parentheses on a new line.'
)
}]
)
print(response.content[0].text)Il pubblico destinatario come dettaglio concreto
Indicare un pubblico specifico e concreto modifica radicalmente il vocabolario, gli esempi e il livello di approfondimento dell'output.
- Vago: «Spieghi le reti neurali»
- Concreto: «Spieghi le reti neurali a un responsabile marketing di un'azienda Fortune 500 che non ha competenze di programmazione, ma sa usare le tabelle pivot di Excel»
Il secondo prompt fornisce al modello un'immagine mentale di un lettore reale e gli consente di calibrare perfettamente la complessità.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
concrete_audience_prompt = (
'Explain what a REST API is.\n\n'
'Audience: a non-technical product manager who uses Salesforce daily '
'and understands the concept of a form submission on a website. '
'They will use this explanation to brief their engineering team tomorrow. '
'Use one real-world analogy. Max 100 words.'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)Entità nominate invece di generalizzazioni
L'uso di entità nominate — nomi reali di prodotti, aziende, persone e tecnologie, oltre a date — costringe il modello ad abbandonare il terreno generico.
- Vago: «Scriva un'analisi della concorrenza»
- Concreto: «Scriva un'analisi della concorrenza tra Notion, Obsidian e Roam Research per un utente esperto che gestisce un team remoto di 10 persone, scrive ogni giorno e ha bisogno di lavorare offline»
Le entità nominate ancorano il modello alle conoscenze del mondo reale acquisite durante l'addestramento.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Compare FastAPI vs Flask vs Django REST Framework '
'for building a production API that will serve a React frontend. '
'Context: 2-person startup team, Python 3.11, needs async support, '
'expects < 50 ms response time, and will deploy on AWS Lambda. '
'Format: 3-column markdown table with rows: setup complexity, '
'async support, performance, learning curve, community size.'
)
}]
)
print(response.content[0].text)Vincoli quantitativi
I numeri non sono ambigui. Ogni volta che ha un requisito numerico, lo inserisca nel prompt:
- Elencare esattamente N elementi (non «alcuni» o «diversi»)
- Numero massimo / minimo di parole o caratteri
- Percentuali o rapporti specifici («70% pratico, 30% teorico»)
- Vincoli temporali («lo spieghi come se avessi 3 minuti per leggerlo»)
- Obiettivi prestazionali («suggerisca approcci che raggiungano una complessità temporale O(n)»)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
'Requirements:\n'
'- Exactly 8 lines, no more, no fewer\n'
'- Each subject line between 40 and 60 characters\n'
'- 4 must emphasize value, 4 must create urgency\n'
'- Label each line: [VALUE] or [URGENCY]\n'
'- No emojis\n'
'- No duplicate words across all 8 lines'
)
}]
)
print(response.choices[0].message.content)Inquadrare il contenuto in base a scadenze e tempi
Fornire un contesto temporale modifica il livello di approfondimento e il focus degli output. Dica al modello quando verrà utilizzato il contenuto e quali vincoli ne derivano:
- «Questa email verrà inviata tra 2 ore: la mantenga breve»
- «È per una presentazione al consiglio di amministrazione di lunedì: utilizzi un linguaggio adatto ai dirigenti»
- «Questa spiegazione deve essere adatta a uno stand-up di 5 minuti»
- «Scriva questo contenuto per un team che ha 10 minuti per esaminarlo prima della chiamata con il cliente»
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=256,
messages=[{
'role': 'user',
'content': (
'Write a project status update for our AI chatbot project. '
'This will be read aloud at a 5-minute Monday morning stand-up. '
'The audience has zero technical background. '
'Talking time: max 2 minutes (approximately 300 words). '
'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
'Tone: confident and factual. No jargon.'
)
}]
)
print(response.content[0].text)Esempi specifici nel prompt
Includere esempi specifici di ciò che si desidera o di ciò che non si desidera è una delle tecniche più efficaci. Gli esempi insegnano contemporaneamente formato, voce e stile.
È possibile includere:
- Un esempio dell'output ideale (one-shot)
- Più esempi con etichette (few-shot)
- Un esempio di ciò che in precedenza non ha funzionato (esempio negativo)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prompt = '''
Write 3 feature announcement tweets for a new developer tool.
Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find
what broke. Your flow stays unbroken. Try it now: [link]"
Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.
New feature: autocomplete that learns from your codebase.
'''
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)Vocabolario specifico del dominio
Includere termini specifici del dominio segnala al modello il livello di competenza atteso nell'output.
- 'Spiega il caching' → risposta generica
- 'Spiega la policy di eviction LRU di Redis per un backend engineer che sta migrando da Memcached a Redis 7.x' → risposta di livello esperto, ancorata al dominio
Usi nel prompt il vocabolario del proprio settore e il modello lo riprenderà nell'output.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'
domain_anchored = (
'Compare write-through, write-behind, and cache-aside patterns '
'for a microservices architecture using Redis 7.x as the cache layer and '
'PostgreSQL 15 as the source of truth. '
'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
'Audience: senior backend engineers familiar with CAP theorem.'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)Vincoli su ciò che va escluso
Vincoli negativi concreti (esclusioni) impediscono al modello di ricorrere a risposte prevedibili e generiche:
- 'Non suggerire soluzioni che richiedano una chiave API a pagamento'
- 'Non menzionare i concorrenti per nome'
- 'Non usare la parola leverage o synergy'
- 'Non includere contenuti teorici — solo contenuti pratici'
- 'Escludi gli approcci che richiedono più di 5 minuti per essere implementati'
Ogni regola di esclusione rende l'output più preciso, eliminando un'ulteriore possibilità di generare contenuti generici.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Suggest 5 ways to speed up a slow Python script. '
'EXCLUDE:\n'
'- Suggestions requiring third-party libraries (stdlib only)\n'
'- Suggestions about hardware upgrades\n'
'- Rewrites of the entire script\n'
'- Suggestions that take more than 30 minutes to implement\n'
'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
)
}]
)
print(response.choices[0].message.content)Mettere tutto insieme
Costruiamo passo dopo passo un prompt completamente concreto, partendo da: 'Scrivi una descrizione di lavoro.'
- Aggiungere il ruolo: 'Per un Senior ML Engineer'
- Aggiungere un'entità denominata: 'presso una startup di IA di serie B a Londra'
- Aggiungere il numero di parole: '350-400 parole'
- Aggiungere il pubblico: 'per candidati con più di 5 anni di esperienza'
- Aggiungere la struttura: 'Formato: introduzione, responsabilità (8 punti elenco), requisiti (5 punti elenco), requisiti preferenziali (3 punti elenco)'
- Aggiungere un'esclusione: 'Niente cliché come dinamico o appassionato'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
concrete_prompt = (
'Write a job description for a Senior ML Engineer position '
'at a Series B AI startup in London. '
'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
'Length: 350-400 words. '
'Structure:\n'
'1. 3-sentence company intro (no fluff — focus on product and mission)\n'
'2. Responsibilities: exactly 8 bullet points\n'
'3. Requirements: exactly 5 bullet points\n'
'4. Nice-to-haves: exactly 3 bullet points\n'
'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=600,
messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)L'abitudine ad arricchire i prompt
Sviluppi l'abitudine di arricchire ogni prompt prima di inviarlo. Esegua rapidamente questo passaggio mentale di arricchimento:
- È possibile sostituire una parola vaga con un numero?
- È possibile indicare uno strumento, una tecnologia o una persona specifici?
- È possibile definire il pubblico con maggiore precisione?
- È possibile aggiungere un esempio di ciò che si desidera?
- È possibile aggiungere almeno un vincolo 'non includere'?
- È possibile specificare il formato dell'output con maggiore precisione?
Anche solo due o tre arricchimenti migliorano notevolmente la qualità dell'output.
# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'
after = (
'Generate 6 opening hook ideas for a 15-minute conference talk '
'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
'Audience: Python developers, mostly backend, some ML experience. '
'Each hook: 2 sentences max. '
'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)
print('BEFORE:', before)
print()
print('AFTER:', after)Verifica delle conoscenze
Il fondatore di una startup invia questo prompt: 'Aiutami a scrivere un testo di marketing.' Quale prompt riscritto utilizza i dettagli concreti più efficaci?
Aggiunta di dettagli concreti — riepilogo
I dettagli concreti trasformano i prompt vaghi in istruzioni precise. Utilizzi queste tecniche di ancoraggio:
- Conteggio delle parole: sostituisca 'breve/lungo' con numeri esatti
- Entità denominate: prodotti, strumenti, aziende e persone specifici
- Pubblico: ruolo, livello di esperienza e ciò che già conosce
- Vincoli quantitativi: esattamente N elementi, N% di ogni tipo
- Vocabolario del dominio: utilizzi i termini del settore per indicare il livello di approfondimento atteso
- Esempi: mostri come si presenta un buon output
- Esclusioni: indichi ciò che il modello deve evitare
Domande Frequenti
La lezione «Aggiungere dettagli concreti» è gratuita?
Sì — il testo completo di «Aggiungere dettagli concreti» è 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 AI Prompt Engineering, passa a CoddyKit PRO. Il corso AI Prompt Engineering include 4 lezioni in totale.
Cosa imparerò in «Aggiungere dettagli concreti»?
Numeri, nomi, formati ed esempi che ancorano l'output dell'IA Eserciti AI Prompt Engineering 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 AI Prompt Engineering?
Non è richiesta alcuna esperienza precedente. AI Prompt Engineering su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Aggiungere dettagli concreti»?
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 AI Prompt Engineering?
Sì. Ogni lezione AI Prompt Engineering 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é la specificità è importante
- Eliminare l'ambiguità dai prompt
- Aggiungere dettagli concreti
- Confronto tra prompt vaghi e specifici