Cursor Cloud Agents

Verbinden Sie AI SmartTalk mit Cursor Cloud Agents, um autonome AI-Coding-Assistenten direkt aus Ihren Gesprächen oder Workflows zu starten. Cursor Cloud Agents können Repositories lesen, Code generieren, Commits erstellen und Pull-Requests automatisch öffnen.

---

Übersicht

Die Cursor Cloud Agents-Integration ermöglicht Ihnen:

• AI-Coding-Agenten auf Ihren GitHub-Repositories zu starten
• Codegenerierung durch natürliche Sprachbefehle zu automatisieren
• Pull-Requests automatisch zu erstellen, wenn Aufgaben abgeschlossen sind
• Agentenfortschritte zu überwachen und den Gesprächsverlauf einzusehen
• Folgeanweisungen an laufende Agenten hinzuzufügen
• Coding-Aufgaben aus SmartFlow-Workflows auszulösen

---

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

• Ein aktives AI SmartTalk-Konto haben
• Ein Cursor Konto mit Zugriff auf Cloud Agents besitzen
• Einen Cursor API-Schlüssel (erhalten von Ihrem Cursor-Dashboard)
• GitHub-Repositories, die von Ihrem Cursor-Konto aus zugänglich sind

---

Schritt-für-Schritt-Setup

Schritt 1: Holen Sie sich Ihren Cursor API-Schlüssel

1. Gehen Sie zu Ihrem Cursor Cloud Agent-Dashboard
2. Navigieren Sie zu Ihren API-Einstellungen
3. Generieren Sie einen neuen API-Schlüssel für AI SmartTalk
4. Kopieren Sie den API-Schlüssel

Schritt 2: Greifen Sie auf die Cursor-Integration zu

1. Melden Sie sich bei Ihrem AI SmartTalk-Konto an
2. Navigieren Sie zu Verwaltung → Meine Assistenten → [Ihr Assistentenname]
3. Klicken Sie auf Connectoren in der linken Seitenleiste
4. Suchen Sie Cursor Cloud Agents und klicken Sie darauf

Schritt 3: Konfigurieren Sie die Verbindung

1. Klicken Sie auf Konfiguration einrichten
2. Geben Sie Ihren Cursor API-Schlüssel ein
3. Klicken Sie auf Konfiguration speichern
4. AI SmartTalk validiert Ihren API-Schlüssel automatisch

Schritt 4: Repositories synchronisieren

Sobald die Verbindung hergestellt ist, synchronisiert AI SmartTalk automatisch die zugänglichen GitHub-Repositories von Ihrem Cursor-Konto. Sie können die Repository-Liste auch jederzeit manuell aktualisieren.

---

Dashboard

Sobald die Verbindung hergestellt ist, bietet das Dashboard der Cursor-Integration einen vollständigen Überblick:

Statistiken Übersicht

Metrik	Beschreibung
Gesamtzahl der Agenten	Anzahl der gestarteten Agenten
Aktiv	Derzeit aktive Agenten
Fertig	Abgeschlossene Agenten
Verfügbare Modelle	AI-Modelle, die für Agenten verfügbar sind

Kürzlich verwendete Assistenten

Das Dashboard listet Ihre zuletzt verwendeten Agenten mit:

• Agenten-ID zur Referenz
• Status: Aktiv, Abgeschlossen, Fehlgeschlagen, Erstellen oder Abgebrochen
• Repository, an dem der Agent arbeitet
• Erstellungsdatum
• Schnelle Aktionen: Details anzeigen und PR anzeigen

Das Dashboard aktualisiert sich automatisch alle 30 Sekunden, wenn Agenten aktiv sind.

---

Starten eines Agenten

Vom Dashboard

1. Klicken Sie auf Neuen Assistenten starten
2. Füllen Sie das Startformular aus:

