Cursor lanza Agent SDK: agentes como código y despliegue con un solo comando

Cursor ha abierto a todos Agent SDK, el framework interno con el que la compañía crea sus propios agentes gestionados: Bugbot, Security Reviewer y Rollouts. La idea es sencilla. El agente se describe en código, vive en el repositorio, pasa por revisión como cualquier otro software y llega a producción con el comando agent-sdk deploy. El SDK ya está en estado de general availability.

Hasta ahora, los equipos tenían dos caminos: o adoptar un producto ya hecho, pensado para el flujo de trabajo de otros, o escribir el agente desde cero. Cursor propone una tercera vía: tomar el mismo armazón que usan sus propios ingenieros y adaptarlo a las reglas de cada equipo.

El agente como un pequeño proyecto de software

La estructura de un agente recuerda a un repositorio normal. Las instrucciones se escriben en Markdown, las herramientas se describen con funciones en TypeScript, y junto a ellas están las conexiones a servicios externos y los evals con los que se prueba el agente. Cada archivo se encarga de algo que el agente sabe o sabe hacer.

De ahí se deriva la consecuencia práctica principal: los cambios en el comportamiento del agente pasan por el mismo pull request, el mismo historial de commits y la misma revisión que el resto del código. El equipo puede leer y editar las políticas por las que se rige el agente, en lugar de adivinar qué ocurre dentro de una caja negra ajena.

La definición básica de un agente ocupa unas pocas líneas. En el ejemplo de la documentación se llama a defineAgent del paquete @cursor/agent-sdk, se fija el nombre Robo, el modelo composer-2.5 con los parámetros effort: high y fast: true, y un directorio de trabajo local. Después se puede iterar en un playground local, ejecutar evals y solo entonces desplegar.

Reacción a eventos y trabajo en equipo de agentes

Los agentes se conectan a los lugares donde trabaja el equipo y se activan con eventos. El ejemplo del anuncio: un agente escucha los eventos de pull request en GitHub, GitLab o Bitbucket, evalúa el riesgo del cambio, lo dirige al equipo adecuado y aprueba por sí mismo las modificaciones que encajan en la política.

Dentro de Cursor, uno de los equipos había acumulado una base de conocimiento grande y en rápido crecimiento, con lecciones de decisiones pasadas, y quería que cada PR se comprobara contra ella. Con Agent SDK montó kb-reviewer en aproximadamente un día. El agente trabaja en cada PR de la base de código principal, señala los cambios que contradicen una lección registrada, enlaza la nota que respalda cada observación y empuja a los ingenieros a corregir las discrepancias.

Para tareas complejas, un agente puede pasar el trabajo a otro agente especializado, con sus propias herramientas y sesiones, o dividir la tarea entre subagentes que trabajan en paralelo. Los evals y la reproducción de eventos (event replay) vienen integrados de serie, de modo que los escenarios críticos se pueden comprobar antes del despliegue.

Despliegue y primeros clientes

El comando agent-sdk deploy, ejecutado desde el directorio del proyecto, compila el agente, le asigna una URL y lo lanza en la infraestructura de Cursor. Los secretos y las integraciones se configuran en el dashboard, y los logs, los evals y el playground funcionan igual que en local. La alternativa es ejecutar el agente en la infraestructura propia: cada agente es un único proceso de Node y se puede empaquetar en un contenedor.

El primer cliente destacado es PGA Tour. Según Michael Gyarmathi, ingeniero jefe de PGA America, el equipo construyó todos los componentes de su fábrica de desarrollo de software sobre la infraestructura de Cursor, y los evals integrados permiten probar ideas nuevas con rapidez y optimizar de forma fiable las capacidades existentes.

Qué incluye el lanzamiento

• Un framework para describir agentes en código: prompts en Markdown, herramientas en TypeScript
• Plantillas de inicio y habilidades (skills) que guían al agente de programación a lo largo del proceso de desarrollo
• Triggers para eventos de GitHub, GitLab y Bitbucket
• Traspaso de tareas entre agentes especializados y subagentes en paralelo
• Evals y event replay integrados
• Playground local y despliegue en la infraestructura de Cursor con un solo comando, agent-sdk deploy
• Dashboard para secretos, integraciones y logs
• Ejecución en infraestructura propia: un único proceso de Node, contenedor

Además, Cursor propone no escribir el agente a mano: basta con dirigir a tu agente de programación a la documentación y te ayudará a montar el bot.

Para los equipos que ya automatizan la revisión, el compliance y el análisis de incidentes, la conclusión práctica es esta: empieza por un único proceso repetitivo con reglas claras, por ejemplo la comprobación de PR contra una base de conocimiento interna, como hizo kb-reviewer. Crea los evals antes del primer despliegue, guarda el agente en el repositorio principal y decide de antemano si necesitas el hosting de Cursor o un contenedor propio. Así, el agente será una parte del sistema tan gestionable como el resto del código.