Systemové prompty pro API agenty
Na této stránce
Tvorba agentů s grok-build-0.1
Pokud vyvíjíš vlastní vývojářské nástroje – agenta pro kontrolu kódu, asistenta nasazení nebo nástroj pro generování dokumentace – budeš přímo komunikovat s API xAI. Systémový prompt je tvým hlavním nástrojem pro řízení chování modelu.
Anatomie dobrého systémového promptu
Efektivní systémový prompt pro agenta založeného na grok-build-0.1 obsahuje čtyři sekce:
1. Popis úkolu
Začni jasnou definicí toho, co agent dělá:
## Role
Jsi asistent pro kontrolu kódu specializovaný na TypeScript.
Analyzuješ rozdíly v kódu (diffy), abys identifikoval potenciální chyby,
problémy s výkonem a porušení konvencí.
2. Očekávání a formát výstupu
Popiš, co od modelu očekáváš:
## Formát výstupu
Pro každý identifikovaný problém uveď:
- Soubor a řádek, kterých se týká
- Závažnost (kritická, varování, info)
- Popis problému
- Návrh opravy s ukázkou kódu
3. Hraniční případy
Předvídej nejednoznačné situace:
## Hraniční případy
- Pokud je diff prázdný, odpověz „Žádné změny k analýze“
- Pokud je kód v nepodporovaném jazyce, uveď to
- Nekomentuj změny formátování (mezery, odsazení)
- Ignoruj generované konfigurační soubory (.lock, dist/)
4. Omezení
Definuj limity:
## Omezení
- Maximálně 10 komentářů na jednu kontrolu
- Upřednostni kritické chyby před návrhy stylu
- Nenavrhuji zásadní refaktoring pro drobné opravy
Strukturování pomocí Markdownu nebo XML
Model je zvyklý vidět v prvním promptu rozsáhlý a strukturovaný kontext. Fungují dobře dva formáty:
Markdown (doporučeno pro čitelnost)
## Role
Popis role...
## Dostupné nástroje
- read_file: přečte soubor projektu
- write_file: upraví soubor
- run_command: spustí příkaz v terminálu
## Pravidla
1. Před úpravou souboru jej vždy přečti
2. Před smazáním kódu si vyžádej potvrzení
3. Po každé úpravě spusť testy
XML (doporučeno pro přesnost)
<agent>
<role>Asistent pro kontrolu kódu v TypeScriptu</role>
<tools>
<tool name="read_file">Přečte soubor projektu</tool>
<tool name="write_file">Upraví soubor</tool>
</tools>
<rules>
<rule>Před úpravou souboru jej vždy přečti</rule>
<rule>Před smazáním kódu si vyžádej potvrzení</rule>
</rules>
</agent>
Oba formáty jsou účinné. Markdown se snadněji udržuje; XML je pro automatické parsování strukturovanější.
Optimalizace mezipaměti
Pamatuj na lekci o cachování: systémový prompt musí být stabilní. Napiš jej jednou, kompletně, a během relace jej neměň. Pokud potřebuješ změnit chování agenta, přidej pokyny do uživatelské zprávy, místo abys měnil systémový prompt.
Kompletní příklad: Agent pro generování testů
## Role
Jsi agent, který generuje unit testy pro kód v TypeScriptu.
Jako testovací framework používáš Vitest.
## Proces
1. Přečti zdrojový soubor pomocí read_file
2. Identifikuj exportované funkce
3. Pro každou funkci vygeneruj testy pokrývající:
- Nominální případ
- Hraniční případy (null, undefined, prázdné pole)
- Chybové případy
4. Zapiš testy pomocí write_file do složky __tests__/
5. Spusť testy pomocí run_command("npx vitest run")
## Konvence
- Pojmenování: {file}.test.ts
- Struktura: describe > it > expect
- Pro komplexní data používej fixtury
- Mockuj externí závislosti (API, DB)
## Omezení
- Neupravuj zdrojový kód
- Pokud test selže, oprav test, nikoliv zdrojový kód
- Maximálně 20 testů na soubor
Tento systémový prompt poskytuje agentovi všechny informace potřebné k autonomnímu provozu, přičemž zůstává v rámci definovaných limitů.
Klíčové poznatky
- Systémový prompt strukturuje chování agenta do 4 částí: role, očekávání, hraniční případy, omezení
- K strukturování sekcí použij Markdown nebo XML
- Systémový prompt musí být stabilní pro optimalizaci cachování
- U sekvenčních agentů zahrň procesy krok za krokem
- Vždy definuj hraniční případy, abys předešel neočekávanému chování
Ověř si své znalosti
grok-build ve tvých editorech: převzetí plné kontroly.
1. Co je grok-build-0.1?
Odpověď: Agentic kódový model od xAI: nativní volání nástrojů, streamované uvažování, kontext přizpůsobený vývojářským úkolům – motor stojící za Grok Build a integracemi do editorů.
2. Jak jej použít ve svém editoru?
Odpověď: Prostřednictvím integrací: Cline ve VS Code, Cursor, GitHub Copilot, Windsurf a další – API xAI kompatibilní s OpenAI umožňuje přímou integraci.
3. Jaké návyky zajišťují dobré úkoly pro kód?
Odpověď: Specifikuj kontext (soubory, omezení), definuj jasné a ověřitelné cíle, iteruj postupně – a optimalizuj cachování udržováním stabilních prefixů.
4. grok-build-0.1 nebo grok-4.5 pro kód?
Odpověď: grok-build pro běžné agentic vývojářské úkoly (rychlý, specializovaný); grok-4.5, když úkol vyžaduje maximální uvažování – volba závisí na obtížnosti.
5. Co patří do systémového promptu API kódového agenta?
Odpověď: Role, konvence projektu, pravidla pro úpravy (testy, styl) a limity – rámec, který mění kódový model na člena týmu pro tvou kódovou základnu.
Specializovaný model, propojený editor, čisté úkoly, rámcované prompty: Vývoj s pomocí Grok se redukuje na čtyři rozhodnutí – všechna učiněná záměrně.