Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Workshop: Costruire un Prompt da Esperto

Lezione 13 di 14 Aggiornata il 30 luglio 2026 Principiante
In questa pagina
  1. Obiettivo del Workshop
  2. Il Progetto: Assistente per l’Analisi dei Contratti
  3. Passo 1: Definire il Messaggio di Sistema
  4. Passo 2: Strutturare il Formato di Output
  5. Passo 3: Aggiungere Esempi Few-Shot
  6. Passo 4: Calibrare i Parametri
  7. Passo 5: Testare e Iterare
  8. Passo 6: Documentare il Prompt Finale
  9. Mettilo in Pratica
  10. Punti chiave

Obiettivo del Workshop

Questo workshop ti guida passo dopo passo nella costruzione di un prompt da esperto completo. Creerai un assistente specializzato per un caso d’uso reale, applicando ogni tecnica trattata in questo corso: ruoli, parametri, few-shot prompting, chain of thought e istruzioni di sistema strutturate.

Al termine di questo workshop, avrai un prompt pronto per la produzione da integrare nei tuoi strumenti o nel tuo flusso di lavoro.

Il Progetto: Assistente per l’Analisi dei Contratti

Costruiremo un assistente capace di analizzare contratti commerciali ed estrarre informazioni chiave, rischi e punti di negoziazione.

Questo caso d’uso combina diverse tecniche: estrazione strutturata, analisi critica e redazione di raccomandazioni.

Passo 1: Definire il Messaggio di Sistema

Inizia con lo scheletro del messaggio di sistema. Identifica le sezioni necessarie:

You are an in-house counsel specializing in French commercial law, with 10 years of experience negotiating B2B contracts.

## Mission
You analyze commercial contracts and provide a structured assessment including: key clauses, identified risks, recommended negotiation points, and an overall risk score.

## Context
You work for a French SME in the technology sector (50 employees, €8 million annual revenue). The contracts analyzed are primarily vendor contracts, service agreements, and partnership deals.

## Constraints
- Always respond in English
- Base your analysis on French commercial law
- Systematically flag any clause that is unusual or unfavorable
- Clearly indicate when an analysis requires validation by a lawyer
- Never provide definitive legal advice

## Output Format
[to be defined in the next step]

Testa questo messaggio di sistema con un testo contrattuale semplice. Osserva il formato di risposta predefinito e identifica cosa vuoi migliorare.

Passo 2: Strutturare il Formato di Output

Dopo il primo test, definisci con precisione il formato atteso:

## Output Format

### 1. Summary (3-5 lines)
Contract type, parties, main subject, duration.

### 2. Key Clauses
For each important clause:
- **Title**: clause name
- **Summary**: what it stipulates (1-2 lines)
- **Assessment**: favorable / neutral / unfavorable
- **Comment**: why this assessment

### 3. Identified Risks
Numbered list, from most critical to least critical:
- Risk description
- Severity: critical / high / moderate / low
- Mitigation recommendation

### 4. Negotiation Points
The 3-5 points to prioritize in negotiation, with a suggested alternative wording.

### 5. Overall Risk Score
Rating from 1 (very low) to 10 (very high) with a 2-line justification.

Riesegui il test con lo stesso contratto. Il risultato dovrebbe ora essere strutturato e immediatamente utilizzabile.

Passo 3: Aggiungere Esempi Few-Shot

Per calibrare la qualità delle valutazioni, aggiungi una coppia input/output di esempio alla tua conversazione:

[
  {"role": "system", "content": "[your complete system message]"},
  {"role": "user", "content": "Analyze this clause: 'The service provider commits to a guaranteed result obligation on all deliverables. Any delay will be penalized at 5% of the total amount per day of delay, without cap.'"},
  {"role": "assistant", "content": "### Clause: Guaranteed Result Obligation and Penalties\n- **Summary**: The provider is subject to a guaranteed result obligation (not best efforts) with delay penalties of 5% per day without cap.\n- **Assessment**: Unfavorable\n- **Comment**: The absence of a cap on penalties is a major risk. Under French law, uncapped penalties can exceed the total contract amount. Additionally, the guaranteed result obligation (vs. best efforts) transfers all risk to the provider. Recommendation: negotiate a penalty cap at 10–15% of the total amount and propose a reinforced best efforts obligation."},
  {"role": "user", "content": "[new contract to analyze]"}
]

Questo esempio mostra al modello il livello di dettaglio e il tono attesi.

Passo 4: Calibrare i Parametri

Per un compito di analisi che richiede rigore e coerenza:

{
  "model": "grok-4.20-0309-reasoning",
  "temperature": 0.3,
  "max_completion_tokens": 3000,
  "reasoning": {"effort": "high"}
}

Giustificazione delle scelte:

  • Modello di ragionamento: L’analisi contrattuale richiede un ragionamento strutturato
  • Bassa temperatura: Cerchiamo rigore, non creatività
  • Token elevati: L’analisi completa di un contratto può essere lunga
  • Sforzo elevato: Le sfumature legali richiedono un ragionamento profondo

Passo 5: Testare e Iterare

Testa il tuo prompt con 3–5 contratti diversi e verifica:

  1. Completezza: Tutte le sezioni del formato sono compilate?
  2. Rilevanza: I rischi identificati sono reali e valutati correttamente?
  3. Coerenza: Il punteggio di rischio è coerente con i rischi elencati?
  4. Chiarezza: Un non avvocato può comprendere le raccomandazioni?

Per ogni problema identificato, regola un elemento alla volta:

  • Se i rischi sono sottostimati: Aggiungi «Sii conservativo nella valutazione del rischio. In caso di dubbio, classifica il rischio al livello superiore».
  • Se il formato devia: Aggiungi un secondo esempio few-shot per rafforzare la struttura.
  • Se l’analisi è troppo tecnica: Aggiungi «Spiega ogni rischio in termini comprensibili per un dirigente non avvocato».

Passo 6: Documentare il Prompt Finale

Una volta soddisfatto del risultato, documenta il tuo prompt:

  • Il messaggio di sistema completo
  • Gli esempi few-shot
  • I parametri (modello, temperatura, token)
  • I casi di test e i risultati ottenuti
  • Le modifiche apportate e il loro impatto

Questo documento è la tua ricetta del prompt: ti permette di riprodurlo, condividerlo o adattarlo a un nuovo caso d’uso.

Mettilo in Pratica

Applica questa metodologia in 6 passi al tuo caso d’uso personale. Scegli un argomento che conosci bene per poter valutare la qualità delle risposte. Itera fino a ottenere un risultato di qualità professionale.

Punti chiave

  • La costruzione di un prompt da esperto segue un processo in 6 passi: sistema, formato, esempi, parametri, test, documentazione
  • Il messaggio di sistema è la fondazione: investi tempo per strutturarlo correttamente
  • Gli esempi few-shot calibrano il livello di dettaglio e il tono delle risposte
  • Testa con casi variati e regola un aspetto per ogni iterazione
  • Documenta il tuo prompt finale per riprodurlo e migliorarlo