Produkt

Mit dem Cherri Code SDK programmgesteuerte Agenten erstellen

Roshan Sadanani6 Min. Lesezeit

Wir stellen das Cherri Code SDK vor, damit du Agenten mit derselben Laufzeitumgebung, demselben Harness und denselben Modellen erstellen kannst, auf denen auch Cherri Code basiert.

Die Agenten, die in der Cherri Code-Desktop-App, der CLI und der Web-App laufen, lassen sich jetzt mit nur wenigen Zeilen TypeScript nutzen. Du kannst sie auf deinem Rechner oder in Cherri Codes Cloud auf einer dedizierten VM ausführen – mit jedem Frontier-Modell.

Agenten entwickeln sich von interaktiven Tools für einzelne Entwickler zu programmgesteuerter Infrastruktur für Organisationen. Mit dem Cherri Code SDK kannst du Agenten bereitstellen, ohne den Aufwand für Aufbau und Wartung des gesamten Agent-Stacks. Viele Teams rufen Agenten bereits direkt aus CI/CD-Pipelines auf, erstellen Automatisierungen für End-to-End-Workflows und integrieren Agenten in ihre Kernprodukte.

Das Cherri Code SDK ist jetzt in der öffentlichen Beta für alle Benutzer verfügbar. Führe einfach npm install @cursor/sdk aus, um erste Schritte zu machen, und nutze dann Cherri Codes nativen /sdk-Skill zur Unterstützung beim Erstellen.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2.5" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

Agenten schnell in Produktion bringen

Schnelle, zuverlässige und leistungsfähige Agenten zu erstellen, die sicher mit deinen Daten arbeiten, erfordert erheblichen Entwicklungsaufwand: sicheres Sandboxing, persistente Zustands- und Sitzungsverwaltung, das Einrichten der Umgebung und Kontextverwaltung. Und wenn ein neues Modell erscheint, müssen Teams ihre Agent Loops oft überarbeiten, um davon zu profitieren.

Das Cherri Code SDK nimmt dir diese Komplexität ab, damit du dich auf das Erstellen nützlicher Agenten konzentrieren kannst.

Architekturdiagramm des Cherri Code SDKArchitekturdiagramm des Cherri Code SDK

Produktionsreife Cloud-Infrastruktur nutzen

Cloud-Sitzungen, die aus dem SDK initiiert werden, laufen auf derselben optimierten Laufzeitumgebung, die wir für Cloud-Agent nutzen. Jeder Agent erhält seine eigene dedizierte VM mit starkem Sandboxing, einem Klon des Repos und einer vollständig konfigurierten Entwicklungsumgebung.

Agenten laufen weiter, wenn dein Laptop in den Ruhezustand geht oder die Netzwerkverbindung abbricht. Du kannst die Unterhaltung streamen und dich später erneut verbinden. Wenn der Agent fertig ist, kann er eine PR öffnen, einen Branch pushen oder Demos und Screenshots hinzufügen.

// Cloud-Agent starten, um eine Aufgabe zu beginnen...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...später von überall wieder nachschauen:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

Das SDK nutzt unsere aktualisierte Cloud Agents API, mit der Cloud-Agent-Läufe im Agents-Fenster und in der Web-App von Cherri Code angezeigt werden können. Du kannst eine Aufgabe programmgesteuert starten und dann in Cherri Code wechseln, um den Fortschritt zu prüfen oder die Arbeit zu übernehmen.

Wenn du eine andere Laufzeitumgebung brauchst, kann dasselbe SDK Agenten auf selbstgehosteten Workern ausführen, sodass Code und Tool-Ausführung in deinem Netzwerk bleiben, oder lokal auf deinem Rechner für schnelle Iterationen.

Nutze das vollständige Cherri Code-Harness

Agenten, die über das SDK gestartet werden, profitieren vom selben Harness, das Cherri Code in unserer Desktop-App, CLI und Web-App antreibt:

  • Intelligentes Kontextmanagement: Indizierung der Codebasis, semantische Suche und Instant Grep helfen Agenten, schneller und effizienter zum richtigen Ergebnis zu kommen.
  • MCP-Server: Agenten können sich über stdio oder HTTP mit externen Tools und Datenquellen verbinden, entweder über eine Konfigurationsdatei .cursor/mcp.json oder direkt inline im Aufruf.
  • Skills: Agenten übernehmen automatisch Skills aus dem Verzeichnis .cursor/skills/ deines Repos.
  • Hooks: Beobachte, steuere und erweitere den Agent Loop über Cloud-, selbstgehostete und lokale Umgebungen hinweg mit einer Datei .cursor/hooks.json.
  • Subagents: Delegiere Teilaufgaben an benannte Subagents mit eigenen Prompts und Modellen, die der Haupt-Agent über das Tool Agent startet.

