Verwendung von Hintergrund-Agenten in Cursor zur Automatisierung

Cursor 1.0 hat Hintergrund-Agenten eingeführt - eine leistungsstarke Funktion, die es KI-Agenten ermöglicht, Aufgaben im Hintergrund auszuführen, ohne die IDE zu blockieren. Dieser Leitfaden behandelt Einrichtung, Verwaltung und effektive Nutzung von Hintergrund-Agenten für maximale Produktivität.

Was sind Hintergrund-Agenten?

Hintergrund-Agenten ermöglichen:

• Langlaufende Aufgaben, die während der Arbeit an anderem fortgesetzt werden
• Parallele Verarbeitung mehrerer unabhängiger Aufgaben
• Asynchrone Vorgänge wie Tests, Builds und Analysen
• Geplante Aufgaben, die zu bestimmten Zeiten ausgeführt werden

Voraussetzungen

• Cursor Version 1.0 oder neuer
• Pro- oder höherer Plan (Hintergrund-Agenten erfordern möglicherweise eine kostenpflichtige Stufe)
• Projekte mit Aufgaben, die unabhängig ausgeführt werden können

Starten eines Hintergrund-Agenten

Methode 1: Kontextmenü

1. Öffnen Sie Composer (Cmd/Ctrl + I)
2. Geben Sie Ihre Aufgabenbeschreibung ein
3. Klicken Sie auf das ...-Menü (Weitere Aktionen)
4. Wählen Sie Im Hintergrund ausführen

Methode 2: Befehl

@background Analysieren Sie die gesamte Codebasis auf Sicherheitslücken und berichten Sie die Ergebnisse.

Methode 3: Tastenkürzel

1. Verfassen Sie Ihre Aufgabe
2. Drücken Sie Cmd/Ctrl + Shift + B (falls konfiguriert)
3. Der Agent startet im Hintergrund

Anwendungsfälle für Hintergrund-Agenten

1. Codebasis-Analyse

[Hintergrund] Scannen Sie die gesamte Codebasis und:
1. Finden Sie alle TODO-Kommentare
2. Identifizieren Sie veraltete API-Nutzung
3. Listen Sie Dateien ohne Testabdeckung auf
4. Erkennen Sie potenzielle Speicherlecks
5. Melden Sie Code-Duplizierung

Liefern Sie einen Zusammenfassungsbericht, wenn abgeschlossen.

2. Testausführung

[Hintergrund] Führen Sie die vollständige Testsuite aus:
1. Führen Sie alle Unit-Tests aus
2. Führen Sie Integrationstests aus
3. Generieren Sie einen Abdeckungsbericht
4. Speichern Sie Ergebnisse in test-results/

Benachrichtigen Sie mich bei Abschluss mit einer Pass/Fail-Zusammenfassung.

3. Dokumentationserstellung

[Hintergrund] Generieren Sie API-Dokumentation:
1. Scannen Sie src/ nach allen öffentlichen Funktionen/Klassen
2. Erstellen Sie JSDoc/docstrings, wo sie fehlen
3. Generieren Sie Markdown-Dokumente in docs/api/
4. Erstellen Sie einen Navigationsindex

Verwenden Sie den vorhandenen Stil von src/utils/helpers.ts.

4. Refactoring großer Codebasen

[Hintergrund] Refactoren Sie die Fehlerbehandlung:
1. Finden Sie alle try/catch-Blöcke
2. Standardisieren Sie Fehlermeldungen
3. Fügen Sie strukturierte Fehlerprotokollierung hinzu
4. Erstellen Sie benutzerdefinierte Fehlerklassen

Wenden Sie Änderungen in der gesamten Codebasis an.

Verwaltung von Hintergrund-Agenten

Aktive Agenten anzeigen

1. Öffnen Sie das Hintergrund-Agenten-Panel:

   • Ansicht > Darstellung > Hintergrund-Agenten anzeigen
   • Oder verwenden Sie das Seitenleisten-Symbol

2. Sehen Sie alle laufenden Agenten mit:

   • Aufgabenbeschreibung
   • Startzeit
   • Aktueller Status
   • Fortschrittsanzeige

Agenten-Zustände

Zustand	Beschreibung	Aktion
Läuft	Agent arbeitet aktiv	Fortschritt überwachen
Pausiert	Agent wurde manuell pausiert	Fortsetzen oder abbrechen
Abgeschlossen	Aufgabe erfolgreich beendet	Ergebnisse ansehen
Fehlgeschlagen	Aufgabe hat einen Fehler festgestellt	Logs prüfen
Abgebrochen	Aufgabe wurde vom Benutzer gestoppt	Bei Bedarf neu starten

Agenten steuern

# Einen Agenten pausieren
cursor agent:pause <agent-id>

# Einen Agenten fortsetzen
cursor agent:resume <agent-id>

# Einen Agenten abbrechen
cursor agent:cancel <agent-id>

# Agenten-Logs anzeigen
cursor agent:logs <agent-id>

Agenten-Ausgabe und Ergebnisse

Ergebnistypen

1. Dateiänderungen: Agent hat Dateien geändert

   • In der Quellcodeverwaltung prüfen
   • Diff vor dem Commit ansehen

