Workshop: Nibnu Prompt ta' Espert
F'din il-paġna
Għan tal-Workshop
Dan il-workshop jimxik pass pass biex tibni prompt ta’ espert sħiħ. Se toħloq assistent speċjalizzat għal każ ta’ użu reali billi tapplika kull teknika koperta f’dan il-kors: rwoli, parametri, few-shot prompting, katina ta’ ħsieb (chain of thought), u istruzzjonijiet tas-sistema strutturati.
Sa tmiem dan il-workshop, ikollok prompt lest għall-produzzjoni biex tintegra fl-għodod jew fil-fluss tax-xogħol tiegħek.
Il-Proġett: Assistent għall-Analiżi tal-Kuntratti
Se nibnu assistent kapaċi janalizza kuntratti kummerċjali u joħroġ informazzjoni ewlenija, riskji, u punti għan-negozjazzjoni.
Dan il-każ ta’ użu jgħaqqad diversi tekniki: estrazzjoni strutturata, analiżi kritika, u abbozzar ta’ rakkomandazzjonijiet.
Pass 1: Iddefinixxi l-Messaġġ tas-Sistema
Ibda bl-istruttura bażika tal-messaġġ tas-sistema. Identifika s-sezzjonijiet meħtieġa:
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]
Ittestja dan il-messaġġ tas-sistema b’test sempliċi ta’ kuntratt. Osserva l-format tar-rispons predefinit u identifika x’tixtieq ittejjeb.
Pass 2: Iddetermina l-Format tal-Output
Wara l-ewwel test, iddefinixxi preċiżament il-format mistenni:
## 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.
Erġa’ ittestja bl-istess kuntratt. Ir-riżultat issa għandu jkun strutturat u pront għall-azzjoni immedjata.
Pass 3: Żid Eżempji Few-Shot
Biex tikkalibra l-kwalità tal-valutazzjonijiet, żid par input/output ta’ eżempju fil-konversazzjoni tiegħek:
[
{"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]"}
]
Dan l-eżempju juri lill-mudell il-livell mistenni ta’ dettall u t-ton.
Pass 4: Ikkalibra l-Parametri
Għal kompitu ta’ analiżi li jeħtieġ rigoru u konsistenza:
{
"model": "grok-4.20-0309-reasoning",
"temperature": 0.3,
"max_completion_tokens": 3000,
"reasoning": {"effort": "high"}
}
Ġustifikazzjoni għall-għażliet:
- Mudell tar-raġunar (Reasoning model): L-analiżi tal-kuntratti teħtieġ raġunar strutturat.
- Temperatura baxxa: Irridu rigoru, mhux kreattività.
- Tokens għoljin: Analiżi sħiħa tal-kuntratti tista’ tkun twila.
- Sforz għoli (High effort): In-nuansi legali jeħtieġu raġunar fond.
Pass 5: Ittestja u Itera
Ittestja l-prompt tiegħek b’3–5 kuntratti differenti u vverifika:
- Kompletezza: Is-sezzjonijiet kollha tal-format huma mimlija?
- Rilevanza: Ir-riskji identifikati huma reali u evalwati sewwa?
- Konsistenza: Il-punteġġ tar-riskju huwa konsistenti mar-riskji elenkati?
- Ċarezza: Persuna mhux avukat tista’ tifhem ir-rakkomandazzjonijiet?
Għal kull problema identifikata, aġġusta ħaġa waħda kull darba:
- Jekk ir-riskji huma sottovalutati: Żid “Kun konservattiv fil-valutazzjoni tar-riskju tiegħek. F’każ ta’ dubju, ikklassifika r-riskju f’livell ogħla.”
- Jekk il-format jiddevja: Żid it-tieni eżempju few-shot biex issaħħaħ l-istruttura.
- Jekk l-analiżi hija wisq teknika: Żid “Spjega kull riskju b’termini li jifhem maniġer mhux avukat.”
Pass 6: Iddokumenta l-Prompt Finali
Ladarba tkun sodisfatt bir-riżultat, iddokumenta l-prompt tiegħek:
- Il-messaġġ sħiħ tas-sistema
- L-eżempji few-shot
- Il-parametri (mudell, temperatura, tokens)
- Il-każijiet ta’ test u r-riżultati miksuba
- L-aġġustamenti magħmula u l-impatt tagħhom
Dan id-dokument huwa r-riċetta tal-prompt tiegħek: jippermettilek tirriproduċiha, taqsamha, jew tadattaha għal każ ta’ użu ġdid.
Poġġiha fil-Prattika
Applika din il-metodoloġija ta’ 6 passi għall-każ ta’ użu tiegħek stess. Agħżel suġġett li taf sewwa biex tkun tista’ tevalwa l-kwalità tar-risponsi. Itera sakemm tilħaq riżultat ta’ kwalità professjonali.
Punti Ewlenin
- Il-bini ta’ prompt ta’ espert isegwi proċess ta’ 6 passi: sistema, format, eżempji, parametri, testijiet, dokumentazzjoni.
- Il-messaġġ tas-sistema huwa l-fondazzjoni: invest ħin biex tistrutturah sewwa.
- L-eżempji few-shot jikkalibraw il-livell ta’ dettall u t-ton tar-risponsi.
- Ittestja b’każijiet varjati u aġġusta aspett wieħed kull iterazzjoni.
- Iddokumenta l-prompt finali tiegħek biex tirriproduċih u ttejbu.