Rendszerutasítások API-ügynökök számára
Ezen az oldalon
Ü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.