Työpaja: Asiantuntijakehotteen laatiminen
Tällä sivulla
Työpajan tavoite
Tässä työpajassa käymme läpi täydellisen asiantuntijakehotteen rakentamisen vaihe vaiheelta. Luot erikoistuneen avustajan todelliseen käyttötarkoitukseen soveltamalla kaikkia tällä kurssilla käsiteltyjä tekniikoita: roolit, parametrit, muutama esimerkki (few-shot), ajatusketju (chain of thought) ja jäsennellyt järjestelmäohjeet.
Työpajan päätteeksi sinulla on tuotantovalmis kehote, jonka voit integroida työkaluihisi tai työnkulkuusi.
Hanke: Sopimusanalyysiavustaja
Rakennamme avustajan, joka pystyy analysoimaan kaupallisia sopimuksia ja poimimaan niistä keskeiset tiedot, riskit ja neuvottelukohdat.
Tämä käyttötapaus yhdistää useita tekniikoita: jäsennellyn tiedonpoiston, kriittisen analyysin ja suositusten laatimisen.
Vaihe 1: Järjestelmäviestin määrittely
Aloita järjestelmäviestin rungosta. Tunnista tarvittavat osiot:
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]
Testaa tätä järjestelmäviestiä yksinkertaisella sopimustekstillä. Havainnoi oletusarvoista vastausmuotoa ja tunnista, mitä haluat parantaa.
Vaihe 2: Tulosteen muodon jäsentely
Määrittele ensimmäisen testin jälkeen odotettu muoto tarkasti:
## 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.
Testaa uudelleen samalla sopimuksella. Tuloksen pitäisi nyt olla jäsennelty ja välittömästi toimintaan ohjaava.
Vaihe 3: Muutaman esimerkin (Few-Shot) lisääminen
Kalibroidaksesi arviointien laatua, lisää keskusteluusi esimerkkisyöte- ja -tulostepari:
[
{"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]"}
]
Tämä esimerkki osoittaa mallille odotetun yksityiskohtaisuustason ja sävyn.
Vaihe 4: Parametrien kalibrointi
Rigorisuutta ja johdonmukaisuutta vaativaan analyysitehtävään:
{
"model": "grok-4.20-0309-reasoning",
"temperature": 0.3,
"max_completion_tokens": 3000,
"reasoning": {"effort": "high"}
}
Valintojen perustelut:
- Päättelymalli: Sopimusanalyysi vaatii jäsenneltyä päättelyä.
- Matala lämpötila: Haluamme rigorisuutta emmekä luovuutta.
- Suuri token-määrä: Täydellinen sopimusanalyysi voi olla pitkä.
- Korkea ponnistus: Juridiset vivahdukset vaativat syvällistä päättelyä.
Vaihe 5: Testaus ja iterointi
Testaa kehotettasi 3–5 eri sopimuksella ja varmista seuraavat asiat:
- Täydellisyys: Onko kaikki muodon osiot täytetty?
- Relevanssi: Ovatko tunnistetut riskit todellisia ja arvioitu oikein?
- Johdonmukaisuus: Vastaako riskipisteetys lueteltuja riskejä?
- Selkeys: Ymmärtääkö juristiton henkilö suositukset?
Säädä jokaisen havaitun ongelman kohdalla yhtä asiaa kerrallaan:
- Jos riskejä aliarvioidaan: Lisää ohje ”Ole riskiarviossasi konservatiivinen. Epäselvissä tilanteissa luokittele riski korkeammalle tasolle.”
- Jos muoto harhailee: Lisää toinen muutama esimerkki (few-shot) vahvistaaksesi rakennetta.
- Jos analyysi on liian tekninen: Lisää ohje ”Selitä jokainen riski tavalla, jonka juristiton johto ymmärtää.”
Vaihe 6: Lopullisen kehotteen dokumentointi
Kun olet tyytyväinen tulokseen, dokumentoi kehotteesi:
- Täydellinen järjestelmäviesti
- Muutaman esimerkin (few-shot) tapaukset
- Parametrit (malli, lämpötila, tokenit)
- Testitapaukset ja saadut tulokset
- Tehdyt säädöt ja niiden vaikutus
Tämä asiakirja on kehotteesi resepti: sen avulla voit toistaa, jakaa tai mukauttaa kehotetta uuteen käyttötarkoitukseen.
Käytäntöön
Sovella tätä 6-vaiheista metodologiaa omaan käyttötarkoitukseesi. Valitse aihe, jonka tunnet hyvin, jotta pystyt arvioimaan vastausten laatua. Iteroi, kunnes saavutat ammattimaisen tason tuloksen.
Keskeiset asiat
- Asiantuntijakehotteen rakentaminen noudattaa 6-vaiheista prosessia: järjestelmä, muoto, esimerkit, parametrit, testit, dokumentointi.
- Järjestelmäviesti on perusta: käytä aikaa sen oikeanlaiseen jäsentelemiseen.
- Muutaman esimerkin (few-shot) tapaukset kalibroivat vastausten yksityiskohtaisuustason ja sävyn.
- Testaa vaihtelevilla tapauksilla ja säädä yhtä aspektia kerrallaan.
- Dokumentoi lopullinen kehotteesi sen toistamista ja parantamista varten.