Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Workshop: Nibnu Prompt ta' Espert

Lezzjoni 13 / 14 Aġġornat 30 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Għan tal-Workshop
  2. Il-Proġett: Assistent għall-Analiżi tal-Kuntratti
  3. Pass 1: Iddefinixxi l-Messaġġ tas-Sistema
  4. Pass 2: Iddetermina l-Format tal-Output
  5. Pass 3: Żid Eżempji Few-Shot
  6. Pass 4: Ikkalibra l-Parametri
  7. Pass 5: Ittestja u Itera
  8. Pass 6: Iddokumenta l-Prompt Finali
  9. Poġġiha fil-Prattika
  10. Punti Ewlenin

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:

  1. Kompletezza: Is-sezzjonijiet kollha tal-format huma mimlija?
  2. Rilevanza: Ir-riskji identifikati huma reali u evalwati sewwa?
  3. Konsistenza: Il-punteġġ tar-riskju huwa konsistenti mar-riskji elenkati?
  4. Ċ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.