Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

System Prompts für API-Agenten

Lektion 14 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Agenten mit grok-build-0.1 entwickeln
  2. Anatomie eines guten Systemprompts
  3. Strukturierung mit Markdown oder XML
  4. Cache-Optimierung
  5. Komplettes Beispiel: Testgenerierungs-Agent
  6. Kernaussagen
  7. Wissen testen

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.