· Registro de cambios

Registro de cambios

Crea agentes programáticos con el SDK de Cursor

Presentamos el SDK de Cursor para que puedas crear agentes con el mismo runtime, harness y modelos que impulsan Cursor.

Puedes acceder a los agentes que se ejecutan en la aplicación de escritorio de Cursor, la CLI y la aplicación web con solo unas líneas de TypeScript. Puedes ejecutarlos en tu máquina o en la nube de Cursor, sobre una VM dedicada, con cualquier modelo de vanguardia.

Ejecuta npm install @cursor/sdk para empezar y usa el plugin de Cursor SDK para que Cursor pueda ayudarte a crear.

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

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

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

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

Creamos algunos proyectos de ejemplo a los que puedes acceder desde un repo público. Haz un fork de ellos y amplíalos para tu propio caso de uso.

El SDK de Cursor ya está disponible para todos los usuarios en beta pública y se factura según el precio estándar basado en el consumo de tokens. Obtén más información en nuestro anuncio y la documentación.

  • Se rediseñó la API en torno a agentes duraderos y ejecuciones por prompt, por lo que el seguimiento, el estado, el streaming y la cancelación ahora se aplican a cada ejecución.
  • Se agregó streaming de ejecuciones de primer nivel con eventos SSE, soporte para reconexión mediante Last-Event-ID y estados finales más claros.
  • Se agregaron controles explícitos del ciclo de vida del agente para archivar, desarchivar y eliminar de forma permanente.
  • Se estandarizaron los formatos de respuesta y error de v1, incluidos códigos de error estructurados, respuestas de lista en items y objetos agent / run separados.