Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Systemové prompty pro API agenty

Lekce 14 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Tvorba agentů s grok-build-0.1
  2. Anatomie dobrého systémového promptu
  3. Strukturování pomocí Markdownu nebo XML
  4. Optimalizace mezipaměti
  5. Kompletní příklad: Agent pro generování testů
  6. Klíčové poznatky
  7. Ověř si své znalosti

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ě.