Agent SDK
Das Agent SDK ist ab sofort verfügbar. Damit definierst du einen Agent als Ordner mit Code, testest ihn mit Evals und stellst ihn in Cursor oder auf deiner eigenen Infrastruktur bereit.
Führe npx @cursor/agent-sdk init ./my-bot und anschließend agent-sdk dev aus, um den Bot lokal mit einem Playground zu starten. Mit --template startest du direkt mit einer Vorlage: einem Security Reviewer, einem Approver für Owners-Richtlinien, einem PR-Autofixer oder einem Triage-Bot für Linear oder Jira.
Agents überall bereitstellen, wo du sie brauchst
Sobald du einen Agent produktiv einsetzen möchtest, kannst du ihn in Cursor bereitstellen, indem du im Projektverzeichnis agent-sdk deploy ausführst. Der Befehl erstellt den Agent, weist ihm eine URL zu und startet ihn auf unserer Infrastruktur. Geheimnisse und Integrationen verwaltest du im Dashboard – und nutzt dabei weiterhin dieselben Logs, Evals und denselben Playground wie lokal.
Agenten als Code
Ein Agent ist ein Projekt. instructions.md ist der Prompt. Jede Datei in tools/ ist eine typisierte Aktion, die das Modell aufrufen kann. skills/ enthält Abläufe, die das Modell bei Bedarf lädt, mcp-connections/ fügt Tools von MCP-Servern hinzu, und channels/ legt fest, wo der Bot Nachrichten empfängt und beantwortet. agent-sdk validate prüft das Projekt, und agent-sdk info zeigt an, was erkannt wurde.
Kanäle
Agenten werden durch PR-, Kommentar- und CI-Events von GitHub, GitLab und Bitbucket aktiviert, durch Erwähnungen und DMs in Slack, durch Webhooks beliebiger Anbieter sowie per Cron-Zeitplan. GitHub-Events werden über dein Cursor-Konto abgerufen, daher ist keine öffentliche Webhook-URL erforderlich. Slack wird bereits standardmäßig umfassend unterstützt.
Jede Unterhaltung hat ihre eigene Sitzung und einen vollständigen Datensatz aller Nachrichten und Tool-Aufrufe. Rückfragen in einem PR oder Slack-Thread setzen dieselbe Sitzung fort.
Evals
Ein Eval sendet eine festgelegte Nachricht an den Bot und prüft anschließend, was er getan hat: welche Tools ausgeführt wurden, mit welcher Eingabe und welche Struktur die Antwort hat. Führe agent-sdk eval lokal oder in der CI aus.
agent-sdk github replay <pr-url> wandelt einen echten PR in signierte Webhook-Payloads um und sendet sie an den Bot. So lassen sich GitHub-gesteuerte Bots testen, ohne auf einen Push warten zu müssen. Füge --dry-run --fixtures-dir fixtures/ hinzu, um die Payloads als Eval-Fixtures zu speichern.
Loslegen
Das Agent SDK ist ab heute allgemein verfügbar. Lies die Docs und leg direkt los.