Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Sistemski pozivi za agente API

Lekcija 14 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Gradnja agentov z grok-build-0.1
  2. Anatomija dobrega sistemskega poziva
  3. Strukturiranje z Markdownom ali XML-jem
  4. Optimizacija predpomnilnika
  5. Celoten primer: Agent za generiranje testov
  6. Ključne ugotovitve
  7. Preveri svoje znanje

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.