Radionica: Izrada stručnog upita
Na ovoj stranici
Cilj radionice
Ova te radionica korak po korak vodi kroz izradu potpunog stručnog upita. Stvorit ćeš specijaliziranog asistenta za stvarni slučaj primjene primjenom svake tehnike obrađene u ovom tečaju: uloga, parametara, few-shot upita, lanca razmišljanja i strukturiranih sistemskih uputa.
Do kraja ove radionice imat ćeš upit spreman za proizvodnju koji možeš integrirati u svoje alate ili radni tijek.
Projekt: Asistent za analizu ugovora
Izgradit ćemo asistenta sposobnog analizirati komercijalne ugovore te izvlačiti ključne informacije, rizike i točke za pregovaranje.
Ovaj slučaj upotrebe kombinira nekoliko tehnika: strukturirano izvlačenje podataka, kritičku analizu i izradu preporuka.
Korak 1: Definiranje sistemske poruke
Započni s kosturom sistemske poruke. Identificiraj potrebne odjeljke:
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]
Testiraj ovu sistemsku poruku s jednostavnim tekstom ugovora. Promotri zadani format odgovora i identificiraj što želiš poboljšati.
Korak 2: Strukturiranje formata izlaza
Nakon prvog testa, precizno definiraj očekivani format:
## 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.
Ponovno testiraj s istim ugovorom. Rezultat bi sada trebao biti strukturiran i odmah primjenjiv.
Korak 3: Dodavanje few-shot primjera
Kako bi kalibrirao kvalitetu procjena, dodaj par primjera ulaza/izlaza u svoj razgovor:
[
{"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]"}
]
Ovaj primjer pokazuje modelu očekivanu razinu detalja i ton.
Korak 4: Kalibracija parametara
Za zadaću analize koja zahtijeva rigoroznost i dosljednost:
{
"model": "grok-4.20-0309-reasoning",
"temperature": 0.3,
"max_completion_tokens": 3000,
"reasoning": {"effort": "high"}
}
Obrazloženje odabira:
- Model za razmišljanje: Analiza ugovora zahtijeva strukturirano razmišljanje
- Niska temperatura: Želimo rigoroznost, a ne kreativnost
- Visok broj tokena: Potpuna analiza ugovora može biti dugačka
- Visok napor: Pravne nijanse zahtijevaju duboko razmišljanje
Korak 5: Testiranje i iteracija
Testiraj svoj upit s 3–5 različitih ugovora i provjeri:
- Potpunost: Jesu li popunjena sva odjeljka formata?
- Relevantnost: Jesu li identificirani rizici stvarni i pravilno procijenjeni?
- Dosljednost: Je li ocjena rizika u skladu s navedenim rizicima?
- Jasnoća: Može li osoba koja nije pravnik razumjeti preporuke?
Za svaki identificirani problem prilagodi jednu stvar odjednom:
- Ako su rizici podcijenjeni: Dodaj „Budi konzervativan u procjeni rizika. U slučaju sumnje, klasificiraj rizik na višu razinu.“
- Ako format odstupa: Dodaj drugi few-shot primjer kako bi ojačao strukturu
- Ako je analiza pretehnička: Dodaj „Objasni svaki rizik na način razumljiv rukovoditelju koji nije pravnik“
Korak 6: Dokumentiranje konačnog upita
Kada budeš zadovoljan rezultatom, dokumentiraj svoj upit:
- Potpuna sistemska poruka
- Few-shot primjeri
- Parametri (model, temperatura, tokeni)
- Testni slučajevi i dobiveni rezultati
- Izvršene prilagodbe i njihov utjecaj
Ovaj dokument tvoj je recept za upit: omogućuje ti da ga reproduciraš, podijeliš ili prilagodiš novom slučaju upotrebe.
Primjena u praksi
Primijeni ovu metodologiju od 6 koraka na svoj vlastiti slučaj upotrebe. Odaberi temu koju dobro poznaješ kako bi mogao procijeniti kvalitetu odgovora. Iteriraj dok ne postigneš rezultat profesionalne kvalitete.
Ključne točke
- Izrada stručnog upita slijedi proces od 6 koraka: sistem, format, primjeri, parametri, testovi, dokumentacija
- Sistemska poruka je temelj: uloži vrijeme da je ispravno strukturiraš
- Few-shot primjeri kalibriraju razinu detalja i ton odgovora
- Testiraj s različitim slučajevima i prilagođavaj po jedan aspekt po iteraciji
- Dokumentiraj svoj konačni upit kako bi ga mogao reproducirati i poboljšati