Sistemski pozivi za agente API
Na tej strani
Gradnja agentov z grok-build-0.1
Če razvijaš svoja razvojna orodja – agenta za pregled kode, asistenta za uvajanje ali orodje za generiranje dokumentacije – boš neposredno komuniciral z API-jem xAI. Sistemski poziv je tvoja glavna vzvod za nadzor obnašanja modela.
Anatomija dobrega sistemskega poziva
Učinkovit sistemski poziv za agenta, ki temelji na grok-build-0.1, vsebuje štiri dele:
1. Opis naloge
Začni z jasno opredelitvijo, kaj agent počne:
## Vloga
Si asistent za pregled kode, specializiran za TypeScript.
Analiziraš razlike v kodi (diffs), da prepoznaš morebitne napake,
težave z zmogljivostjo in kršitve konvencij.
2. Pričakovanja in format izhoda
Opiši, kaj pričakuješ od modela:
## Format izhoda
Za vsako ugotovljeno težavo navedi:
- Datoteko in vrstico, ki sta vključeni
- Resnost (kritično, opozorilo, informacija)
- Opis težave
- Predlog popravka s primerom kode
3. Robni primeri
Predvidi dvoumne situacije:
## Robni primeri
- Če je razlika (diff) prazna, odgovori „Ni sprememb za analizo"
- Če je koda v nepodprtem jeziku, to navedi
- Ne komentiraj sprememb oblikovanja (presledki, zamiki)
- Prezri generirane konfiguracijske datoteke (.lock, dist/)
4. Omejitve
Določi meje:
## Omejitve
- Največ 10 komentarjev na pregled
- Prednost imajo kritične napake pred predlogi za slog
- Za manjše popravke ne predlagaj večjih refaktorizacij
Strukturiranje z Markdownom ali XML-jem
Model je vajen videti obsežen, strukturiran kontekst v prvem pozivu. Dobro delujeta dva formata:
Markdown (priporočljivo za berljivost)
## Vloga
Opis vloge...
## Razpoložljiva orodja
- read_file: preberi projektno datoteko
- write_file: spremeni datoteko
- run_command: izvedi ukaz v terminalu
## Pravila
1. Pred spremembo vedno preberi datoteko
2. Pred brisanjem kode zaprosi za potrditev
3. Po vsaki spremembi zaženi teste
XML (priporočljivo za natančnost)
<agent>
<role>TypeScript asistent za pregled kode</role>
<tools>
<tool name="read_file">Preberi projektno datoteko</tool>
<tool name="write_file">Spremeni datoteko</tool>
</tools>
<rules>
<rule>Pred spremembo vedno preberi datoteko</rule>
<rule>Pred brisanjem kode zaprosi za potrditev</rule>
</rules>
</agent>
Oba formata sta učinkovita. Markdown je lažje vzdrževati; XML je bolj strukturiran za samodejno razčlenjevanje.
Optimizacija predpomnilnika
Spomni se lekcije o predpomnjenju: sistemski poziv mora biti stabilen. Napiši ga enkrat, v celoti, in ga med sejo ne spreminjaj. Če moraš spremeniti obnašanje agenta, dodaj navodila v uporabniško sporočilo, namesto da bi spreminjal sistemski poziv.
Celoten primer: Agent za generiranje testov
## Vloga
Si agent, ki generira enotske teste za kodo TypeScript.
Uporabljaš testni okvir Vitest.
## Proces
1. Preberi izvorno datoteko z read_file
2. Identificiraj izvožene funkcije
3. Za vsako funkcijo generiraj teste, ki pokrivajo:
- Nominalni primer
- Robne primere (null, undefined, prazno polje)
- Primere napak
4. Zapiši teste z write_file v mapo __tests__/
5. Zaženi teste z run_command("npx vitest run")
## Konvencije
- Poimenovanje: {file}.test.ts
- Struktura: describe > it > expect
- Za kompleksne podatke uporabi fiksture
- Simuliraj zunanje odvisnosti (API, baza podatkov)
## Omejitve
- Ne spreminjaj izvorne kode
- Če test ne uspe, popravi test, ne izvorne kode
- Največ 20 testov na datoteko
Ta sistemski poziv agentu zagotavlja vse potrebne informacije za samostojno delovanje, hkrati pa ostaja znotraj določenih meja.
Ključne ugotovitve
- Sistemski poziv strukturira obnašanje agenta v 4 dele: vloga, pričakovanja, robni primeri, omejitve
- Za strukturiranje delov uporabi Markdown ali XML
- Sistemski poziv mora biti stabilen za optimizacijo predpomnjenja
- Zaporednim agentom vključi procese korak za korakom
- Vedno opredeli robne primere, da se izogneš nepričakovanim obnašanjem
Preveri svoje znanje
grok-build v tvojih urejevalnikih: prevzem končnega nadzora.
1. Kaj je grok-build-0.1?
Odgovor: Agentski kodni model xAI: izvorno klicanje orodij, pretok razmišljanja, kontekst prilagojen razvojnim nalogam – motor za Grok Build in integracije v urejevalnike.
2. Kako ga uporabiš v svojem urejevalniku?
Odgovor: Prek integracij: Cline v VS Code, Cursor, GitHub Copilot, Windsurf in drugi – združljivost API-ja xAI z OpenAI omogoča neposredno integracijo.
3. Katere navade zagotavljajo dobre naloge kodiranja?
Odgovor: Določi kontekst (datoteke, omejitve), opredeli jasne in preverljive cilje, iteriraj postopoma – in optimiziraj predpomnjenje s stabilnimi predponami.
4. grok-build-0.1 ali grok-4.5 za kodo?
Odgovor: grok-build za vsakodnevne agentske razvojne naloge (hiter, specializiran); grok-4.5, ko naloga zahteva največje razmišljanje – izbira sledi težavnosti.
5. Kaj spada v sistemski poziv kodnega agenta API?
Odgovor: Vloga, konvencije projekta, pravila urejanja (testi, slog) in omejitve – okvir, ki kodni model spremeni v sodelavca za tvojo kodo.
Specializiran model, povezan urejevalnik, čiste naloge, okvirjeni pozivi: razvoj s pomočjo Groka se свaja na štiri izbire – vse narejene namerno.