2. Berichte: Generierte Zusammenfassungen

   • Am angegebenen Ort gespeichert
   • Oder im Benachrichtigungs-Panel angezeigt

3. Benachrichtigungen: Statusaktualisierungen

   • Desktop-Benachrichtigungen bei Abschluss
   • Badge auf dem Cursor-Symbol

Auf Ergebnisse zugreifen

Wenn ein Hintergrund-Agent abgeschlossen ist:

1. Eine Benachrichtigung erscheint (falls aktiviert)
2. Ein Badge wird auf dem Cursor-Dock/Taskleiste angezeigt
3. Das Ergebnis-Panel öffnet sich automatisch
4. Geänderte Dateien erscheinen in der Quellcodeverwaltung

Best Practices

Aufgaben-Granularität

Große Aufgaben in kleinere Hintergrund-Agenten aufteilen:

# Gut: Spezifische, unabhängige Aufgaben
[Hintergrund] Refactoren Sie die Fehlerbehandlung des Authentifizierungsmoduls
[Hintergrund] Refactoren Sie die Fehlerbehandlung des Zahlungsmoduls
[Hintergrund] Refactoren Sie die Fehlerbehandlung des Benachrichtigungsmoduls

# Weniger ideal: Eine riesige Aufgabe
[Hintergrund] Refactoren Sie alle Fehlerbehandlung in der gesamten App

Ressourcenverwaltung

Gleichzeitige Hintergrund-Agenten begrenzen:

# Maximale empfohlene gleichzeitige Agenten
- 2-3 für CPU-intensive Aufgaben (Refactoring, Analyse)
- 5+ für I/O-gebundene Aufgaben (Dokumentation, Berichte)

Checkpoints

Für lange Aufgaben Checkpoints verwenden:

[Hintergrund] Datenbankschema migrieren:
1. Backup erstellen
2. Migrationsskripte ausführen
3. Datenintegrität überprüfen
4. Rollback-Skript generieren

Fortschritt nach jedem Schritt speichern.
Bei Unterbrechung vom letzten Checkpoint fortsetzen.

Überwachung und Logs

Agenten-Logs anzeigen

1. Öffnen Sie das Hintergrund-Agenten-Panel
2. Klicken Sie auf einen abgeschlossenen Agenten
3. Zeigen Sie das vollständige Ausführungsprotokoll an
4. Sehen Sie sich Zeitstempel und Aktionen an

Log-Struktur

[2026-06-25 10:00:00] Agent gestartet: "Codebasis-Sicherheitsscan"
[2026-06-25 10:00:05] Lesen: src/auth/login.ts
[2026-06-25 10:00:10] Lesen: src/auth/register.ts
[2026-06-25 10:00:15] Analyse abgeschlossen: 3 Schwachstellen gefunden
[2026-06-25 10:00:20] Bericht schreiben: security-report.md
[2026-06-25 10:00:25] Agent erfolgreich abgeschlossen

Modellauswahl für Hintergrund-Agenten

Verschiedene Modelle eignen sich für verschiedene Hintergrundaufgaben:

Aufgabentyp	Empfohlenes Modell	Warum
Code-Analyse	Claude 3.5 Sonnet	Gründlich, genau
Refactoring	GPT-4o	Schnell, zuverlässig
Dokumentation	Gemini 1.5 Pro	Langer Kontext
Tests	Claude 3.5 Sonnet	Gute Grenzfall-Erkennung
Sicherheitsaudit	Claude 3 Opus	Tiefe Analyse

Standardmodell in den Einstellungen konfigurieren:

{
  "backgroundAgents": {
    "defaultModel": "claude-3-5-sonnet",
    "maxConcurrent": 3,
    "autoNotify": true
  }
}

Fehlerbehebung

Problem	Lösung
Agent startet nicht	Planlimits prüfen; möglicherweise Upgrade nötig
Agent verschwindet	Hintergrund-Agenten-Panel auf Fehler prüfen
Ergebnisse nicht gespeichert	Ausgabepfad in der Aufgabenbeschreibung angeben
Agent hängt	Abbrechen und neu starten; wartet möglicherweise auf Eingabe
Hohe CPU-Auslastung	Gleichzeitige Agenten reduzieren; leichtere Modelle verwenden

Beispiel: Kompletter Hintergrund-Workflow

# Morgens: Analyse starten
[Hintergrund] Analysieren Sie die technische Schulden in der Codebasis.
Generieren Sie eine priorisierte Liste von Refactoring-Aufgaben.

# Während der Agent läuft, weiter coden...

# Agent abgeschlossen
[Benachrichtigung] "Analyse abgeschlossen: 12 Refactoring-Möglichkeiten gefunden"

# Ergebnisse prüfen
Öffnen: analysis-results/refactoring-tasks.md

# Refactoring im Hintergrund starten
[Hintergrund] Implementieren Sie die Top-3-Refactoring-Aufgaben aus der Analyse.

# Andere Arbeiten fortsetzen...

# Änderungen bei Gelegenheit prüfen
Quellcodeverwaltung-Panel auf Diff prüfen

Verwandte Ressourcen

• Cursor Agent Mode Masterclass
• MCP Multi-Agent Workflows
• Handling Large Projects with Cursor