Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Rendszerutasítások API-ügynökök számára

14. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Ügynökök építése a grok-build-0.1 segítségével
  2. Egy jó rendszerutasítás felépítése
  3. Strukturálás Markdownnal vagy XML-lel
  4. Gyorsítótárazás optimalizálása
  5. Teljes példa: Tesztgeneráló ügynök
  6. Főbb megállapítások
  7. Teszteld a tudásod!

Ügynökök építése a grok-build-0.1 segítségével

Ha saját fejlesztői eszközöket készítesz – legyen szó kódfelülvizsgálati ügynökről, telepítési asszisztensről vagy dokumentációgeneráló eszközről –, akkor közvetlenül az xAI API-val fogsz kommunikálni. A rendszerutasítás (system prompt) a legfontosabb eszközöd a modell viselkedésének irányításához.

Egy jó rendszerutasítás felépítése

Egy hatékony, grok-build-0.1 alapú ügynök rendszerutasítása négy részből áll:

1. Feladatleírás

Kezdd azzal, hogy egyértelműen meghatározod, mit csinál az ügynök:

## Szerep
Te egy TypeScript-re specializálódott kódfelülvizsgálati asszisztens vagy.
Kódeltéréseket (diff) elemzel, hogy azonosítsd a lehetséges hibákat,
teljesítményproblémákat és a konvenciók megsértését.

2. Elvárások és kimeneti formátum

Írd le, mit vársz el a modelltől:

## Kimeneti formátum
Minden azonosított problémához add meg:
- Az érintett fájlt és sorszámot
- A súlyosságot (kritikus, figyelmeztetés, információ)
- A probléma leírását
- Egy javaslattal a javításra, kódpéldával együtt

3. Szélsőséges esetek

Vedd számításba a kétértelmű helyzeteket:

## Szélsőséges esetek
- Ha az eltérés (diff) üres, válaszd ezt: „Nincs elemezhető változás“
- Ha a kód nem támogatott nyelven íródott, jelezd ezt
- Ne kommentáld a formázási változásokat (szóközök, behúzások)
- Hagyd figyelmen kívül a generált konfigurációs fájlokat (.lock, dist/)

4. Korlátozások

Határozd meg a kereteket:

## Korlátozások
- Maximum 10 megjegyzés felülvizsgálatonként
- A kritikus hibákat előnyben részesítsd a stílusjavaslatokkal szemben
- Ne javasolj nagyobb átalakítást apróbb javításokhoz

Strukturálás Markdownnal vagy XML-lel

A modell hozzászokott ahhoz, hogy az első utasításban jelentős, strukturált kontextust kapjon. Két formátum működik jól:

Markdown (ajánlott az olvashatóság miatt)

## Szerep
A szerep leírása...

## Elérhető eszközök
- read_file: projektfile olvasása
- write_file: fájl módosítása
- run_command: terminálparancs végrehajtása

## Szabályok
1. Mindig olvasd el a fájlt módosítás előtt
2. Kérj megerősítést kód törlése előtt
3. Minden módosítás után futtasd le a teszteket

XML (ajánlott a pontosság miatt)

<agent>
  <role>TypeScript kódfelülvizsgálati asszisztens</role>
  <tools>
    <tool name="read_file">Projektfile olvasása</tool>
    <tool name="write_file">Fájl módosítása</tool>
  </tools>
  <rules>
    <rule>Mindig olvasd el a fájlt módosítás előtt</rule>
    <rule>Kérj megerősítést kód törlése előtt</rule>
  </rules>
</agent>

Mindkét formátum hatékony. A Markdown könnyebben karbantartható; az XML strukturáltabb az automatikus feldolgozáshoz.

Gyorsítótárazás optimalizálása

Ne feledd a gyorsítótárazásról tanultakat: a rendszerutasításnak stabilnak kell lennie. Írd meg egyszer, teljesen, és ne módosítsd a munkamenet során. Ha meg kell változtatnod az ügynök viselkedését, adj utasításokat a felhasználói üzenetben, ahelyett, hogy módosítanád a rendszerutasítást.

Teljes példa: Tesztgeneráló ügynök

## Szerep
Te egy olyan ügynök vagy, aki egységteszteket generál TypeScript kódhoz.
A Vitest tesztelő keretrendszert használod.

## Folyamat
1. Olvasd el a forrásfájlt a read_file eszközzel
2. Azonosítsd az exportált függvényeket
3. Minden függvényhez generálj teszteket, amelyek lefedik:
   - Az alapvető esetet
   - A szélsőséges eseteket (null, undefined, üres tömb)
   - A hibaeseteket
4. Írd meg a teszteket a write_file eszközzel a __tests__/ mappába
5. Futtasd le a teszteket a run_command("npx vitest run") paranccsal

## Konvenciók
- Elnevezés: {file}.test.ts
- Struktúra: describe > it > expect
- Használj fixture-eket összetett adatokhoz
- Mockold a külső függőségeket (API, DB)

## Korlátozások
- Ne módosítsd a forráskódot
- Ha egy teszt sikertelen, javítsd a tesztet, ne a forráskódot
- Maximum 20 teszt fájlonként

Ez a rendszerutasítás minden szükséges információt megad az ügynöknek az autonóm működéshez, miközben betartja a meghatározott korlátokat.

Főbb megállapítások

  • A rendszerutasítás négy részre strukturálja az ügynök viselkedését: szerep, elvárások, szélsőséges esetek, korlátozások
  • Használj Markdownt vagy XML-t a szakaszok strukturálásához
  • A rendszerutasításnak stabilnak kell lennie a gyorsítótárazás optimalizálása érdekében
  • Tartalmazz lépésről lépésre kidolgozott folyamatokat a szekvenciális ügynökök számára
  • Mindig határozd meg a szélsőséges eseteket a váratlan viselkedések elkerülése érdekében

Teszteld a tudásod!

grok-build a szerkesztőidben: a teljes kontroll átvétele.

1. Mi az a grok-build-0.1?

Válasz: Az xAI ügynök-kódmodellje: natív eszközlehívás, streamelt következtetés, fejlesztési feladatokra szabott kontextus – ez a motor hajtja a Grok Buildet és a szerkesztőintegrációkat.

2. Hogyan használod a szerkesztődben?

Válasz: Integrációkon keresztül: Cline a VS Code-ban, Cursor, GitHub Copilot, Windsurf és mások – az OpenAI-kompatibilis xAI API lehetővé teszi a közvetlen integrációt.

3. Milyen szokások biztosítanak jó kódolási feladatokat?

Válasz: Add meg a kontextust (fájlok, korlátozások), határozz meg világos és ellenőrizhető célokat, iterálj fokozatosan – és optimalizáld a gyorsítótárazást a prefixek stabilan tartásával.

4. grok-build-0.1 vagy grok-4.5 kódoláshoz?

Válasz: grok-build a mindennapi fejlesztői ügynök-feladatokhoz (gyors, specializált); grok-4.5, amikor a feladat maximális következtetést igényel – a választás a nehézségtől függ.

5. Mi kerül egy API kódügynök rendszerutasításába?

Válasz: A szerep, a projekt konvenciói, a szerkesztési szabályok (tesztek, stílus) és a korlátok – ez a keretrendszer változtatja a kódmodellt a kódbázisod csapattársává.

Specializált modell, kapcsolódó szerkesztő, tiszta feladatok, keretezett utasítások: a Grok-kal segített fejlesztés négy döntésen múlik – amelyeket mind szándékosan hozunk meg.