Puntos clave
- Cursor Agent SDK es un kit de desarrollo de Cursor, anunciado el 26 de octubre de 2026, que permite definir agentes de IA como código: el prompt en Markdown y las herramientas en TypeScript.
- Los agentes se pueden desplegar en la infraestructura alojada de Cursor o ejecutarse en tu propio entorno, lo que facilita adaptarse a políticas internas de datos.
- Incluye evaluaciones (evals) integradas para medir el efecto de cada cambio en el prompt o en las herramientas, en lugar de mejorar a ciegas.
- Se instala desde la página oficial, cursor.com, mediante Cursor Desktop o la CLI; se necesita iniciar sesión y conviene revisar la página de precios para conocer los planes disponibles.
Datos rápidos
| Tipo | Kit de desarrollo de agentes de IA |
|---|---|
| Dispositivos | Cursor Desktop y CLI; principalmente macOS y PC |
| Precio | Consultar la página de precios en cursor.com |
| Idiomas | Interfaz con cambio de idioma; revisar opciones en la web |
| Lo destacado | Prompts en Markdown, herramientas en TypeScript, evals |
| Dificultad | Media; requiere saber TypeScript y manejar la terminal |
| Categoría | Herramientas dev |
| Creador | Cursor |
| Sitio oficial | cursor.com ↗ |
| Popularidad | 🔥 277,3K Popularidad |
| Última actualización |
Qué es Cursor Agent SDK y por qué se está hablando tanto de él
Cursor Agent SDK es un kit de desarrollo publicado por Cursor el 26 de octubre de 2026 con una idea central: los agentes de IA deben definirse como código. En lugar de configurar un agente a base de clics en un panel web, escribes su prompt en un archivo Markdown y sus herramientas en TypeScript. Así, el agente entra en tu repositorio, se revisa como cualquier otro cambio y se versiona con Git. La propuesta conecta directamente con la forma en que ya trabajan los equipos de software.
El problema que resuelve es la falta de reproducibilidad. Cuando un agente vive en una interfaz gráfica, es difícil saber qué cambió entre la versión que funcionaba y la que falla. Al separar el prompt (Markdown) de las herramientas (TypeScript), cada pieza tiene un responsable claro y un historial de cambios. Además, el kit incluye evaluaciones integradas, de modo que puedes medir si una modificación mejora o empeora el comportamiento antes de llevarla a producción.
Cursor no es una empresa desconocida en el mundo del desarrollo asistido por IA, y este SDK amplía su enfoque hacia agentes que ejecutan tareas más largas. La disponibilidad es oficial: hay una página del Agent SDK dentro del sitio de Cursor, cursor.com, desde donde se accede a la documentación y a las instrucciones de inicio. Si buscas una herramienta para construir agentes con estructura de proyecto real, esta propuesta merece un vistazo.
- Agentes como código, no como configuración
El prompt es un archivo Markdown y las herramientas son módulos TypeScript, así que todo el agente se revisa y se versiona igual que el resto del proyecto.
- Dos modos de despliegue
Puedes ejecutar los agentes en la infraestructura alojada de Cursor o en tus propias máquinas, lo que ayuda cuando hay requisitos internos sobre dónde viven los datos.
- Evals integradas
El kit incorpora evaluaciones para comparar el rendimiento antes y después de cada cambio, en lugar de confiar en impresiones subjetivas.
- Ecosistema alrededor
La documentación menciona funciones como Cloud, Automations, Marketplace y Review, que amplían el ciclo desde la ejecución hasta la revisión en equipo.
Cómo funciona por dentro: Markdown para el prompt, TypeScript para las herramientas
La mecánica es directa. Creas un archivo Markdown donde describes el objetivo del agente, su tono, sus límites y el flujo de trabajo que debe seguir. Ese texto es el prompt del sistema y se puede leer, comentar y modificar sin tocar código. Después escribes las herramientas en TypeScript: funciones que el agente puede invocar para consultar datos, llamar a una API, leer archivos o ejecutar comandos. El SDK conecta ambas partes y expone el agente como una unidad ejecutable.
La ventaja de TypeScript es el tipado. Al declarar entradas y salidas, los errores aparecen durante el desarrollo y no en producción, y el editor puede autocompletar los parámetros de cada herramienta. Esto reduce una de las causas más comunes de fallo en agentes: que el modelo llame a una función con argumentos que no existen o con un formato inesperado. El resultado es un agente más predecible y más fácil de depurar cuando algo sale mal.
Sobre esa base, el SDK añade el ciclo de evaluación. Defines un conjunto de casos, ejecutas el agente y obtienes una medida de su desempeño. Cuando cambias una frase del prompt o añades una herramienta, vuelves a ejecutar las evals y comparas. Ese bucle de medir, cambiar y volver a medir es lo que convierte la mejora del agente en un proceso acumulativo en lugar de una serie de ajustes a ciegas.
- El prompt como documentación viva
Al estar en Markdown, cualquier miembro del equipo puede proponer cambios sin saber TypeScript, y las diferencias se ven línea por línea en la revisión.
- Herramientas tipadas
Cada herramienta en TypeScript declara qué recibe y qué devuelve, lo que evita llamadas con parámetros inválidos y facilita las pruebas unitarias.
- Evaluaciones como red de seguridad
Las evals integradas permiten detectar regresiones cuando tocas el prompt, algo habitual en proyectos donde el agente crece con el tiempo.
- Ejecución alojada o propia
El mismo agente puede correr en la infraestructura de Cursor o en tu servidor, así que puedes empezar alojado y migrar después si cambian los requisitos.
Cómo empezar paso a paso: de la instalación a tu primer agente medido
El punto de entrada es la página oficial del Agent SDK dentro de cursor.com. Desde ahí se descarga Cursor Desktop o la CLI, se inicia sesión con una cuenta y se accede a la documentación. La CLI es la vía más cómoda si prefieres trabajar en la terminal y automatizar tareas, mientras que la aplicación de escritorio resulta útil para ver el estado de las tareas, revisar resultados y seguir el flujo de trabajo con una interfaz visual.
Una vez instalado, el primer objetivo realista no es construir un agente complejo, sino trasladar un prompt que ya uses a un archivo Markdown. Ese ejercicio te obliga a separar instrucciones, contexto y formato de salida, y te da una base que ya conoces. Después añades una o dos herramientas en TypeScript, las más simples posibles, y ejecutas el agente para comprobar que las invoca correctamente.
El paso que muchos omiten y que marca la diferencia es configurar las evals desde el principio. Define unos pocos casos representativos, ejecútalos y guarda la puntuación como referencia. A partir de ahí, cambia una sola cosa a la vez y vuelve a medir. Si la puntuación sube, conserva el cambio; si baja, revíertelo. Este hábito convierte el desarrollo de agentes en algo tan disciplinado como el resto del software.
- Empieza con un caso de uso pequeño
Un agente que resume incidencias o clasifica correos es más fácil de evaluar que uno que debe gestionar un flujo completo desde el primer día.
- Convierte un prompt existente
Migrar un prompt que ya funciona a Markdown te da un punto de partida conocido y te enseña la estructura que espera el SDK.
- Añade herramientas de una en una
Cada herramienta nueva amplía la superficie de error; incorporarlas por separado y probar después de cada una ahorra horas de depuración.
- Mide antes de optimizar
Sin una línea base de evals no sabrás si un cambio mejora el agente; ejecuta las evaluaciones antes de tocar el prompt.
Para quién es, con qué se compara y qué límites conviene conocer
Este SDK encaja bien en equipos que ya desarrollan en TypeScript y quieren incorporar agentes a su producto o a sus procesos internos sin depender de una interfaz cerrada. También es razonable para quien necesita control sobre dónde se ejecutan los datos, porque la opción de autoalojamiento permite mantener la ejecución dentro de la propia infraestructura. En cambio, si buscas crear un agente sin escribir código, esta no es la vía más corta.
Frente a otros marcos de agentes, la diferencia principal es la combinación de tres piezas: prompts en Markdown, herramientas en TypeScript y evaluaciones integradas. Muchos frameworks permiten definir herramientas y orquestar llamadas, pero no siempre incluyen un sistema de medición desde el primer momento, ni la posibilidad de desplegar en infraestructura gestionada por el propio proveedor. Esa mezcla es lo que Cursor presenta como su propuesta diferencial.
Conviene ser prudente con los detalles que no están confirmados. La documentación oficial es la fuente fiable para saber qué lenguajes de programación se admiten además de TypeScript, qué límites tienen los planes y qué capacidades exactas ofrecen Cloud, Automations, Marketplace y Review. Antes de comprometer un proyecto, revisa la página de precios y la documentación en cursor.com, y comprueba los requisitos de tu sistema operativo, ya que la disponibilidad inicial se centra en equipos de escritorio.
- Comparación con frameworks genéricos
La mayoría de alternativas exigen montar tu propio sistema de evaluación; aquí las evals vienen integradas, lo que ahorra trabajo inicial pero ata el flujo a este kit.
- Comparación con asistentes sin código
Las plataformas visuales son más rápidas para prototipos, pero pierden la trazabilidad y la revisión por diferencias que ofrece tener el agente en el repositorio.
- Limitación: dependencia de TypeScript
Si tu equipo trabaja en otro lenguaje, la parte de herramientas requerirá adaptación o un cambio de stack; consulta la documentación para ver el alcance real.
- Limitación: detalles por confirmar
Precios, idiomas de la interfaz y capacidades exactas de las funciones auxiliares deben verificarse en la web oficial antes de decidir.
Guía paso a paso
Accede a la página oficial y elige tu cliente
Entra en cursor.com y busca la sección del Agent SDK. Desde ahí podrás descargar Cursor Desktop o la CLI. Si trabajas en terminal y quieres automatizar, la CLI suele ser la opción más práctica; si prefieres una vista gráfica del estado de las tareas, usa la aplicación de escritorio.
Inicia sesión y revisa la documentación
El uso requiere una cuenta, así que crea una o inicia sesión. Antes de escribir código, dedica unos minutos a la documentación y al registro de cambios: ahí se explican la estructura esperada de un agente y las funciones disponibles. Revisa también la página de precios para conocer los planes.
Escribe tu primer agente en Markdown
Crea un archivo Markdown con el objetivo del agente, el contexto que debe tener en cuenta, el tono y el formato de salida. Empieza con una tarea sencilla que ya conozcas bien. Este archivo es el prompt del sistema y será lo primero que revises cuando el comportamiento no sea el esperado.
Añade herramientas en TypeScript
Define una o dos funciones que el agente pueda invocar, declarando con claridad qué reciben y qué devuelven. Prueba cada herramienta por separado antes de conectarla al agente. Si una llamada falla, el tipado te ayudará a localizar el problema más rápido que leyendo registros de ejecución.
Configura las evals y despliega
Crea un conjunto pequeño de casos de prueba, ejecuta las evaluaciones y guarda la puntuación como línea base. Después decide si ejecutas el agente en la infraestructura alojada de Cursor o en tu propio entorno. Cambia una cosa a la vez y vuelve a medir para confirmar que mejoras.
Preguntas frecuentes
¿Cuánto cuesta Cursor Agent SDK y hace falta pagar para probarlo?
El SDK se distribuye a través de la página oficial de Cursor, cursor.com, y los planes y sus condiciones se detallan en la sección de precios de ese sitio. No conviene dar por hecho un modelo gratuito ni un precio concreto sin consultarlo, porque la información puede cambiar. Lo recomendable es revisar la página de precios y la documentación antes de empezar, y comprobar si existe alguna modalidad de prueba para equipos.
¿En qué dispositivos y sistemas puedo usarlo?
El acceso se realiza mediante Cursor Desktop o la CLI, por lo que el trabajo se hace principalmente en equipos de escritorio. La disponibilidad inicial se asocia a macOS, y para otros sistemas conviene verificar los requisitos en la documentación oficial antes de instalar. La parte de documentación y registro de cambios se puede consultar desde el navegador, lo que facilita leer las novedades desde cualquier equipo.
¿Necesito saber programar para crear un agente con este kit?
Sí, al menos para aprovecharlo de verdad. Los prompts se escriben en Markdown, que es sencillo, pero las herramientas se definen en TypeScript, así que necesitas soltura con ese lenguaje y con la terminal. Si tu equipo no usa TypeScript, valora el coste de adaptación. Para perfiles sin experiencia en código, las plataformas visuales de agentes suelen ser un punto de partida más realista.
¿Qué son las evals integradas y por qué se insiste tanto en ellas?
Son evaluaciones que ejecutan tu agente contra un conjunto de casos y producen una medida de su desempeño. Sirven para comparar el antes y el después de cada cambio en el prompt o en las herramientas. Sin ellas, mejorar un agente se vuelve una cuestión de impresiones, y es fácil introducir regresiones sin darse cuenta. Con evals, cada modificación se justifica con datos y el progreso se acumula.
¿Puedo ejecutar los agentes en mis propios servidores?
Sí, el SDK contempla dos modos: desplegar en la infraestructura alojada de Cursor o ejecutar los agentes en tu propio entorno. La opción de autoalojamiento resulta útil cuando hay requisitos internos sobre dónde se procesan los datos o cuando quieres integrar el agente en sistemas ya existentes. Los detalles técnicos y los requisitos de cada modo conviene consultarlos en la documentación oficial, ya que pueden variar con las actualizaciones.