Feld	Erforderlich	Beschreibung
Repository	Ja	Wählen Sie ein GitHub-Repository aus dem Dropdown-Menü
Aufgabenbeschreibung	Ja	Beschreiben Sie, was der Agent in natürlicher Sprache tun soll
Branch	Nein	Git-Branch, an dem gearbeitet werden soll (Standard: main)
AI-Modell	Nein	Wählen Sie ein spezifisches AI-Modell für den Agenten aus
Automatisch PR erstellen	Nein	Automatisch einen Pull-Request erstellen, wenn abgeschlossen (Standard: aktiviert)
Branch-Name	Nein	Benutzerdefinierter Branch-Name für den Pull-Request

3. Klicken Sie auf Agenten starten

Beispiele für Aufgabenbeschreibungen

• "Fügen Sie Unit-Tests für das Authentifizierungsmodul hinzu"
• "Refaktorisieren Sie den Datenbankverbindungspool, um Verbindungsrecycling zu verwenden"
• "Beheben Sie den Fehler, bei dem Benutzersitzungen vorzeitig auf Mobilgeräten ablaufen"
• "Fügen Sie TypeScript-Typdefinitionen für alle API-Antwortobjekte hinzu"
• "Erstellen Sie einen REST-API-Endpunkt für Benutzereinstellungen"

---

Verwaltung von Agenten

Agentendetails anzeigen

Klicken Sie auf Details anzeigen bei einem Agenten, um Folgendes zu sehen:

Übersicht-Tab:

• Agenten-ID und aktuellen Status
• Repository- und Branch-Informationen
• Link zum Pull-Request (falls erstellt)
• Zusammenfassung der durchgeführten Arbeiten
• Erstellungszeitstempel

Gesprächs-Tab:

• Vollständiger Nachrichtenverlauf der Arbeiten des Agenten
• Benutzeranweisungen und AI-Antworten
• Schritt-für-Schritt-Fortschrittsprotokoll

Folgeanweisungen hinzufügen

Sie können zusätzliche Anweisungen an einen laufenden Agenten senden:

1. Öffnen Sie die Agentendetails
2. Geben Sie Ihre Folgeanweisung ein (z. B. "Fügen Sie auch die Fehlerbehandlung für den Randfall hinzu, wenn der Benutzer nicht gefunden wird")
3. Der Agent setzt seine Arbeit mit dem neuen Kontext fort

Einen Agenten löschen

Um Ressourcen zu bereinigen:

1. Klicken Sie auf die Löschaktion auf der Agentenkarte
2. Bestätigen Sie die Löschung
3. Der Agent und seine Ressourcen werden entfernt

---

SmartFlow-Integration

Cursor Cloud Agents können als Aktionen in SmartFlow-Workflows verwendet werden, um leistungsstarke Automatisierungsszenarien zu ermöglichen.

Verfügbare SmartFlow-Aktionen

Aktion	Beschreibung
Coding-Agent starten	Starten Sie einen Agenten auf einem Repository mit spezifischen Anweisungen
Folgeanweisung hinzufügen	Senden Sie zusätzliche Anweisungen an einen laufenden Agenten
Agentenstatus abrufen	Überprüfen Sie den Fortschritt und den Status eines Agenten
Agenten löschen	Entfernen Sie einen Agenten und bereinigen Sie Ressourcen

Beispiel: Automatische Behebung bei Fehlerberichten

Trigger: Chat-Service (wenn der Benutzer einen Fehler meldet)
Actions:
  1. AI-Anfrage:
       Prompt: Extrahieren Sie die Fehlerbeschreibung und das betroffene Repository
  2. Cursor Agent starten:
       Repository: {{extracted_repository}}
       Aufgabe: "Beheben Sie diesen Fehler: {{bug_description}}"
       Automatisch PR erstellen: true
  3. Nachricht senden:
       Text: "Ich habe einen Coding-Agenten gestartet, um dies zu beheben. Ich werde Sie benachrichtigen, wenn der PR bereit ist."
  4. Warten / Abfragen:
       Überprüfen Sie den Agentenstatus regelmäßig
  5. Nachricht senden:
       Text: "Die Behebung ist bereit! Überprüfen Sie den PR hier: {{pr_url}}"

