Systemprompts til API-agenter
På denne side
Bygning af agenter med grok-build-0.1
Hvis du udvikler dine egne udviklingsværktøjer – en kodeanmeldelsesagent, en implementeringsassistent eller et værktøj til generering af dokumentation – vil du interagere direkte med xAI API’en. Systemprompten er dit primære løftestang til at styre modellens adfærd.
Anatomien af en god systemprompt
En effektiv systemprompt til en agent baseret på grok-build-0.1 indeholder fire sektioner:
1. Opgavebeskrivelse
Start med klart at definere, hvad agenten gør:
## Rolle
Du er en kodeanmeldelsesassistent specialiseret i TypeScript.
Du analyserer kode-diffs for at identificere potentielle fejl,
ydelsesproblemer og overtrædelser af konventioner.
2. Forventninger og outputformat
Beskriv, hvad du forventer af modellen:
## Outputformat
For hvert identificeret problem skal du levere:
- Filen og linjen, der er involveret
- Alvorlighedsgrad (kritisk, advarsel, info)
- En beskrivelse af problemet
- Et forslag til korrektion med et kodeeksempel
3. Kanttilfælde
Forudsig tvetydige situationer:
## Kanttilfælde
- Hvis diffen er tom, svar da "Ingen ændringer at analysere"
- Hvis koden er på et ikke-understøttet sprog, så angiv det
- Kommentér ikke formatteringsændringer (mellemrum, indrykning)
- Ignorér genererede konfigurationsfiler (.lock, dist/)
4. Begrænsninger
Definér grænser:
## Begrænsninger
- Maksimalt 10 kommentarer pr. gennemgang
- Prioritér kritiske fejl frem for stilforslag
- Foreslå ikke større refaktorering for mindre rettelser
Strukturering med Markdown eller XML
Modellen er vant til at se omfattende, struktureret kontekst i den første prompt. To formater fungerer godt:
Markdown (Anbefales til læsbarhed)
## Rolle
Rollebeskrivelse...
## Tilgængelige værktøjer
- read_file: læs en projektfil
- write_file: modificér en fil
- run_command: udfør en terminalkommando
## Regler
1. Læs altid filen, før du modificerer den
2. Spørg om bekræftelse, før du sletter kode
3. Kør tests efter hver modificering
XML (Anbefales til præcision)
<agent>
<role>TypeScript kodeanmeldelsesassistent</role>
<tools>
<tool name="read_file">Læs en projektfil</tool>
<tool name="write_file">Modificér en fil</tool>
</tools>
<rules>
<rule>Læs altid filen, før du modificerer den</rule>
<rule>Spørg om bekræftelse, før du sletter kode</rule>
</rules>
</agent>
Begge formater er effektive. Markdown er lettere at vedligeholde; XML er mere struktureret til automatisk parsing.
Cache-optimering
Husk lektionen om cachelagring: systemprompten skal være stabil. Skriv den én gang, fuldstændigt, og modificér den ikke under sessionen. Hvis du har brug for at ændre agentens adfærd, skal du tilføje instrukser i brugerbeskeden i stedet for at modificere systemprompten.
Komplet eksempel: Agent til testgenerering
## Rolle
Du er en agent, der genererer unit-tests til TypeScript-kode.
Du bruger Vitest som testframework.
## Proces
1. Læs kildefilen med read_file
2. Identificér eksporterede funktioner
3. For hver funktion skal du generere tests, der dækker:
- Det nominelle tilfælde
- Kanttilfælde (null, undefined, tom array)
- Fejltilfælde
4. Skriv tests med write_file i mappen __tests__/
5. Kør tests med run_command("npx vitest run")
## Konventioner
- Navngivning: {fil}.test.ts
- Struktur: describe > it > expect
- Brug fixtures til komplekse data
- Mock eksterne afhængigheder (API, DB)
## Begrænsninger
- Modificér ikke kildekoden
- Hvis en test fejler, så ret testen, ikke kildekoden
- Maksimalt 20 tests pr. fil
Denne systemprompt giver agenten alle de nødvendige oplysninger for at operere autonomt, mens den holder sig inden for definerede grænser.
Vigtige pointer
- Systemprompten strukturerer agentadfærd i 4 dele: rolle, forventninger, kanttilfælde, begrænsninger
- Brug Markdown eller XML til at strukturere sektioner
- Systemprompten skal være stabil for at optimere cachelagring
- Inkludér trin-for-trin-processer for sekventielle agenter
- Definé altid kanttilfælde for at undgå uventede adfærdsmønstre
Test din viden
grok-build i dine editorer: tag fuld kontrol.
1. Hvad er grok-build-0.1?
Svar: xAI’s agentiske kodemodel: indbygget værktøjskald, streamende ræsonnement, kontekst tilpasset udviklingsopgaver – motoren bag Grok Build og editorintegrationer.
2. Hvordan bruger du det i din editor?
Svar: Via integrationer: Cline i VS Code, Cursor, GitHub Copilot, Windsurf og andre – den OpenAI-kompatible xAI API gør direkte integration mulig.
3. Hvilke vaner sikrer gode kodeopgaver?
Svar: Specificér kontekst (filer, begrænsninger), definér klare og verificerbare mål, iterér progressivt – og optimer cachelagring ved at holde præfikser stabile.
4. grok-build-0.1 eller grok-4.5 til kode?
Svar: grok-build til daglige agentiske udviklingsopgaver (hurtig, specialiseret); grok-4.5 når opgaven kræver maksimal ræsonnementsevne – valget følger sværhedsgraden.
5. Hvad skal indgå i systemprompten til en API-kodeagent?
Svar: Rollen, projektkonventioner, redigeringsregler (tests, stil) og grænser – den indramning, der gør en kodemodel til en holdkammerat til din kodebase.
Specialiseret model, forbundet editor, rene opgaver, indrammede prompts: Grok-assisteret udvikling koges ned til fire valg – alle truffet bevidst.