Systempromptar för API-agenter
På denna sida
Bygga agenter med grok-build-0.1
Om du utvecklar dina egna utvecklingsverktyg – en kodgranskningsagent, en distributionsassistent eller ett verktyg för dokumentationsgenerering – kommer du att interagera direkt med xAI API:t. Systemprompten är din främsta hävstång för att styra modellens beteende.
Anatomin hos en bra systemprompt
En effektiv systemprompt för en agent baserad på grok-build-0.1 innehåller fyra delar:
1. Uppgiftsbeskrivning
Börja med att tydligt definiera vad agenten gör:
## Roll
Du är en kodgranskningsassistent specialiserad på TypeScript.
Du analyserar kod-diffs för att identifiera potentiella buggar,
prestandaproblem och brott mot konventioner.
2. Förväntningar och utdataformat
Beskriv vad du förväntar dig av modellen:
## Utdataformat
För varje identifierat problem, ange:
- Filen och raden som är inblandad
- Allvarlighetsgrad (kritisk, varning, info)
- En beskrivning av problemet
- Ett förslag på korrigering med ett kodexempel
3. Kantfall
Förutse tvetydiga situationer:
## Kantfall
- Om diffen är tom, svara "Inga ändringar att analysera"
- Om koden är på ett språk som inte stöds, ange detta
- Kommentera inte formateringsändringar (mellanslag, indrag)
- Ignorera genererade konfigurationsfiler (.lock, dist/)
4. Begränsningar
Definiera gränser:
## Begränsningar
- Maximalt 10 kommentarer per granskning
- Prioritera kritiska buggar framför stilförslag
- Föreslå inte större refaktoreringar för mindre fixar
Strukturera med Markdown eller XML
Modellen är van vid att se omfattande, strukturerad kontext i den första prompten. Två format fungerar bra:
Markdown (rekommenderas för läsbarhet)
## Roll
Rollbeskrivning...
## Tillgängliga verktyg
- read_file: läs en projektfil
- write_file: modifiera en fil
- run_command: kör ett terminalkommando
## Regler
1. Läs alltid filen innan du modifierar den
2. Be om bekräftelse innan du raderar kod
3. Kör tester efter varje modifiering
XML (rekommenderas för precision)
<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>
Båda formaten är effektiva. Markdown är lättare att underhålla; XML är mer strukturerat för automatisk parsning.
Cache-optimering
Kom ihåg lektionen om cachelagring: systemprompten måste vara stabil. Skriv den en gång, fullständigt, och modifiera den inte under sessionen. Om du behöver ändra agentens beteende, lägg till instruktioner i användarmeddelandet istället för att modifiera systemprompten.
Komplett exempel: Agent för testgenerering
## Roll
Du är en agent som genererar enhetstester för TypeScript-kod.
Du använder Vitest som testramverk.
## Process
1. Läs källfilen med read_file
2. Identifiera exporterade funktioner
3. För varje funktion, generera tester som täcker:
- Det normala fallet
- Kantfall (null, undefined, tom array)
- Felhantering
4. Skriv tester med write_file i mappen __tests__/
5. Kör tester med run_command("npx vitest run")
## Konventioner
- Namngivning: {fil}.test.ts
- Struktur: describe > it > expect
- Använd fixtures för komplex data
- Mocka externa beroenden (API, DB)
## Begränsningar
- Modifiera inte källkoden
- Om ett test misslyckas, fixa testet, inte källkoden
- Maximalt 20 tester per fil
Denna systemprompt ger agenten all information som krävs för att operera autonomt, samtidigt som den håller sig inom definierade gränser.
Viktiga punkter
- Systemprompten strukturerar agentbeteendet i 4 delar: roll, förväntningar, kantfall, begränsningar
- Använd Markdown eller XML för att strukturera sektioner
- Systemprompten måste vara stabil för att optimera cachelagring
- Inkludera steg-för-steg-processer för sekventiella agenter
- Definiera alltid kantfall för att undvika oväntade beteenden
Testa dina kunskaper
grok-build i dina redigerare: ta fullständig kontroll.
1. Vad är grok-build-0.1?
Svar: xAI:s agentiska kodmodell: inbyggt verktygsanrop, strömmande resonemang, kontext anpassad för utvecklingsuppgifter – motorn bakom Grok Build och redigerarintegrationer.
2. Hur använder du det i din redigerare?
Svar: Via integrationer: Cline i VS Code, Cursor, GitHub Copilot, Windsurf och andra – det OpenAI-kompatibla xAI API:t möjliggör direkt integration.
3. Vilka vanor säkerställer bra koduppgifter?
Svar: Specificera kontext (filer, begränsningar), definiera tydliga och verifierbara mål, iterera progressivt – och optimera cachelagring genom att hålla prefix stabila.
4. grok-build-0.1 eller grok-4.5 för kod?
Svar: grok-build för vardagliga agentiska utvecklingsuppgifter (snabbt, specialiserat); grok-4.5 när uppgiften kräver maximalt resonemang – valet följer svårighetsgraden.
5. Vad ingår i systemprompten för en kodagent via API?
Svar: Rollen, projektkonventioner, redigeringsregler (tester, stil) och gränser – den inramning som gör en kodmodell till en teammedlem för din kodbas.
Specialiserad modell, ansluten redigerare, rena uppgifter, inramade promptar: Grok-assisterad utveckling handlar om fyra val – alla gjorda medvetet.