Systemski promptovi za API agente
Na ovoj stranici
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.