Cursor lanza Agent SDK: un framework para crear agentes autónomos en segundo plano de revisión y testingArtículo · digest del 30 de octubre
Diorama isométrico del puesto de trabajo de un programador con la terminal de Cursor Agent SDK y un robot autónomo revisor de código.
Artículo4 secciones≈ 6 min

Cursor lanza Agent SDK: un framework para crear agentes autónomos en segundo plano de revisión y testing

Si escribes código, es muy probable que conozcas el editor Cursor. Hasta ahora, la interacción con la red neuronal dentro del entorno giraba en torno al diálogo interactivo: pulsas un atajo, abres el panel Composer, formulas la tarea y te quedas mirando la pantalla mientras los archivos cambian línea a línea. Eso acelera muchísimo el desarrollo, pero arrastra una limitación arquitectónica de fondo: una persona tiene que seguir dentro del bucle (human-in-the-loop) en cada paso.

El equipo de Cursor ha decidido romper ese esquema presentando Cursor Agent SDK, un framework especializado y herramienta de consola (CLI) que permite sacar la lógica del agente fuera del editor del usuario. Ahora el comportamiento de un ingeniero virtual se formaliza como un repositorio independiente con una estructura estricta de instrucciones, herramientas tipadas y canales de comunicación. En la práctica, han abierto la misma infraestructura interna (harness) sobre la que corren sus propios servicios en segundo plano, como Bugbot y los escáneres automáticos de seguridad.

He revisado a fondo la especificación del SDK, he probado la ejecución local por CLI y he montado un prototipo funcional de agente para revisar código. Veamos cómo está construido este armazón y cómo delegar la revisión rutinaria de pull requests a un worker autónomo en la nube.

Estructura del proyecto: de prompts caóticos a código limpio

El mayor valor de Agent SDK está en la estandarización. Antes, los scripts agénticos parecían espaguetis: los desarrolladores mezclaban en un mismo sitio prompts de sistema, claves API, expresiones regulares y llamadas al sistema operativo. Mantener esos apaños en producción era un infierno.

En Cursor Agent SDK cada agente se organiza como un módulo completo de ingeniería con una jerarquía de archivos clara:

  • instructions.md: Manifiesto base del sistema que describe la especialización, restricciones arquitectónicas y reglas rígidas de comportamiento del agente.
  • tools/: Directorio con funciones fuertemente tipadas en TypeScript o Python que ejecutan acciones prácticas en el mundo exterior.
  • skills/: Conjunto de instrucciones modulares dinámicas que el modelo carga bajo demanda al pasar a subtareas específicas (por ejemplo, protocolo de migración de base de datos o normas para documentar APIs).
  • mcp-connections/: Manifiestos de conexión a servidores mediante el protocolo abierto Model Context Protocol para integrarse con bases de conocimiento corporativas.
  • channels/: Conectores hacia interfaces externas —bots de Slack, webhooks de Pull Requests en GitHub o tickets en Linear y Jira—.

Este enfoque permite guardar al agente en un repositorio Git normal, versionar sus reglas de comportamiento junto al código del proyecto y actualizar prompts mediante un pull request estándar con revisión obligatoria por parte del equipo.

Implementación de herramientas personalizadas en TypeScript

Veamos cómo se inicializa un agente y se define una herramienta a medida. El SDK utiliza la librería Zod para validar estrictamente los parámetros de entrada, protegiendo al sistema frente a llamadas mal formadas por parte de la red neuronal:

import { Agent, tool } from '@cursor/agent-sdk';
import { z } from 'zod';
import { execSync } from 'child_process';

// Creación de una herramienta para ejecutar la suite de pruebas y comprobar la cobertura
const testRunnerTool = tool({
  name: 'run_test_coverage',
  description: 'Ejecuta la suite de pruebas local en un entorno aislado y devuelve el informe de cobertura de código',
  parameters: z.object({
    testPath: z.string().describe('Ruta relativa al directorio o archivo de pruebas'),
    coverageThreshold: z.number().min(0).max(100).default(80).describe('Porcentaje mínimo aceptable de cobertura')
  }),
  execute: async ({ testPath, coverageThreshold }) => {
    try {
      const output = execSync(`npm test -- ${testPath} --coverage --json`, { encoding: 'utf-8' });
      const report = JSON.parse(output);
      const isPassing = report.total.lines.pct >= coverageThreshold;
      return { success: isPassing, pct: report.total.lines.pct, details: report.summary };
    } catch (error: any) {
      return { success: false, error: error.message };
    }
  }
});

// Configuración del agente de seguridad en segundo plano
export const securityReviewer = new Agent({
  name: 'SecurityReviewerBot',
  instructionsPath: './instructions.md',
  tools: [testRunnerTool],
  model: 'claude-3-5-sonnet-20241022',
  executionMode: 'isolated_cloud_vm'
});

Fíjate especialmente en el parámetro executionMode: 'isolated_cloud_vm'. El agente no ejecuta código sin verificar en tu estación física de trabajo: el entorno en la nube de Cursor levanta una máquina virtual desechable aislada en sandbox, clona ahí el commit correspondiente, corre los comandos de prueba y destruye el contenedor en cuanto genera el informe. Esto elimina por completo el riesgo de dañar el sistema de archivos local.

Desarrollo local y despliegue mediante CLI

El ciclo de creación y depuración de un asistente virtual se acerca mucho al flujo habitual del desarrollo web moderno:

# Instalación global de la herramienta Cursor Agent CLI
npm install -g @cursor/agent-cli

# Inicialización de un nuevo proyecto plantilla de agente en TypeScript
cursor-agent init automated-qa-reviewer --template=typescript

# Ejecución local del agente en modo de simulación interactiva
cursor-agent run --interactive --repo=./my-target-project

Tras terminar las pruebas en local, el agente se despliega en la infraestructura Cursor Cloud con un único comando: cursor-agent deploy. Cuando salta un evento disparador (por ejemplo, la apertura de un pull request con la etiqueta needs-review en GitHub), el agente despierta automáticamente, recoge el contexto de la rama, analiza los cambios y deja un informe estructurado con sugerencias de parches listas en los comentarios del código.

El paso del chat interactivo a los workers en segundo plano

La llegada de Cursor Agent SDK marca un giro tectónico en toda la industria del desarrollo con IA. Dejamos atrás el modelo ingenuo de «el programador sentado frente a la pantalla esperando la respuesta del chatbot» para pasar al modelo de «un enjambre autónomo de colaboradores especializados en segundo plano».

El desarrollador programa una funcionalidad, hace push del commit a la rama remota y cierra tranquilo la tapa del portátil. Los agentes construidos con Cursor SDK realizan en segundo plano la auditoría de seguridad, comprueban compatibilidad de dependencias, cazan casos límite en los tests y dejan el informe preparado para cuando empiece la jornada laboral. Esto es exactamente lo que debe ser la inteligencia artificial práctica: infraestructura discreta y fiable trabajando entre bastidores en tu proyecto.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 1