Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Süsteemikäsud API-agentidele

Õppetund 14 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Agentide loomine mudeliga grok-build-0.1
  2. Hea süsteemikäsu anatoomia
  3. Struktureerimine Markdowni või XML-iga
  4. Vahemälu optimeerimine
  5. Täielik näide: testide genereerimise agent
  6. Peamised punktid
  7. Testi oma teadmisi

Agentide loomine mudeliga grok-build-0.1

Kui arendad oma arendustööriistu – olgu selleks koodi ülevaatuse agent, kasutuselevõtu assistent või dokumentatsiooni genereerimise tööriist – suhtled otse xAI API-ga. Süsteemikäsk on sinu peamine hoob mudeli käitumise juhtimiseks.

Hea süsteemikäsu anatoomia

Tõhus süsteemikäsk agendile, mis põhineb mudelil grok-build-0.1, koosneb neljast osast:

1. Ülesande kirjeldus

Alusta selge määratlusega, mida agent teeb:

## Roll
Oled TypeScripti spetsialiseerunud koodi ülevaatuse assistent.
Analüüsid koodi erinevusi, et tuvastada võimalikke vigu,
jõudlusprobleeme ja kokkulepete rikkumisi.

2. Ootused ja väljundvorming

Kirjelda, mida mudelilt ootad:

## Väljundvorming
Iga tuvastatud probleemi kohta esita:
- Asjaomane fail ja rida
- Tõsidusaste (kriitiline, hoiatus, info)
- Probleemi kirjeldus
- Parandusettepanek koos koodinäitega

3. Piirjuhtumid

Enneta mitmetimõistetavaid olukordi:

## Piirjuhtumid
- Kui erinevuste loend on tühi, vasta "Muudatusi pole analüüsida"
- Kui kood on toetamata keeles, märgi seda
- Ära kommenteeri vormindusmuudatusi (tühikud, taanded)
- Eira genereeritud konfiguratsioonifaile (.lock, dist/)

4. Piirangud

Määratle limiidid:

## Piirangud
- Maksimaalselt 10 kommentaari ülevaatuse kohta
- Seada kriitilised vead stiilisoovitustest kõrgemale
- Ära soovita suuremahulist refaktoreerimist väiksemate paranduste jaoks

Struktureerimine Markdowni või XML-iga

Mudel on harjunud nägema esimeses käsus mahukat ja struktureeritud konteksti. Hästi toimivad kaks vormingut:

Markdown (soovitatav loetavuse tõttu)

## Roll
Rolli kirjeldus...

## Saadaolevad tööriistad
- read_file: loe projekti fail
- write_file: muuda faili
- run_command: käivita terminalikäsk

## Reeglid
1. Loeta fail enne selle muutmist alati läbi
2. Küsi koodi kustutamiseks kinnitust
3. Käivita testid pärast iga muudatust

XML (soovitatav täpsuse tõttu)

<agent>
  <role>TypeScripti koodi ülevaatuse assistent</role>
  <tools>
    <tool name="read_file">Loe projekti fail</tool>
    <tool name="write_file">Muuda faili</tool>
  </tools>
  <rules>
    <rule>Loeta fail enne selle muutmist alati läbi</rule>
    <rule>Küsi koodi kustutamiseks kinnitust</rule>
  </rules>
</agent>

Mõlemad vormingud on tõhusad. Markdowni on lihtsam hallata; XML on automaatseks parsimiseks struktureeritum.

Vahemälu optimeerimine

Pea meeles vahemälu käsitlevat õppetundi: süsteemikäsk peab olema stabiilne. Kirjuta see üks kord, terviklikult, ja ära muuda seda sessiooni vältel. Kui sul on vaja agenti käitumist muuta, lisa juhised kasutaja sõnumisse, selle asemel et süsteemikäsku muuta.

Täielik näide: testide genereerimise agent

## Roll
Oled agent, mis genereerib TypeScripti koodile üksusteste.
Kasutad testiraamistikuna Vitesti.

## Protsess
1. Loe lähtefail käsuga read_file
2. Tuvasta eksporditud funktsioonid
3. Iga funktsiooni jaoks genereeri testid, mis katavad:
   - Nominaaljuhu
   - Piirjuhtumid (null, undefined, tühi massiiv)
   - Veajuhtumid
4. Kirjuta testid käsuga write_file kausta __tests__/
5. Käivita testid käsuga run_command("npx vitest run")

## Kokkulepped
- Nimestik: {fail}.test.ts
- Struktuur: describe > it > expect
- Kasuta fikstuure keerukate andmete jaoks
- Mocki välised sõltuvused (API, andmebaas)

## Piirangud
- Ära muuda lähtekoodi
- Kui test ebaõnnestub, paranda testi, mitte lähtekoodi
- Maksimaalselt 20 testi faili kohta

See süsteemikäsk annab agendile kogu vajaliku teabe autonoomseks tegutsemiseks, püsides samas määratletud piirides.

Peamised punktid

  • Süsteemikäsk struktureerib agenti käitumist neljas osas: roll, ootused, piirjuhtumid, piirangud
  • Kasuta sektsioonide struktureerimiseks Markdowni või XML-i
  • Süsteemikäsk peab olema stabiilne vahemälu optimeerimiseks
  • Lisa samm-sammulised protsessid järjestikuste agentide jaoks
  • Määratle alati piirjuhtumid, et vältida ootamatut käitumist

Testi oma teadmisi

grok-build sinu toimetajates: lõpliku kontrolli haaramine.

1. Mis on grok-build-0.1?

Vastus: xAI agentne koodimudel: loomulik tööriistade kutsumine, voogedastav arutluskäik, arendusülesanneteks kohandatud kontekst – mootor, mis seisab Grok Buildi ja toimetajate integratsioonide taga.

2. Kuidas seda oma toimetajas kasutada?

Vastus: Integratsioonide kaudu: Cline VS Code’is, Cursor, GitHub Copilot, Windsurf ja teised – OpenAI-ga ühilduv xAI API võimaldab otsest integreerimist.

3. Millised harjumused tagavad head koodiülesanded?

Vastus: Määra kontekst (failid, piirangud), defineeri selged ja kontrollitavad eesmärgid, iterreeri järk-järgult – ja optimeeri vahemälu, hoides prefiksid stabiilsena.

4. grok-build-0.1 või grok-4.5 koodi jaoks?

Vastus: grok-build igapäevasteks arendusagentide ülesanneteks (kiire, spetsialiseerunud); grok-4.5, kui ülesanne nõuab maksimaalset arutlusvõimet – valik sõltub raskusastmest.

5. Mis kuulub API koodiagendi süsteemikäsku?

Vastus: Roll, projekti kokkulepped, redigeerimisreeglid (testid, stiil) ja limiidid – raamistik, mis muudab koodimudeli sinu koodibaasi meeskonnaliikmeks.

Spetsialiseeritud mudel, ühendatud toimetaja, puhtad ülesanded, raamistatud käsud: Groki abistatud arendus taandub neljale valikule – kõik tehtud teadlikult.