[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

Cloud-Agents

Cloud Agents

Cloud Agents verwenden dieselben Agenten-Grundlagen, laufen aber in isolierten VMs in der Cloud mit vollständigen Entwicklungsumgebungen statt auf deinem lokalen Rechner. Die Entwicklungsumgebung ähnelt dem Setup auf deinem Laptop: geklonte Repos, installierte Abhängigkeiten, Secrets, Startbefehle und Netzwerkzugriff.

Effektive Entwicklungsumgebungen geben Agenten vollständigen Kontext zu deiner Codebasis und Organisation, damit sie ihre Arbeit testen und überprüfen können.

Warum Cloud Agents verwenden?

Du kannst beliebig viele Agenten parallel ausführen, ohne dass dein lokaler Rechner mit dem Internet verbunden sein muss.

Da sie Zugriff auf ihre eigene virtuelle Maschine haben, können Cloud Agents die geänderte Software bauen, testen und mit ihr interagieren. Sie können außerdem Computer nutzen, um den Desktop und den Browser zu steuern. Cloud Agents unterstützen MCP-Server und erhalten dadurch Zugriff auf externe Tools und Datenquellen wie Datenbanken, APIs und Drittanbieterdienste.

Cloud Agents können auch in Multi-Repo-Umgebungen ausgeführt werden. Verwende eine solche Umgebung, wenn eine Aufgabe mehrere separate Frontend-, Backend-, Infrastruktur- oder Shared-Library-Repos umfasst. Der Agent kann den gesamten Workspace einsehen, koordinierte Änderungen vornehmen und in den Repos, die er ändert, Pull Requests öffnen.

So erhältst du Zugriff

Du kannst Cloud Agents von überall aus starten, wo du arbeitest:

  1. Cursor für iOS: Starte und verwalte Agenten in der Cursor iOS-App
  2. Cursor Web: Starte und verwalte Agenten auf cursor.com/agents auf jedem Gerät
  3. Cursor Desktop: Wähle Cloud im Dropdown-Menü unter der Agent-Eingabe aus
  4. Slack: Nutze den @cursor-Befehl, um einen Agenten zu starten
  5. GitHub oder Bitbucket: Kommentiere @cursor in einer GitHub-PR oder einem GitHub-Issue oder in einer Bitbucket-PR, um einen Agenten zu starten
  6. Linear: Nutze den @cursor-Befehl, um einen Agenten zu starten
  7. API: Nutze die API, um einen Agenten zu starten

Cursor in Slack nutzen

Erfahre mehr über das Einrichten und Nutzen der Slack-Integration, einschließlich dem Starten von Agenten und dem Erhalten von Benachrichtigungen.

So funktioniert es

Verbindung zum Repository-Anbieter

Cloud Agents klonen dein Repo von GitHub, GitLab, Azure DevOps Services oder Bitbucket Cloud und arbeiten auf einem separaten Branch. Anschließend pushen sie die Änderungen zur Übergabe in dein Repo.

Du benötigst Lese- und Schreibzugriff auf dein Repo sowie auf alle abhängigen Repos oder Submodule.

Umgebungen

Agenten sind nur so leistungsfähig wie die Umgebungen, in denen sie laufen. Ein Agent, der Code schreiben, aber keine Tests ausführen, Dienste abfragen oder APIs erreichen kann, kann seine Arbeit nicht vollständig abschließen.

Keine Entwicklungsumgebung für deine Cloud Agents einzurichten, ist so, als würdest du deinen Entwicklerinnen und Entwicklern keinen Computer geben. Deshalb ist die Einrichtung der Umgebung der wichtigste Schritt, um die Effektivität von Cloud Agents zu verbessern. So können Cloud Agents wie Entwicklerinnen und Entwickler arbeiten: Code schreiben, Arbeit testen und überprüfen und Software ausliefern.

Du kannst Umgebungen mit einer agentengesteuerten Einrichtung, einem gespeicherten Snapshot oder einem Dockerfile in .cursor/environment.json konfigurieren. Unter Cloud-Agent-Setup findest du den Einstieg. Builds bereiten jede Umgebung im Hintergrund vor, sodass Agenten mit einsatzbereiten Repositories und Abhängigkeiten starten.

Das Cloud-Agents-Dashboard zeigt, welche Umgebung und welchen Build ein Agent verwendet hat, zusammen mit Umgebungsdetails und dem Versionsverlauf. Bewege auf der Agent-Seite den Mauszeiger über den Repository-Namen oben auf der Seite, um die für diesen Run verwendete Umgebung zu prüfen. Unter Cloud-Agent-Setup findest du Details zur Konfiguration.

Runtime- und Umgebungskontrollen

Cursor verwaltet die VM-Bereitstellung, Isolation, Snapshots, den Start, Artefakte und Kapazität für jeden Cloud-Agent. Du kannst Secrets hinzufügen, ausgehende Domains einschränken, mit Tailscale oder einem ähnlichen Client eine Verbindung zu privaten Netzwerken herstellen und private Konnektivität für unterstützte Source-Control-Pfade nutzen.

Siehe Cloud-Agent-Sicherheit und Netzwerk für den vollständigen Satz an Umgebungs- und Netzwerkkontrollen. Wenn du abwägst, ob du Self-Hosted nutzen solltest, siehe warum die meisten Teams mit Cursor Cloud starten.

Modelle

Cloud Agents nutzen eine kuratierte Auswahl an Modellen. Du kannst für unterstützte Modelle die Größe des Kontextfensters auswählen.

MCP-Unterstützung

Cloud Agents können MCP (Model Context Protocol)-Server nutzen, die für dein Team konfiguriert sind. Füge MCP-Server über das MCP-Dropdown in cursor.com/agents hinzu und verwalte sie dort.

HTTP- und stdio-Transporte werden unterstützt. OAuth wird für MCP-Server unterstützt, die dies erfordern. Weitere Einrichtungsdetails findest du unter Cloud-Agent-Funktionen.

Cloud Agents enthalten außerdem ein integriertes Cursor Cloud MCP für Ausführungsdiagnosen, einschließlich Transkripten, Ausführungs-Ereignissen, Umgebungsdetails und Einrichtungsprotokollen.

Hook-Unterstützung

Cloud Agents führen befehlsbasierte Hooks aus der Datei .cursor/hooks.json in deinem Repository aus. Mit Enterprise-Plänen führen sie außerdem Team-Hooks und Enterprise-verwaltete Hooks aus.

So bleiben Formatter, Audit-Skripte und Richtlinienprüfungen auch dann aktiv, wenn in der Cloud gearbeitet wird. Zu den unterstützten Hooks gehören Tool- und Datei-Hooks (preToolUse, beforeShellExecution, afterFileEdit) sowie Lifecycle-Hooks (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought und stop).

Hooks werden während früher explorativer Runden in einer schreibgeschützten Umgebung nicht ausgeführt; sie starten, sobald der Agent über eine beschreibbare Umgebung verfügt. Einige Hooks sind IDE-spezifisch (Tab-Hooks, workspaceOpen). Hooks auf Nutzerebene aus ~/.cursor/hooks.json sind ebenfalls nicht verfügbar, da Cloud-VMs keinen Zugriff auf dein lokales Home-Verzeichnis haben.

Siehe Hooks: Unterstützung für Cloud Agents für die vollständige Support-Matrix und weitere Details.

Artefakte und Remote-Desktop-Steuerung

Cloud Agents erstellen merge-bereite PRs mit Artefakten, um ihre Änderungen zu demonstrieren. Du kannst auch den Remote-Desktop des Agenten steuern, um die geänderte Software zu nutzen.

  • Artefakte: Agenten erstellen Screenshots, Videos und Logs, damit du genau sehen kannst, was sich geändert hat und wie der Agent seine Arbeit überprüft hat.
  • Remote-Desktop-Steuerung: Übernimm den Desktop des Agenten, um die Software selbst in einer vollständigen Entwicklungsumgebung zu testen, ohne den Branch lokal auszuchecken. Gib die Steuerung an den Agenten zurück, damit er weiterarbeiten kann.

Siehe Cloud-Agent-Funktionen für Details zu Artefakten, Computernutzung und Remote-Desktop-Steuerung.

Agenten mit deinem Team teilen

Sende einem Teammitglied die URL eines Agenten, damit es den Run öffnen und die Unterhaltung, die Codeänderungen und die vom Agenten erzeugten Artefakte sehen kann.

Agenten sind für Mitglieder des Cursor-Teams sichtbar, in dem sie gestartet wurden. Cursor überprüft außerdem den Repository-Zugriff jeder Person: Um den Agenten eines Teammitglieds zu öffnen, verbinde unter Integrations dein eigenes Quellcodeverwaltungskonto und stelle sicher, dass du Zugriff auf das Repository hast, in dem der Agent gearbeitet hat. Die Teammitgliedschaft allein gewährt keinen Zugriff.

Die Ansicht ist schreibgeschützt. Damit Teammitglieder Follow-up-Nachrichten senden und die Arbeit fortsetzen können, kann ein Team-Admin Team follow-ups aktivieren.

Verwandte Seiten

Abrechnung

Cloud Agents werden zum API-Preis für das ausgewählte Modell berechnet. Du kannst die Größe des Kontextfensters auswählen; ein größeres Kontextfenster kann die Token-Nutzung und die Kosten erhöhen. Wenn du sie zum ersten Mal nutzt, wirst du aufgefordert, ein Ausgabenlimit festzulegen.

Fehlerbehebung

  • Stelle sicher, dass du angemeldet bist und dein GitHub-, GitLab-, Azure-DevOps- oder Bitbucket-Konto verbunden hast.
  • Überprüfe, ob du über die erforderlichen Repo-Berechtigungen verfügst.
  • Du benötigst einen bezahlten Cursor-Plan.

  • Stelle sicher, dass du Secrets unter cursor.com/dashboard/cloud-agents hinzugefügt hast
  • Versuche, den Cloud-Agent nach dem Hinzufügen neuer Secrets neu zu starten
  • Secrets gelten auf Workspace-/Team-Ebene; stelle sicher, dass du das richtige Konto verwendest

  • Wenn du ihn nicht siehst, stelle sicher, dass du über die erforderlichen Berechtigungen verfügst

Snapshots speichern deine grundlegende Umgebungskonfiguration (installierte Pakete, System abhängigkeiten usw.). Wenn du beim Erstellen eines Snapshots .env.local-Dateien einschließt, werden sie gespeichert. Die Verwendung des Secrets-Tabs in den Cursor Settings ist jedoch der empfohlene Ansatz zur Verwaltung von Umgebungsvariablen.

  • Das Teammitglied muss demselben Cursor-Team angehören wie du.
  • Es muss unter Integrations sein eigenes Source-Control-Konto verbinden und Zugriff auf das Repo haben, in dem der Agent gearbeitet hat.
  • Siehe Agenten mit deinem Team teilen für Details.

Überprüfe, ob dein Workspace-Admin die Cursor-Slack-App installiert hat und ob du über die erforderlichen Berechtigungen verfügst.

Frühere Bezeichnung

Cloud Agents wurden früher als Background Agents bezeichnet.