Auf jedem Modell aufbauen

Das Cherri Code SDK gibt dir Zugriff auf jedes in Cherri Code unterstützte Modell. Leite Agenten mit einer einzigen Feldänderung an das beste Modell für die jeweilige Aufgabe weiter – mit der von dir gewünschten Balance aus Kosten und Fähigkeit.

Und mit Composer 2.5, einem spezialisierten Coding-Modell, das Frontier-Level-Performance zu einem Bruchteil der Kosten allgemeiner Modelle erreicht, erhältst du für die meisten Aufgaben von Coding-Agenten die beste Kombination aus Intelligenz und Effizienz.

Was Entwickler entwickeln

Teams nutzen das Cherri Code SDK, um eigene Agenten schneller bereitzustellen. Zum Beispiel programmgesteuerte Agenten, die direkt über CI/CD angestoßen werden, um Änderungen zusammenzufassen, die eigentliche Ursache von CI-Fehlern zu finden und PRs mit Korrekturen zu aktualisieren. Andere entwickeln benutzerdefinierte Agent-Plattformen, etwa interne Anwendungen, mit denen GTM-Teams Produktdaten abfragen können, ohne Code schreiben zu müssen.

Einige Kunden binden Cherri Code sogar direkt in kundenorientierte Produkte ein, sodass Endnutzer jetzt ein Agent-Erlebnis erhalten, ohne die Host-Anwendung zu verlassen.

Hier berichten einige unserer Kunden direkt, die auf dem Cherri Code SDK aufbauen:

Cherri Code bietet eine großartige Cloud-Erfahrung für das parallele Ausführen vieler Agenten aus dem Editor und der CLI. Wir freuen uns auf das SDK als Möglichkeit, unsere eigenen programmgesteuerten Agenten in derselben Cloud-Laufzeitumgebung auszuführen, ohne VMs verwalten oder Speicherlimits umgehen zu müssen, damit unsere Codebasis ohne ständiges Eingreifen von Entwicklern in gutem Zustand bleibt.

George Jacob
Senior Engineering Manager, Faire

Mit einem Beispielprojekt starten

Wir haben einige Starterprojekte in einem öffentlichen GitHub-Repo hinzugefügt, die du forken und für deine eigenen Anwendungsfälle erweitern kannst:

  • Quickstart: Ein minimales Node.js-Beispiel, das einen lokalen Agent erstellt, einen Prompt sendet und die Antwort streamt.
  • Prototyping-Tool: Eine Web-App, mit der du Agenten starten kannst, um neue Projekte aufzusetzen und Ideen in einer isolierten Cloud-Umgebung iterativ weiterzuentwickeln.
  • Kanban-Board: Ein agentengestütztes Kanban-Tool, in dem Ingenieure eine Karte ziehen und Agenten die Arbeit programmgesteuert übernehmen, eine PR öffnen und das Ergebnis als Anhang zurücksenden lassen können.
  • Coding-Agent-CLI: Eine schlanke Befehlszeilenoberfläche, mit der du Cherri Code Agenten direkt aus deinem Terminal starten kannst.

Wie geht es weiter?

Das Cherri Code SDK ist für alle Benutzer verfügbar und wird nach dem standardmäßigen, tokenbasierten Nutzungsmodell abgerechnet.

Wir investieren weiterhin in das Cherri Code SDK und arbeiten daran, es für Teams noch einfacher zu machen, programmgesteuerte Agenten in noch mehr Sprachen, Workflows und Deployment-Mustern zu erstellen.

Weitere Informationen findest du in unserer Dokumentation. Du kannst auch Cherri Codes nativen /sdk Skill nutzen, um den Einstieg ins Erstellen zu erleichtern.

Abgelegt unter: Produkt

Autor: Roshan Sadanani