Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Systemski promptovi za API agente

Lekcija 14 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Izgradnja agenata s grok-build-0.1
  2. Anatomija dobrog systemskog prompta
  3. Strukturiranje s Markdownom ili XML-om
  4. Optimizacija cachea
  5. Cjeloviti primjer: Agent za generiranje testova
  6. Ključne točke
  7. Provjeri svoje znanje

Izgradnja agenata s grok-build-0.1

Ako razvijaš vlastite razvojne alate – agenta za pregled koda, asistenta za implementaciju ili alat za generiranje dokumentacije – izravno ćeš komunicirati s xAI API-jem. Systemski prompt tvoj je glavni poluga za upravljanje ponašanjem modela.

Anatomija dobrog systemskog prompta

Učinkovit systemski prompt za agenta temeljenog na grok-build-0.1 sadrži četiri dijela:

1. Opis zadatka

Započni jasnim definiranjem što agent radi:

## Uloga
Ti si asistent za pregled koda specijaliziran za TypeScript.
Analiziraš razlike u kodu (diffs) kako bi identificirao potencijalne bugove,
probleme s performansama i kršenja konvencija.

2. Očekivanja i format izlaza

Opiši što očekuješ od modela:

## Format izlaza
Za svaki identificirani problem navedi:
- Datoteku i redak koji su uključeni
- Ozbiljnost (kritično, upozorenje, info)
- Opis problema
- Prijedlog ispravka s primjerom koda

3. Rubni slučajevi

Predvidi dvosmislene situacije:

## Rubni slučajevi
- Ako je diff prazan, odgovori "Nema promjena za analizu"
- Ako je kod u nepodržanom jeziku, naznači to
- Ne komentiraj promjene formatiranja (razmaci, uvlačenje)
- Ignoriraj generirane konfiguracijske datoteke (.lock, dist/)

4. Ograničenja

Definiraj limite:

## Ograničenja
- Maksimalno 10 komentara po pregledu
- Daj prednost kritičnim bugovima u odnosu na prijedloge stilova
- Ne predlaži veliko refaktoriranje za manje popravke

Strukturiranje s Markdownom ili XML-om

Model je naviknut vidjeti opsežan, strukturiran kontekst u prvom promptu. Dva formata dobro funkcioniraju:

Markdown (preporučeno za čitljivost)

## Uloga
Opis uloge...

## Dostupni alati
- read_file: čitanje projektne datoteke
- write_file: modificiranje datoteke
- run_command: izvršavanje terminalne naredbe

## Pravila
1. Uvijek pročitaj datoteku prije modificiranja
2. Zatraži potvrdu prije brisanja koda
3. Pokreni testove nakon svake modifikacije

XML (preporučeno za preciznost)

<agent>
  <role>TypeScript asistent za pregled koda</role>
  <tools>
    <tool name="read_file">Čitanje projektne datoteke</tool>
    <tool name="write_file">Modificiranje datoteke</tool>
  </tools>
  <rules>
    <rule>Uvijek pročitaj datoteku prije modificiranja</rule>
    <rule>Zatraži potvrdu prije brisanja koda</rule>
  </rules>
</agent>

Oba formata su učinkovita. Markdown je lakše održavati; XML je strukturiraniji za automatsko parsiranje.

Optimizacija cachea

Sjeti se lekcije o cacheiranju: systemski prompt mora biti stabilan. Napiši ga jednom, u cijelosti, i nemoj ga mijenjati tijekom sesije. Ako trebaš promijeniti ponašanje agenta, dodaj upute u korisničku poruku umjesto modificiranja systemskog prompta.

Cjeloviti primjer: Agent za generiranje testova

## Uloga
Ti si agent koji generira jedinične testove za TypeScript kod.
Koristiš Vitest kao okvir za testiranje.

## Proces
1. Pročitaj izvornu datoteku s read_file
2. Identificiraj izvezene funkcije
3. Za svaku funkciju generiraj testove koji pokrivaju:
   - Nominalni slučaj
   - Rubne slučajeve (null, undefined, prazni niz)
   - Slučajeve s greškama
4. Zapiši testove s write_file u __tests__/ mapu
5. Pokreni testove s run_command("npx vitest run")

## Konvencije
- Imenovanje: {file}.test.ts
- Struktura: describe > it > expect
- Koristi fiksture za kompleksne podatke
- Mockaj vanjske ovisnosti (API, DB)

## Ograničenja
- Ne modificiraj izvorni kod
- Ako test padne, popravi test, a ne izvorni kod
- Maksimalno 20 testova po datoteci

Ovaj systemski prompt daje agentu sve potrebne informacije za autonoman rad, dok ostaje unutar definiranih limita.

Ključne točke

  • Systemski prompt strukturira ponašanje agenta u 4 dijela: uloga, očekivanja, rubni slučajevi, ograničenja
  • Koristi Markdown ili XML za strukturiranje sekcija
  • Systemski prompt mora biti stabilan radi optimizacije cachea
  • Uključi procese korak-po-korak za sekvencijalne agente
  • Uvijek definiraj rubne slučajeve kako bi izbjegao neočekivana ponašanja

Provjeri svoje znanje

grok-build u tvojim editorima: preuzimanje potpune kontrole.

1. Što je grok-build-0.1?

Odgovor: xAI-jev agentic model za kod: izvorno pozivanje alata, streamanje rezoniranja, kontekst prilagođen razvojnim zadacima – motor iza Grok Builda i integracija u editore.

2. Kako ga koristiš u svom editoru?

Odgovor: Putem integracija: Cline u VS Codeu, Cursor, GitHub Copilot, Windsurf i drugi – xAI API kompatibilan s OpenAI-jem omogućuje izravnu integraciju.

3. Koje navike osiguravaju dobre zadatke s kodom?

Odgovor: Odredi kontekst (datoteke, ograničenja), definiraj jasne i provjerljive ciljeve, iteriraj progresivno – i optimiziraj cache održavanjem stabilnih prefiksa.

4. grok-build-0.1 ili grok-4.5 za kod?

Odgovor: grok-build za svakodnevne agentic razvojne zadatke (brz, specijaliziran); grok-4.5 kada zadatak zahtijeva maksimalno rezoniranje – izbor slijedi težinu zadatka.

5. Što ide u systemski prompt API agenta za kod?

Odgovor: Uloga, konvencije projekta, pravila uređivanja (testovi, stil) i limiti – okvir koji pretvara model za kod u suradnika na tvojoj codebaseu.

Specijalizirani model, povezani editor, čisti zadaci, okvirani promptovi: razvoj uz pomoć Groka svodi se na četiri izbora – sve namjerno donesene.