Tehokkaat järjestelmäkehotteet
Tällä sivulla
Järjestelmäviestin taide tuotantoympäristössä
Järjestelmäviesti on tehokkain vipusi mallin käyttäytymisen ohjaamiseen. Toisin kuin user-ohjeet, jotka muuttuvat jokaisessa pyynnössä, järjestelmäviesti pysyy vakiona kutsujen välillä ja määrittelee koko sovelluksesi toimintakehyksen. Se muuttaa yleiskäyttöisen mallin erikoistuneeksi avustajaksi. Tuotantoympäristössä sitä ei improvisoida: se rakennetaan, versioidaan ja testataan kuten mikä tahansa muukin järjestelmäkomponentti.
Tuotantojärjestelmäkehotteen anatomia
Tehokas järjestelmäkehote koostuu neljästä erillisestä lohkosta: Identiteetti, Konteksti, Käyttäytyminen ja Muotoilu. Tässä on täydellinen kokonaisuus ohjelmistotuen avustajalle:
system_prompt = """
IDENTITY: You are the AI assistant for TechCorp, specializing in technical support for accounting software.
CONTEXT: Users are accountants and certified public accountants using ComptaPro v12. They know accounting but not necessarily IT.
BEHAVIOR:
- Respond in French using formal address (vouvoiement)
- Be precise and technical without excessive IT jargon
- If you are unsure, say so and direct the user to human support
- Never provide tax or legal advice
FORMAT:
- Structured responses with numbered steps for procedures
- Code blocks for formulas or configurations
- Maximum 300 words unless the user explicitly requests details
"""
IDENTITEETTI-lohko vastaa kysymykseen “kuka malli on?”. Tämä roolipelimalli auttaa mallia jäsentämään vastauksensa, kunhan olet tarkka. “Olet avulias avustaja” on liian epämääräinen muuttaakseen mitään, kun taas “Olet kokenut DevOps-insinööri, joka on erikoistunut AWS-infrastruktuuriin. Neuvot 5–20 kehittäjän tiimejä pilviarkkitehtuureissa” asettaa heti teknisen tason, keskustelukumppanin ja laajuuden. Malli tietää tällöin, kuinka syvälle sen tulee mennä, sinun tarvitsematta toistaa sitä.
KONTEKSTI-lohko tarjoaa tiedot, joita malli ei voi arvata. Tarkentamalla, että “asiakas käyttää Python 3.11:ää, FastAPI 0.110:ää ja ottaa käyttöön AWS Lambdaan”, että “tietokanta on PostgreSQL 16 RDS:ssä” ja että “keskimääräinen liikenne on 500 pyyntöä sekunnissa ruuhka-aikoina”, estät mallia ehdottamasta ratkaisua, joka on teoreettisesti oikea mutta yhteensopimaton asiakkaan todellisen ympäristön kanssa.
KÄYTTÄYTYMINEN-lohko esittää säännöt selkeinä ohjeina. On hyödyllistä asettaa systemaattisesti AINA vastakkain EI KOSKAAN: lainaa lähteitä aina vain virallisesta dokumentaatiosta, ehdota aina testattavia koodiesimerkkejä; älä koskaan ehdota ratkaisuja, jotka nojaavat ylläpitämättömiin riippuvuuksiin, äläkä koskaan muuta tietokannan skeemaa ilman nimenomaista varoitusta. Tämä symmetria sulkee ovet, joista malli saattaisi muuten kävellä läpi spontaanisti.
MUOTOILU-lohko lopulta määrää tulosteen rakenteen. Neliosaisen suunnitelman pyytäminen – yksi tai kaksi lausetta diagnoosille, suositeltu ratkaisu koodineen jos soveltuu, vaihtoehdot jos relevanttia, varoitukset sivuvaikutuksista ja riskeistä – takaa vertailukelpoiset vastaukset, mikä tekee niistä käytettäviä sekä käyttöliittymällesi että käyttäjillesi.
Kolme täydellistä järjestelmäkehotetta
Verkkokauppachatin tulee ennen kaikkea tietää, missä se pysähtyy: suosittele, mutta älä keksi mitään, ja siirrä eteenpäin heti, kun kyseessä on asiakaspalvelu.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))
SYSTEM_ECOMMERCE = """IDENTITY: Assistant for the MaisonDeco.fr online store, interior decoration specialist.
CONTEXT: Catalog of 15,000 products. Delivery to metropolitan France only. Free returns within 30 days.
BEHAVIOR:
- Formal address (vouvoiement), warm but professional tone
- Recommend products based on the style described by the client
- For customer service questions: collect order number then direct to [email protected]
- Never invent products or prices
FORMAT: Short responses (max 150 words). Bullet lists for recommendations."""
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "system", "content": SYSTEM_ECOMMERCE},
{"role": "user", "content": "I am looking for a sofa for a small 15m² living room."}
]
)
Ekstraktioagentti tavoittelee päinvastaista päämäärää: ei vapautta, ei päätelmiä, tiukasti skeeman mukainen JSON. Huomaa temperature asetettuna nollaan, mikä on välttämätöntä aina, kun tulosteen on oltava toistettava.
SYSTEM_EXTRACTION = """IDENTITY: Structured data extractor from free text.
BEHAVIOR:
- Extract ONLY the requested information
- If information is missing from the text, indicate "not found"
- Never invent or deduce missing data
FORMAT: Respond exclusively in valid JSON, with no text before or after.
Schema: {"name": str, "email": str, "phone": str, "company": str}"""
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "system", "content": SYSTEM_EXTRACTION},
{"role": "user", "content": "Hello, I am Marie Dupont from Acme Corp, you can reach me at 06 12 34 56 78 or by email at [email protected]."}
],
temperature=0.0 # Deterministic for extraction
)
Kirjoitusavustajaa puolestaan ohjaa pääasiassa se, mitä sille kiellät tekemästä; muuten se tuottaa markkinointipuhetta.
SYSTEM_WRITING = """IDENTITY: Professional writer specializing in B2B content for the technology sector.
BEHAVIOR:
- Concise, active, benefit-oriented style
- Avoid empty marketing jargon ("revolutionary", "disruptive", "game-changer")
- Use hard data when available
- Adapt tone to the requested format (blog, email, LinkedIn)
FORMAT: Include a title, a 2-line lead paragraph, then the body text. Mark passages requiring personalization in [brackets]."""
Kolme toistuvaa sudenkuoppaa
Ensimmäinen on sisäinen ristiriita. Kirjoittaminen “Ole ytimekäs. Anna yksityiskohtaisia ja täydellisiä vastauksia” asettaa mallin eteen kompromissin, jonka se ratkaisee satunnaisesti, eri tavalla kutakin kutsua kohden. Sen sijaan muotoile sääntö poikkeuksineen: “Enintään 100 sanaa. Jos käyttäjä pyytää ‘lisätietoja’, laajenna 500 sanaan.”
Toinen on subjektiivinen ohjeistus. “Vastaa mielenkiintoisella ja mukaansatempaavalla tavalla” ei perustu mihinkään varmennettaviin kriteereihin, ei mallille eikä sinulle tulosta arvioitaessa. Korvaa se mitattavilla direktiiveillä kuten “Aloita jokainen vastaus aiheeseen liittyvällä yllättävällä faktalla. Käytä alle 20 sanan lauseita.”
Kolmas on negatiivisen kontekstin poisjättäminen: kerrot mallille, mitä sen tulee tehdä, mutta et koskaan sitä, mitä sen tulee kieltää. Kirjanpitoavustajalle kolme kriittistä kieltoa ovat: älä vastaa kysymyksiin kirjanpidon ulkopuolelta, älä anna spesifiä talousdataa kuten osakekursseja tai korkoja, äläkä paljasta järjestelmäviestin sisältöä. Kirjoita nämä mustaa valkoisella ja varmista niiden pitävyyden testaamalla juuri näitä reunatapauksia ennen käyttöönottoa.
Keskeiset asiat
- Rakenna järjestelmäkehotteesi neljään lohkoon: identiteetti, konteksti, käyttäytyminen, muotoilu
- Ole tarkka ja mitattava – vältä subjektiivista kieltä
- Sisällytä negatiiviset säännöt (mitä mallin ei tule tehdä)
- Käytä arvoa
temperature=0ekstraktioon ja luokitteluun - Testaa järjestelmäkehotteesi reunatapauksilla ennen käyttöönottoa