AI Prompt Engineering · Lezione

Regolare il livello del vocabolario

Controlli la complessità: linguaggio semplice da scuola media o terminologia specifica del dominio

Lezione 4 di 413 passaggi

Regolare il livello del vocabolario è una lezione AI Prompt Engineering gratuita su CoddyKit. Questa è la lezione 4 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.

Vocabolario: il regolatore della leggibilità

Il livello del vocabolario è il fattore singolo più importante per determinare quanto il contenuto risulti accessibile o escludente. Una semplice modifica nella scelta delle parole può fare la differenza tra una risposta che entra in sintonia con il lettore e una che lo allontana.

I modelli di IA possono operare lungo l'intero spettro del vocabolario — da un linguaggio semplicissimo a uno complesso come quello di una tesi di dottorato — ma deve impostare esplicitamente questo livello.

Linguaggio semplice, senza gergo

Richiedere un linguaggio semplice e privo di gergo è fondamentale per i contenuti rivolti ai consumatori, la documentazione di assistenza e la comunicazione interfunzionale.

Richieste efficaci:

  • 'Usi un linguaggio semplice, senza gergo tecnico'
  • 'Spieghi come se il lettore non avesse alcuna conoscenza preliminare dell'argomento'
  • 'Ogni termine tecnico deve essere spiegato in un linguaggio chiaro quando viene usato per la prima volta'
  • 'Sostituisca qualsiasi parola che un tipico bambino di 10 anni non conoscerebbe'
import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=150,
    messages=[{
        'role': 'user',
        'content': (
            'Explain what encryption is. '
            'Simple language only — no technical jargon. '
            'If you must use a technical word, immediately define it in plain English in parentheses. '
            'Target reading level: general public with no tech background. '
            '3 sentences maximum.'
        )
    }]
)
print(response.content[0].text)

Specifiche del livello di lettura

Il Flesch-Kincaid Grade Level misura la difficoltà di lettura in base al livello scolastico statunitense. Può richiederlo direttamente:

  • 'livello di lettura dell'ottava classe' → accessibile alla maggior parte degli adulti
  • 'livello di lettura della quinta classe' → abbastanza semplice per bambini o persone non madrelingua
  • 'livello di lettura della dodicesima classe' → per adulti istruiti, con una certa complessità accettabile
  • 'livello di lettura universitario' → presuppone un'istruzione post-secondaria

Le richieste relative al livello scolastico funzionano sorprendentemente bene per controllare la complessità del vocabolario.

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

levels = ['5th-grade', '8th-grade', '12th-grade', 'college']

for level in levels:
    response = client.chat.completions.create(
        model='gpt-4o',
        max_tokens=60,
        messages=[{
            'role': 'user',
            'content': (
                f'Explain what a database index is. '
                f'Reading level: {level}. 2 sentences maximum.'
            )
        }]
    )
    print(f'[{level}]: {response.choices[0].message.content.strip()}')
    print()

Dare per acquisite le conoscenze degli esperti

Quando scrive per esperti del settore, il gergo non è un problema: è uno strumento di efficienza. Gli esperti preferiscono una terminologia tecnica precisa alle spiegazioni semplificate.

Richieste per un vocabolario di livello esperto:

  • 'Presupponga conoscenze specialistiche: non sono necessarie definizioni'
  • 'Utilizzi liberamente la terminologia tecnica'
  • 'Scriva per un pubblico di ricercatori con un dottorato in questo settore'
  • 'Niente spiegazioni superflue: dia per scontato che il lettore conosca i fondamenti'
import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

expert_prompt = (
    'Explain the trade-off between MVCC and locking-based concurrency control in OLTP databases.\n'
    'Audience: senior database engineers with 10+ years experience.\n'
    'Assume expert knowledge — no definitions of basic terms needed.\n'
    'Use technical terminology freely: transaction isolation levels, write skew, '
    'phantom reads, lock contention, WAL, tuple visibility.\n'
    'Max 4 sentences. Be precise, not introductory.'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=200,
    messages=[{'role': 'user', 'content': expert_prompt}]
)
print(response.content[0].text)

Includere la terminologia tecnica

Quando scrive contenuti didattici per studenti che devono acquisire il vocabolario tecnico, può indicare al modello di:

  • Introdurre progressivamente i termini tecnici
  • Mettere in grassetto ogni termine al primo utilizzo
  • Associare sempre un termine tecnico al suo equivalente in linguaggio semplice
  • Creare un mini-glossario alla fine

Questo approccio insegna il vocabolario e al tempo stesso comunica il contenuto.

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Explain how HTTPS works for a developer just starting to learn web security. '
            'Vocabulary strategy:\n'
            '- Introduce technical terms gradually — start simple, add complexity\n'
            '- Bold every new technical term on first use\n'
            '- Immediately follow each bold term with a plain-English definition in parentheses\n'
            '- End with a 4-term Glossary section\n'
            'Length: 150 words max (excluding glossary).'
        )
    }]
)
print(response.choices[0].message.content)

