Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Systemové výzvy pre API agentov

Lekcia 14 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Budovanie agentov s grok-build-0.1
  2. Anatómia dobrej systémovej výzvy
  3. Štruktúrovanie pomocou Markdownu alebo XML
  4. Optimalizácia cache
  5. Kompletný príklad: Agent na generovanie testov
  6. Kľúčové poznatky
  7. Over si svoje vedomosti

Budovanie agentov s grok-build-0.1

Ak vyvíjaš svoje vlastné vývojárske nástroje – agenta na kontrolu kódu, asistenta nasadzovania alebo nástroj na generovanie dokumentácie – budeš priamo komunikovať s xAI API. Systémová výzva (system prompt) je tvojím hlavným nástrojom na riadenie správania modelu.

Anatómia dobrej systémovej výzvy

Efektívna systémová výzva pre agenta založeného na grok-build-0.1 obsahuje štyri časti:

1. Popis úlohy

Začni jasným definovaním toho, čo agent robí:

## Role
You are a code review assistant specialized in TypeScript.
You analyze code diffs to identify potential bugs,
performance issues, and convention violations.

2. Očakávania a formát výstupu

Opíš, čo od modelu očakávaš:

## Output Format
For each identified issue, provide:
- The file and line involved
- Severity (critical, warning, info)
- A description of the issue
- A correction suggestion with a code example

3. Hraničné prípady

Predvídaj nejednoznačné situácie:

## Edge Cases
- If the diff is empty, respond "No changes to analyze"
- If the code is in an unsupported language, indicate it
- Do not comment on formatting changes (spaces, indentation)
- Ignore generated config files (.lock, dist/)

4. Obmedzenia

Definuj limity:

## Constraints
- Maximum 10 comments per review
- Prioritize critical bugs over style suggestions
- Do not suggest major refactoring for minor fixes

Štruktúrovanie pomocou Markdownu alebo XML

Model je zvyknutý vidieť v prvej výzve rozsiahly a štruktúrovaný kontext. Dobre fungujú dva formáty:

Markdown (odporúčaný pre čitateľnosť)

## Role
Role description...

## Available Tools
- read_file: read a project file
- write_file: modify a file
- run_command: execute a terminal command

## Rules
1. Always read the file before modifying it
2. Ask for confirmation before deleting code
3. Run tests after each modification

XML (odporúčaný pre presnosť)

<agent>
  <role>TypeScript code review assistant</role>
  <tools>
    <tool name="read_file">Read a project file</tool>
    <tool name="write_file">Modify a file</tool>
  </tools>
  <rules>
    <rule>Always read the file before modifying it</rule>
    <rule>Ask for confirmation before deleting code</rule>
  </rules>
</agent>

Oba formáty sú účinné. Markdown sa ľahšie udržiava; XML je štruktúrovanejšie pre automatické parsovanie.

Optimalizácia cache

Pamätaj na lekciu o cachovaní: systémová výzva musí byť stabilná. Napíš ju raz, úplne a počas relácie ju už nemeniť. Ak potrebuješ zmeniť správanie agenta, pridaj inštrukcie do správy používateľa, namiesto úpravy systémovej výzvy.

Kompletný príklad: Agent na generovanie testov

## Role
You are an agent that generates unit tests for TypeScript code.
You use Vitest as the testing framework.

## Process
1. Read the source file with read_file
2. Identify exported functions
3. For each function, generate tests covering:
   - The nominal case
   - Edge cases (null, undefined, empty array)
   - Error cases
4. Write tests with write_file in the __tests__/ folder
5. Run tests with run_command("npx vitest run")

## Conventions
- Naming: {file}.test.ts
- Structure: describe > it > expect
- Use fixtures for complex data
- Mock external dependencies (API, DB)

## Constraints
- Do not modify source code
- If a test fails, fix the test, not the source code
- Maximum 20 tests per file

Táto systémová výzva poskytuje agentovi všetky potrebné informácie na autonómnu činnosť, pričom zostáva v rámci definovaných limitov.

Kľúčové poznatky

  • Systémová výzva štruktúruje správanie agenta do 4 častí: rola, očakávania, hraničné prípady, obmedzenia
  • Na štruktúrovanie sekcií použi Markdown alebo XML
  • Systémová výzva musí byť stabilná, aby sa optimalizovalo cachovanie
  • Pre sekvenčných agentov zahrň procesy krok za krokom
  • Vždy definuj hraničné prípady, aby sa predišlo neočakávaným správaniam

Over si svoje vedomosti

grok-build vo tvojich editoroch: preberáš plnú kontrolu.

1. Čo je grok-build-0.1?

Odpoveď: Agentic model kódu od xAI: natívne volanie nástrojov, streamované uvažovanie, kontext prispôsobený vývojárskym úlohám – motor stojaci za Grok Build a integráciami do editorov.

2. Ako ho používaš vo svojom editore?

Odpoveď: Prostredníctvom integrácií: Cline vo VS Code, Cursor, GitHub Copilot, Windsurf a ďalšie – API xAI kompatibilné s OpenAI umožňuje priamu integráciu.

3. Aké návyky zabezpečujú dobré úlohy týkajúce sa kódu?

Odpoveď: Špecifikuj kontext (súbory, obmedzenia), definuj jasné a overiteľné ciele, iteruj postupne – a optimalizuj cachovanie udržiavaním stabilných prefixov.

4. grok-build-0.1 alebo grok-4.5 na kód?

Odpoveď: grok-build na bežné agentic vývojárske úlohy (rýchly, špecializovaný); grok-4.5, keď úloha vyžaduje maximálne uvažovanie – výber závisí od náročnosti.

5. Čo patrí do systémovej výzvy API agenta pre kód?

Odpoveď: Rola, konvencie projektu, pravidlá úprav (testy, štýl) a limity – rámec, ktorý mení model kódu na tímového kolegu pre tvoju kódovú základňu.

Špecializovaný model, pripojený editor, čisté úlohy, rámec výziev: vývoj s pomocou Grok sa redukuje na štyri rozhodnutia – všetky urobené zámerne.