Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Työpaja: Asiantuntijakehotteen laatiminen

Oppitunti 13 / 14 Päivitetty 30. heinäkuuta 2026 Aloittelija
Tällä sivulla
  1. Työpajan tavoite
  2. Hanke: Sopimusanalyysiavustaja
  3. Vaihe 1: Järjestelmäviestin määrittely
  4. Vaihe 2: Tulosteen muodon jäsentely
  5. Vaihe 3: Muutaman esimerkin (Few-Shot) lisääminen
  6. Vaihe 4: Parametrien kalibrointi
  7. Vaihe 5: Testaus ja iterointi
  8. Vaihe 6: Lopullisen kehotteen dokumentointi
  9. Käytäntöön
  10. Keskeiset asiat

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:

  1. Täydellisyys: Onko kaikki muodon osiot täytetty?
  2. Relevanssi: Ovatko tunnistetut riskit todellisia ja arvioitu oikein?
  3. Johdonmukaisuus: Vastaako riskipisteetys lueteltuja riskejä?
  4. 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.