System Prompts für API-Agenten
Auf dieser Seite
Agenten mit grok-build-0.1 entwickeln
Wenn Sie eigene Entwicklungswerkzeuge erstellen – einen Code-Review-Agenten, einen Bereitstellungs-Assistenten oder ein Tool zur Generierung von Dokumentation – interagieren Sie direkt mit der xAI API. Der Systemprompt ist Ihr primärer Hebel zur Steuerung des Modellverhaltens.
Anatomie eines guten Systemprompts
Ein effektiver Systemprompt für einen Agenten, der auf grok-build-0.1 basiert, enthält vier Abschnitte:
1. Aufgabenbeschreibung
Beginnen Sie damit, klar zu definieren, was der Agent tut:
## Rolle
Sie sind ein Code-Review-Assistent, der sich auf TypeScript spezialisiert hat.
Sie analysieren Code-Diffs, um potenzielle Fehler,
Leistungsprobleme und Verstöße gegen Konventionen zu identifizieren.
2. Erwartungen und Ausgabeformat
Beschreiben Sie, was Sie vom Modell erwarten:
## Ausgabeformat
Für jedes identifizierte Problem geben Sie an:
- Die betroffene Datei und Zeile
- Schweregrad (kritisch, Warnung, Info)
- Eine Beschreibung des Problems
- Einen Korrekturvorschlag mit einem Codebeispiel
3. Sonderfälle
Antizipieren Sie mehrdeutige Situationen:
## Sonderfälle
- Wenn das Diff leer ist, antworten Sie mit "Keine Änderungen zur Analyse"
- Wenn der Code in einer nicht unterstützten Sprache vorliegt, weisen Sie dies aus
- Kommentieren Sie keine Formatierungsänderungen (Leerzeichen, Einrückung)
- Ignorieren Sie generierte Konfigurationsdateien (.lock, dist/)
4. Einschränkungen
Definieren Sie Grenzen:
## Einschränkungen
- Maximale 10 Kommentare pro Review
- Priorisieren Sie kritische Fehler gegenüber Stilvorschlägen
- Vorschlagen Sie keine großen Refactorings für kleine Fixes
Strukturierung mit Markdown oder XML
Das Modell ist daran gewöhnt, im ersten Prompt umfangreichen, strukturierten Kontext zu sehen. Zwei Formate funktionieren gut:
Markdown (Empfohlen für Lesbarkeit)
## Rolle
Rollenbeschreibung...
## Verfügbare Tools
- read_file: Lesen einer Projektdatei
- write_file: Modifizieren einer Datei
- run_command: Ausführen eines Terminalbefehls
## Regeln
1. Lesen Sie die Datei immer vor der Modifikation
2. Fragen Sie nach Bestätigung vor dem Löschen von Code
3. Führen Sie Tests nach jeder Modifikation aus
XML (Empfohlen für Präzision)
<agent>
<role>Code-Review-Assistent für TypeScript</role>
<tools>
<tool name="read_file">Lesen einer Projektdatei</tool>
<tool name="write_file">Modifizieren einer Datei</tool>
</tools>
<rules>
<rule>Lesen Sie die Datei immer vor der Modifikation</rule>
<rule>Fragen Sie nach Bestätigung vor dem Löschen von Code</rule>
</rules>
</agent>
Beide Formate sind effektiv. Markdown ist einfacher zu warten; XML ist für das automatische Parsen strukturierter.
Cache-Optimierung
Erinnern Sie sich an die Lektion zum Caching: Der Systemprompt muss stabil sein. Schreiben Sie ihn einmal vollständig und ändern Sie ihn nicht während der Sitzung. Wenn Sie das Verhalten des Agenten ändern müssen, fügen Sie Anweisungen in die Benutzer-Nachricht ein, anstatt den Systemprompt zu modifizieren.
Komplettes Beispiel: Testgenerierungs-Agent
## Rolle
Sie sind ein Agent, der Unit-Tests für TypeScript-Code generiert.
Sie verwenden Vitest als Test-Framework.
## Prozess
1. Lesen Sie die Quelldatei mit read_file
2. Identifizieren Sie exportierte Funktionen
3. Für jede Funktion generieren Sie Tests, die abdecken:
- Den nominalen Fall
- Sonderfälle (null, undefined, leeres Array)
- Fehlerfälle
4. Schreiben Sie Tests mit write_file im __tests__/ Ordner
5. Führen Sie Tests mit run_command("npx vitest run") aus
## Konventionen
- Benennung: {file}.test.ts
- Struktur: describe > it > expect
- Verwenden Sie Fixtures für komplexe Daten
- Mocken Sie externe Abhängigkeiten (API, DB)
## Einschränkungen
- Modifizieren Sie keinen Quellcode
- Wenn ein Test fehlschlägt, reparieren Sie den Test, nicht den Quellcode
- Maximale 20 Tests pro Datei
Dieser Systemprompt gibt dem Agenten alle Informationen, die er benötigt, um autonom zu arbeiten, während er innerhalb definierter Grenzen bleibt.
Kernaussagen
- Der Systemprompt strukturiert das Agentenverhalten in 4 Teilen: Rolle, Erwartungen, Sonderfälle, Einschränkungen
- Verwenden Sie Markdown oder XML, um Abschnitte zu strukturieren
- Der Systemprompt muss stabil sein, um das Caching zu optimieren
- Schließen Sie schrittweise Prozesse für sequenzielle Agenten ein
- Definieren Sie immer Sonderfälle, um unerwartetes Verhalten zu vermeiden
Wissen testen
grok-build in Ihren Editoren: die endgültige Kontrolle übernehmen.
1. Was ist grok-build-0.1?
Antwort: Das agentische Code-Modell von xAI: native Tool-Aufrufe, strömendes Reasoning, Kontext, der an Entwicklungsaufgaben angepasst ist – der Motor hinter Grok Build und Editor-Integrationen.
2. Wie verwenden Sie es in Ihrem Editor?
Antwort: Über Integrationen: Cline in VS Code, Cursor, GitHub Copilot, Windsurf und andere – die OpenAI-kompatible xAI API ermöglicht direkte Integration.
3. Welche Gewohnheiten sorgen für gute Code-Aufgaben?
Antwort: Kontext angeben (Dateien, Einschränkungen), klare und überprüfbare Ziele definieren, schrittweise iterieren – und das Caching optimieren, indem Präfixe stabil gehalten werden.
4. grok-build-0.1 oder grok-4.5 für Code?
Antwort: grok-build für alltägliche agentische Entwicklungsaufgaben (schnell, spezialisiert); grok-4.5, wenn die Aufgabe maximales Reasoning erfordert – die Wahl folgt der Schwierigkeit.
5. Was gehört in den Systemprompt eines API-Code-Agenten?
Antwort: Die Rolle, Projekt-Konventionen, Bearbeitungsregeln (Tests, Stil) und Grenzen – das Rahmenwerk, das aus einem Code-Modell einen Teamkollegen für Ihren Codebestand macht.
Spezialisiertes Modell, verbundener Editor, klare Aufgaben, gerahmte Prompts: Grok-gestützte Entwicklung reduziert sich auf vier Entscheidungen – alle bewusst getroffen.