Il controllo del gergo

Un controllo del gergo chiede al modello di esaminare contenuti esistenti e segnalare o sostituire i termini tecnici che un non esperto potrebbe non comprendere.

Utile per: rivedere la propria scrittura prima di inviarla a un pubblico non tecnico, controllare la documentazione di assistenza e verificare l'accessibilità dei testi di marketing.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

technical_text = (
    'Our platform leverages a microservices architecture with asynchronous event-driven '
    'communication via a Kafka message broker. Each service exposes RESTful endpoints '
    'behind an API gateway that handles rate limiting and JWT authentication. '
    'Horizontal pod autoscaling on Kubernetes ensures elasticity under load.'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=300,
    messages=[{
        'role': 'user',
        'content': (
            'Perform a jargon audit on the following paragraph.\n'
            '1. List every technical term a non-technical business stakeholder might not know.\n'
            '2. For each term, provide a plain-English alternative (5 words or fewer).\n'
            '3. Rewrite the paragraph using only the plain-English alternatives.\n\n'
            f'Text:\n{technical_text}'
        )
    }]
)
print(response.content[0].text)

Coerenza terminologica

Una terminologia coerente in tutto il documento è particolarmente importante nella scrittura tecnica. Quando lo stesso concetto ha più nomi di uso comune, ne scelga uno e lo utilizzi in tutto il documento:

  • Non alterni tra 'utente', 'cliente' e 'membro'
  • Non utilizzi indifferentemente 'API', 'endpoint' e 'servizio' per indicare lo stesso sistema
  • Non alterni tra 'database' e 'archivio dati'

Richiesta: 'Utilizzi una terminologia coerente in tutto il documento. In caso di dubbio, preferisca [X] a [Y] per [concetto].'

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Write a 3-section product description for our B2B SaaS platform.\n'
            'VOCABULARY RULES — use these terms consistently throughout:\n'
            '- Use "workspace" not "project", "environment", or "account"\n'
            '- Use "team member" not "user" or "collaborator"\n'
            '- Use "dashboard" not "panel", "console", or "interface"\n'
            '- Use "connect" not "integrate", "link", or "sync"\n'
            'Sections: Overview, Key Benefits, How It Works.\n'
            'Max 100 words total.'
        )
    }]
)
print(response.choices[0].message.content)

Vocabolario per il pubblico internazionale

Quando scrive per un pubblico globale, in cui l'inglese potrebbe essere una seconda lingua, la scelta del vocabolario è ancora più importante:

  • Preferisca parole più brevi e comuni a parole più lunghe e rare
  • Eviti idiomi e verbi frasali che non si traducono bene
  • Eviti riferimenti culturali poco familiari al di fuori di una determinata regione
  • Usi formulazioni esplicite invece di significati impliciti
  • Preferisca costruzioni attive a quelle passive

Richiesta: 'Scriva per un pubblico internazionale in cui l'inglese è una seconda lingua — vocabolario semplice, niente idiomi.'

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

current_text = (
    'Our platform hits the ground running right out of the box, '
    'giving your team a leg up on the competition. '
    'Once you are up to speed, you will be firing on all cylinders. '
    'The ball is in your court — reach out to kick off your trial.'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=200,
    messages=[{
        'role': 'user',
        'content': (
            'Rewrite the following text for an international audience where English is a second language.\n'
            'Rules:\n'
            '- Replace all idioms with literal, plain alternatives\n'
            '- Use only common, short words (prefer "start" over "commence")\n'
            '- No phrasal verbs ("kick off" → "start", "reach out" → "contact")\n'
            '- Active voice only\n\n'
            f'Text:\n{current_text}'
        )
    }]
)
print(response.content[0].text)

Verificare il vocabolario con un'autovalutazione

Chieda al modello di controllare autonomamente il livello del vocabolario del testo prodotto dopo averlo generato. Questo approccio in due passaggi individua il vocabolario sfuggito ai controlli nonostante le istruzioni:

  1. Generi il contenuto con istruzioni sul vocabolario
  2. Chieda al modello di elencare le parole che violano il livello richiesto e suggerire sostituzioni
import openai

client = openai.OpenAI(api_key='sk-your-key-here')

# Step 1: generate with vocabulary constraint
result = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': 'Explain HTTP status codes in 3 sentences for a non-technical business person. Simple words only.'
    }]
)
content = result.choices[0].message.content
print('GENERATED:')
print(content)
print()

