Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Systeemprompts voor API-agents

Les 14 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Agents bouwen met grok-build-0.1
  2. Anatomie van een goede systeemprompt
  3. Structureren met Markdown of XML
  4. Cache-optimalisatie
  5. Volledig voorbeeld: Testgeneratie-agent
  6. Belangrijkste punten
  7. Test uw kennis

Agents bouwen met grok-build-0.1

Als u uw eigen ontwikkeltools bouwt—een code review-agent, een deployment-assistent, een tool voor het genereren van documentatie—werkt u direct met de xAI API. De systeemprompt is uw belangrijkste middel om het gedrag van het model te sturen.

Anatomie van een goede systeemprompt

Een effectieve systeemprompt voor een agent op basis van grok-build-0.1 bevat vier secties:

1. Taakbeschrijving

Begin met een duidelijke definitie van wat de agent doet:

## Rol
U bent een code review-assistent gespecialiseerd in TypeScript.
U analyseert code-diffs om potentiële bugs,
prestatieproblemen en schendingen van conventies op te sporen.

2. Verwachtingen en uitvoerformaat

Beschrijf wat u van het model verwacht:

## Uitvoerformaat
Voor elk geïdentificeerd probleem levert u:
- Het betrokken bestand en regelnummer
- Ernstgraad (kritiek, waarschuwing, info)
- Een beschrijving van het probleem
- Een correctievoorstel met een codevoorbeeld

3. Randgevallen

Anticipeer op dubbelzinnige situaties:

## Randgevallen
- Als de diff leeg is, antwoordt u "Geen wijzigingen om te analyseren"
- Als de code in een niet-ondersteunde taal is, geeft u dit aan
- Reageer niet op opmaakwijzigingen (spaties, inspringing)
- Negeer gegenereerde configuratiebestanden (.lock, dist/)

4. Beperkingen

Stel grenzen:

## Beperkingen
- Maximaal 10 opmerkingen per review
- Geef prioriteit aan kritieke bugs boven stijlsuggesties
- Stel geen grote refactoring voor bij kleine fixes

Structureren met Markdown of XML

Het model is gewend om uitgebreide, gestructureerde context in de eerste prompt te zien. Twee formaten werken goed:

Markdown (aanbevolen voor leesbaarheid)

## Rol
Rolbeschrijving...

## Beschikbare tools
- read_file: lees een projectbestand
- write_file: wijzig een bestand
- run_command: voer een terminalcommando uit

## Regels
1. Lees altijd het bestand voordat u het wijzigt
2. Vraag om bevestiging voordat u code verwijdert
3. Voer tests uit na elke wijziging

XML (aanbevolen voor precisie)

<agent>
  <role>TypeScript code review-assistent</role>
  <tools>
    <tool name="read_file">Lees een projectbestand</tool>
    <tool name="write_file">Wijzig een bestand</tool>
  </tools>
  <rules>
    <rule>Lees altijd het bestand voordat u het wijzigt</rule>
    <rule>Vraag om bevestiging voordat u code verwijdert</rule>
  </rules>
</agent>

Beide formaten zijn effectief. Markdown is eenvoudiger te onderhouden; XML is gestructureerder voor automatische parsing.

Cache-optimalisatie

Onthoud de les over caching: de systeemprompt moet stabiel zijn. Schrijf deze één keer, volledig, en wijzig deze niet tijdens de sessie. Als u het gedrag van de agent moet aanpassen, voegt u instructies toe in het gebruikersbericht in plaats van de systeemprompt te wijzigen.

Volledig voorbeeld: Testgeneratie-agent

## Rol
U bent een agent die unit-tests genereert voor TypeScript-code.
U gebruikt Vitest als testframework.

## Proces
1. Lees het bronbestand met read_file
2. Identificeer geëxporteerde functies
3. Genereer voor elke functie tests die het volgende dekken:
   - Het nominale geval
   - Randgevallen (null, undefined, lege array)
   - Foutgevallen
4. Schrijf tests met write_file in de __tests__/ map
5. Voer tests uit met run_command("npx vitest run")

## Conventies
- Naamgeving: {file}.test.ts
- Structuur: describe > it > expect
- Gebruik fixtures voor complexe data
- Mock externe afhankelijkheden (API, DB)

## Beperkingen
- Wijzig geen broncode
- Als een test faalt, repareer dan de test, niet de broncode
- Maximaal 20 tests per bestand

Deze systeemprompt geeft de agent alle benodigde informatie om autonoom te opereren, binnen de gestelde grenzen.

Belangrijkste punten

  • De systeemprompt structureert het gedrag van de agent in 4 delen: rol, verwachtingen, randgevallen, beperkingen
  • Gebruik Markdown of XML om secties te structureren
  • De systeemprompt moet stabiel zijn om caching te optimaliseren
  • Neem stap-voor-stap processen op voor sequentiële agents
  • Definieer altijd randgevallen om onverwacht gedrag te voorkomen

Test uw kennis

grok-build in uw editors: de ultieme controle overnemen.

1. Wat is grok-build-0.1?

Antwoord: Het agentische codemodel van xAI: native tool-aanroepen, streamende redenering, context aangepast voor ontwikkeltaken—de motor achter Grok Build en editor-integraties.

2. Hoe gebruikt u het in uw editor?

Antwoord: Via integraties: Cline in VS Code, Cursor, GitHub Copilot, Windsurf en anderen—de met OpenAI compatibele xAI API maakt directe integratie mogelijk.

3. Welke gewoonten zorgen voor goede codetaken?

Antwoord: Specificeer context (bestanden, beperkingen), definieer duidelijke en verifieerbare doelen, iteratie progressief—en optimaliseer caching door prefixes stabiel te houden.

4. grok-build-0.1 of grok-4.5 voor code?

Antwoord: grok-build voor dagelijkse agentische ontwikkeltaken (snel, gespecialiseerd); grok-4.5 wanneer de taak maximale redenering vereist—de keuze volgt de moeilijkheidsgraad.

5. Wat hoort in de systeemprompt van een API-code-agent?

Antwoord: De rol, projectconventies, bewerkingsregels (tests, stijl) en limieten—het kader dat een codemodel omvormt tot een teamgenoot voor uw codebase.

Gespecialiseerd model, verbonden editor, heldere taken, omkaderde prompts: ontwikkeling met Grok-hulp komt neer op vier keuzes—allemaal bewust gemaakt.