El Agent SDK ya está disponible. Con él puedes definir un agente como una carpeta de código, probarlo con evaluaciones y desplegarlo en Cursor o en tu propia infraestructura.

Ejecuta npx @cursor/agent-sdk init ./my-bot y luego agent-sdk dev para iniciar el bot en local con un entorno de pruebas. Usa --template para partir de una plantilla: un revisor de seguridad, un aprobador basado en políticas de propietarios, un corrector automático de PR o un bot de clasificación y priorización para Linear o Jira.

#Despliega agentes donde los necesites

Cuando tengas un agente listo para usar, puedes desplegarlo en Cursor ejecutando agent-sdk deploy desde el directorio del proyecto. El comando crea el agente, le asigna una URL y lo inicia en nuestra infraestructura. Puedes gestionar los secretos y las integraciones desde el dashboard, y seguir usando los mismos logs, evaluaciones y entorno de pruebas que tienes en local.

#Agentes como código

Un agente es un proyecto. instructions.md es el prompt. Cada archivo de tools/ es una acción tipada que el modelo puede invocar. skills/ contiene procedimientos que el modelo carga bajo demanda, mcp-connections/ agrega herramientas de servidores MCP y channels/ define dónde recibe y responde mensajes el bot. agent-sdk validate comprueba el proyecto y agent-sdk info imprime lo que se ha descubierto.

#Canales

Los agentes se activan con eventos de PR, comentarios y CI de GitHub, GitLab y Bitbucket; con menciones y mensajes directos en Slack; con webhooks de cualquier proveedor; y según una programación cron. Los eventos de GitHub se obtienen a través de tu cuenta de Cursor, así que no necesitas ninguna URL pública de webhook. Slack funciona de serie sin configuración adicional.

Cada conversación mantiene su propia sesión y un registro completo de todos los mensajes y llamadas a herramientas. Las preguntas de seguimiento en un PR o en un hilo de Slack reanudan la misma sesión.

#Evaluaciones

Una evaluación envía un mensaje fijo al bot y comprueba lo que hizo: qué herramientas se ejecutaron, con qué entrada y qué estructura tiene la respuesta. Ejecuta agent-sdk eval en local o en CI.

agent-sdk github replay <pr-url> convierte un PR real en cargas útiles de webhook firmadas y las envía al bot, para que puedas probar los bots que dependen de GitHub sin tener que esperar a un push. Agrega --dry-run --fixtures-dir fixtures/ para guardar las cargas útiles como fixtures de evaluación.

#Comenzar

El Agent SDK ya está disponible de forma general. Lee la documentación y empieza a usarlo.