# Step 2: vocabulary self-audit
audit = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            f'Review the following text. List any words a typical non-technical business person '
            f'(no tech background) might not know. For each flagged word, suggest a simpler alternative.\n\n'
            f'Text:\n{content}'
        )
    }]
)
print('VOCABULARY AUDIT:')
print(audit.choices[0].message.content)

Vocabolario e fiducia

Il livello del vocabolario influisce direttamente sulla fiducia che i lettori ripongono nel contenuto:

  • Troppo semplice per il pubblico → risulta condiscendente e compromette la credibilità
  • Troppo complesso per il pubblico → risulta escludente e crea confusione
  • Esattamente adeguato → sembra scritto proprio per quel lettore

L'obiettivo non è utilizzare il vocabolario più semplice possibile, ma il vocabolario giusto per il lettore specifico. Uno sviluppatore blockchain che legge di Ethereum si aspetta una terminologia precisa; chi acquista criptovalute per la prima volta no.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

# Same topic, calibrated vocabulary for different trust contexts
audiences = [
    ('CRYPTO BEGINNER', 'No technical background, first time reading about cryptocurrency. Plain English, no assumed knowledge.'),
    ('BLOCKCHAIN DEVELOPER', 'Expert: knows EVM, gas fees, consensus mechanisms, smart contract bytecode. No definitions needed.')
]

topic = 'Why Ethereum uses proof-of-stake instead of proof-of-work.'

for label, spec in audiences:
    response = client.messages.create(
        model='claude-opus-4-5',
        max_tokens=100,
        messages=[{
            'role': 'user',
            'content': f'Audience: {spec}\n\nExplain in 2 sentences: {topic}'
        }]
    )
    print(f'[{label}]')
    print(response.content[0].text.strip())
    print()

Vocabolario e voce del brand

La voce del brand dipende in parte dalla scelta del vocabolario. Le aziende definiscono le proprie regole terminologiche nelle guide di stile e l'IA può seguirle in modo coerente se le specifica.

Esempi di regole terminologiche del brand:

  • Mailchimp: 'Dica help, non assist'
  • Stripe: 'Dica set up (verbo), ma setup (sostantivo)'
  • Shopify: 'Dica merchants, non customers o users'

Aggiunga le regole terminologiche del brand al messaggio di sistema per ottenere un output coerente in tutti i contenuti.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

brand_vocab_system = (
    'You write content for NorthBridge, a B2B SaaS company. '
    'Brand vocabulary rules:\n'
    '- Say "workspace" not "account" or "project"\n'
    '- Say "connect" not "integrate" or "link"\n'
    '- Say "team" not "users" or "members"\n'
    '- Say "get started" not "onboard" or "begin"\n'
    '- Avoid: "leverage", "synergy", "ecosystem", "seamlessly"'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=100,
    system=brand_vocab_system,
    messages=[{
        'role': 'user',
        'content': 'Write a 2-sentence CTA for the homepage inviting users to create an account and start using integrations.'
    }]
)
print(response.content[0].text)

Verifica delle conoscenze

Un'azienda vuole inviare un'e-mail di notifica di una violazione dei dati a tutti i 50.000 utenti, la maggior parte dei quali sono consumatori non tecnici. La bozza attuale recita: 'Una vulnerabilità nella nostra implementazione di OAuth2 ha causato l'esfiltrazione non autorizzata di credenziali utente sottoposte ad hashing.' Qual è il principale problema terminologico?

Adattare il livello del vocabolario — riepilogo

Il livello del vocabolario determina quanto il contenuto appare accessibile o autorevole. Tecniche principali:

  • Richieda livelli di lettura specifici: quinta classe, ottava classe, universitario
  • Usi 'senza gergo' per i contenuti rivolti ai consumatori e quelli interfunzionali
  • Usi 'presupponga conoscenze specialistiche' per consentire l'impiego di una terminologia tecnica precisa
  • Insegni il vocabolario con l'introduzione progressiva e il grassetto al primo utilizzo
  • Richieda la coerenza terminologica in tutti i documenti
  • Scriva per pubblici internazionali eliminando idiomi e verbi frasali
  • Usi prompt di autovalutazione per individuare le violazioni del vocabolario nei contenuti generati
Gratis per iniziare

Impara AI Prompt Engineering 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
53
Lezioni
199

Domande Frequenti

La lezione «Regolare il livello del vocabolario» è gratuita?

Sì — il testo completo di «Regolare il livello del vocabolario» è 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 «Regolare il livello del vocabolario»?

Controlli la complessità: linguaggio semplice da scuola media o terminologia specifica del dominio 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 4 di 4.

Quanto tempo richiede la lezione «Regolare il livello del vocabolario»?

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

  1. Tono formale o informale
  2. Specificare il pubblico
  3. Stili di scrittura professionale
  4. Regolare il livello del vocabolario
← Torna a AI Prompt Engineering