Strukturiranje vaših uputa
Na ovoj stranici
Zašto je struktura važna
Dobro strukturiran prompt nije luksuz – nužnost je. Mistral modeli treniraju se na golemim količinama strukturiranog teksta: tehničkoj dokumentaciji, člancima, izvornom kodu. Bolje razumiju i slijede tvoje upute kada su one jasno organizirane jer ta organizacija podsjeća na ono što su vidjeli milijardama puta tijekom treninga.
Zamisli da usmeno daješ upute kolegi miješajući sve: rok skriven u anegdoti, očekivani format ubačen na kraj rečenice, kontekst isporučen tek nakon same upute. Rezultat bi bio zbunjujuć, a kolega bi morao nagađati što je bitno. Isto vrijedi i za jezični model: struktura tvog prompta određuje jasnoću interpretacije. Ova lekcija daje ti dva alata za strukturiranje – Markdown i XML oznake – plus mrežu sekcija za organizaciju bilo kojeg složenog prompta.
Markdown: Prirodni standard
Markdown je najučinkovitiji format strukturiranja za Mistral modele, iz tri međusobno pojačavajuća razloga. Prvo, čitljiv je: tebi ga je lako pisati i pregledavati, što je važno kada prompt živi i evoluira unutar aplikacije. Drugo, modelu je poznat: Markdown se masovno pojavljuje u podacima za trening, pa model bez napora razumije njegove konvencije. Konačno, prirodno se parsira: model jasno identificira hijerarhiju naslova, popise i blokove koda te zaključuje relativnu važnost svake sekcije.
Evo kako to izgleda u primjeru konkurentske analize:
# Task
Write a competitive analysis report.
## Context
Company: TechCorp, B2B SaaS, French market
Main competitors: AlphaSoft, BetaCloud, GammaTech
## Expected Format
For each competitor, provide:
- **Strengths**: 3 points maximum
- **Weaknesses**: 3 points maximum
- **Pricing positioning**: low / medium / premium
## Constraints
- Maximum 800 words
- Professional and factual tone
- No strategic recommendations (analysis only)
Ovaj prompt koristi naslove (#, ##) za odvajanje sekcija, podebljani tekst za ključne elemente i nabrajanja za detalje. Model odmah razumije hijerarhiju: prvo zadatak, zatim kontekst, pa format, na kraju ograničenja. Isti ovaj dokument mogao biš predati ljudskom suradniku bez mijenjanja ijedne riječi – to je dobar znak.
XML oznake: Maksimalna preciznost
Markdown organizira; XML oznake razgraničavaju. Kada trebaš izolirati blokove podataka ili uputa bez dvosmislenosti – tipično kada tvoj prompt miješa upute i tekst koji treba obraditi – XML oznake posebno su učinkovite:
<instructions>
Analyze the provided text and extract named entities.
Categorize them into: people, organizations, locations.
</instructions>
<format>
Return the result in JSON with the structure:
{"people": [], "organizations": [], "locations": []}
</format>
<text>
President Macron met with the Director-General of the WHO in Geneva
to discuss European health strategy.
</text>
Prednost je u tome što model točno zna gdje svaka sekcija počinje i završava. Da tekst za analizu sadrži rečenicu koja nalikuje uputi – na primjer „izdvoj popis sudionika“ – oznake bi spriječile model da je pomiješa s tvojim uputama. Upravo to odvajanje između uputa i podataka čini XML vrijednim u produkcijskim promptovima.
Bitne sekcije strukturiranog prompta
Bez obzira na format koji odabereš, složeni prompt organizira se oko istih sekcija. Prva, i jedina obavezna, jest zadatak: uvijek jasno navedi što očekuješ, odmah na početku. „Zadatak: Prevedi sljedeći tekst s francuskog na engleski uz održavanje formalnog registra“ ne ostavlja nikakvu sumnju u misiju.
Slijedi kontekst, kada je potreban: pozadinske informacije koje model ne može pogoditi. Ako radiš za fintech startup koji gradi aplikaciju za upravljanje proračunom za pojedince u Francuskoj, reci to – bez tog detalja model će pisati za generičku publiku i morat ćeš sve raditi ispočetka.
Treća sekcija, pravila, okviruje ponašanje: eksplicitno navedi što model mora, a što ne smije raditi. Na primjer: koristi formalan ton, ne spominji brendove konkurenata, proizvodi odlomke od 50 do 100 riječi. Svako napisano pravilo je ispravak koji nećeš morati raditi ručno.
Četvrta sekcija, format izlaza: točno opiši oblik koji odgovor mora imati. „Vrati Markdown tablicu sa stupcima Kriterij | Ocjena (1-5) | Komentar“ proizvodi isporučivi materijal koji možeš izravno kopirati u svoj dokument, dok odsutnost upute proizvodi prozu koju trebaš doraditi.
Konačno, primjeri rješavaju preostale dvosmislenosti pokazujući očekivani rezultat. Ova je tehnika toliko moćna da ima vlastitu lekciju: detaljno ćemo joj se vratiti uz few-shot prompting.
Eksplicitne naspram implicitnih uputa
Mistral modeli ne nagađaju tvoje namjere: sve što ti je implicitno u glavi mora postati eksplicitno u tvom promptu. Usporedi „Sažmi ovaj članak“ s „Sažmi ovaj članak u 3 točke nabrajanja od najviše 20 riječi svaka. Zadrži ključne brojke. Koristi neutralan i činjeničan ton.“ Prva verzija prepušta modelu odluku o duljini, formatu i tonu – tri odluke koje on može donijeti drugačije od tebe. Druga ne ostavlja prostora za interpretaciju: model točno zna što treba proizvesti, a ti ćeš svaki put dobiti istu vrstu rezultata.
Piši kao da model ne zna ništa
Završimo s temeljnim pravilom: piši svoj prompt pod pretpostavkom da model ima nula konteksta o tvojoj situaciji. Čak i ako ti se nešto čini očitim – tko si, što želiš postići, za koju upotrebu, u kojem formatu – navedi to, oslanjajući se na sistemski prompt za trajne elemente. Pisac koji niže zahtjeve u istom razgovoru na kraju povjeruje da „model zna“; no čim se razgovor promijeni ili se prompt ponovno upotrijebi negdje drugdje, sve implicitno nestaje. Ovaj pristup „nula konteksta“ jamči dosljedne rezultate, bez obzira na stanje razgovora.
Ključne točke
- Strukturiraj svoje promptove s jasnim sekcijama (Markdown ili XML)
- Markdown je idealan za većinu slučajeva; XML oznake za izolaciju podataka
- Uvijek odvoj zadatak, kontekst, pravila i očekivani format
- Učini eksplicitnim sve što ti je implicitno u glavi
- Svaki prompt piši kao da model kreće ispočetka