Beispiel: Geplante Codeverbesserungen

Trigger: Geplanter Workflow (wöchentlich)
Actions:
  1. Cursor Agent starten:
       Repository: my-org/my-app
       Aufgabe: "Überprüfen und aktualisieren Sie alle veralteten Abhängigkeiten"
       Branch: chore/update-deps
       Automatisch PR erstellen: true

Für detaillierte SmartFlow-Aktionsparameter siehe Cursor SmartFlow Actions.

---

Anwendungsfälle

Entwickler-Support-Bot

Lassen Sie Benutzer Codeänderungen über den Chat anfordern:

• "Können Sie die Eingangsvalidierung für das Anmeldeformular hinzufügen?"
• "Bitte erstellen Sie ein Migrationsskript für die neuen Benutzerfelder"

Automatisierte Fehlerbehebung

Lösen Sie Coding-Agenten aus Fehlerberichten oder Überwachungswarnungen aus, um automatisch Fix-PRs zu generieren.

Automatisierung der Codeüberprüfung

Starten Sie Agenten zur Überprüfung von Code, Hinzufügen von Tests oder Verbesserung der Dokumentation basierend auf PR-Feedback.

Geplante Wartung

Richten Sie wiederkehrende Workflows ein, um Abhängigkeiten zu aktualisieren, Linting-Fixes auszuführen oder Berichte zu generieren.

---

Fehlersuche

Problem	Lösung
"Ungültiger API-Schlüssel"	Generieren Sie Ihren API-Schlüssel erneut im Cursor-Dashboard
"Repository nicht gefunden"	Klicken Sie auf Aktualisieren, um die Repositories erneut zu synchronisieren. Stellen Sie sicher, dass das Repo von Ihrem Cursor-Konto aus zugänglich ist
Agent steckt in "Erstellen" fest	Der Agent könnte in der Warteschlange sein. Warten Sie ein paar Minuten und überprüfen Sie den Status erneut
Agent fehlgeschlagen	Öffnen Sie die Agentendetails, um das Gespräch und die Fehlermeldungen anzuzeigen
PR wurde nicht erstellt	Überprüfen Sie, ob die automatische PR-Erstellung aktiviert war und der Agent erfolgreich abgeschlossen wurde
Keine Repositories verfügbar	Stellen Sie sicher, dass Ihr Cursor-Konto mit GitHub-Repositories verbunden ist

---

Verwaltung der Integration

Aktion	Wie
Verbinden	Geben Sie den API-Schlüssel in der Integrationskonfiguration ein
Dashboard anzeigen	Öffnen Sie die Cursor-Integrationsseite
Repositories synchronisieren	Klicken Sie auf Aktualisieren, um die Repository-Liste zu aktualisieren
Trennen	Entfernen Sie den API-Schlüssel aus der Konfiguration

---

Beste Praktiken

1. Schreiben Sie klare Aufgabenbeschreibungen: Je spezifischer Ihre Anweisungen sind, desto besser ist das Ergebnis des Agents.
2. Verwenden Sie geeignete Branches: Starten Sie Agents nicht direkt auf main — lassen Sie sie PRs zur Überprüfung erstellen.
3. Aktivieren Sie die automatische PR-Erstellung: Erleichtert die Überprüfung und das Zusammenführen der Agentenarbeit.
4. Überwachen Sie laufende Agents: Überprüfen Sie regelmäßig das Dashboard oder richten Sie SmartFlow-Benachrichtigungen ein.
5. Überprüfen Sie vor dem Mergen: Überprüfen Sie immer die von Agents generierten PRs, bevor Sie sie in die Produktion mergen.
6. Fangen Sie klein an: Beginnen Sie mit gut definierten Aufgaben, bevor Sie große Refactorings versuchen.

---

Verwandte Dokumentation

• Cursor SmartFlow Aktionen
• SmartFlow Einführung
• Integrationen Übersicht