Agentes en la nube
Los agentes en la nube usan los mismos conceptos básicos de los agentes, pero se ejecutan en VM aisladas en la nube con entornos de desarrollo completos, en lugar de hacerlo en tu máquina local. El entorno de desarrollo es similar a la configuración de tu laptop: repositorios clonados, dependencias instaladas, secretos, comandos de inicio y acceso de red.
Los entornos de desarrollo eficaces les dan a los agentes todo el contexto de tu base de código y tu organización, para que puedan probar y verificar su trabajo.
¿Por qué usar Agentes en la nube?
Puedes ejecutar en paralelo tantos agentes en la nube como quieras, y no necesitan que tu equipo local esté conectado a internet.
Como tienen acceso a su propia máquina virtual, los agentes en la nube pueden crear, probar e interactuar con el software modificado. También pueden usar computadoras para controlar el escritorio y el navegador. Los agentes en la nube son compatibles con servidores MCP, lo que les da acceso a herramientas externas y fuentes de datos, como bases de datos, API y servicios de terceros.
Los agentes en la nube también pueden ejecutarse en entornos multi-repo. Usa uno cuando una tarea abarque repositorios separados de frontend, backend, infraestructura o bibliotecas compartidas. El agente puede inspeccionar todo el espacio de trabajo, hacer cambios coordinados y abrir pull requests en los repositorios que modifique.
Cómo acceder
Antes de que alguien pueda iniciar un agente en la nube desde un repositorio, un administrador de la cuenta de Cursor debe conectar el control de código fuente de la cuenta. Configura GitHub (Cloud and Enterprise Server), GitLab (Cloud and Self-Hosted), Bitbucket Cloud o Azure DevOps.
Puedes iniciar agentes en la nube desde donde trabajes:
- Cursor para iOS: Inicia y gestiona agentes desde la app de Cursor para iOS
- Cursor Web: Inicia y gestiona agentes desde cursor.com/agents en cualquier dispositivo
- Cursor Desktop: Selecciona Cloud en el menú desplegable bajo la entrada del agente
- Slack: Usa el comando @cursor para iniciar un agente
- GitHub o Bitbucket: Comenta
@cursoren una PR o problema de GitHub, o en una PR de Bitbucket, para iniciar un agente - Linear: Usa el comando @cursor para iniciar un agente
- API: Usa la API para iniciar un agente
En Android, usa cursor.com/agents en Chrome y toca Instalar aplicación para usar una aplicación web progresiva (PWA). Consulta Cursor para iOS para la app nativa para iPhone y iPad y más opciones móviles.
Usar Cursor en Slack
Más información sobre cómo configurar y usar la integración con Slack, incluida la activación de agentes y la recepción de notificaciones.
Cómo funciona
Conexión con el proveedor del repositorio
Los agentes en la nube clonan tu repositorio desde GitHub, GitLab, Azure DevOps Services o Bitbucket Cloud y trabajan en una rama aparte; luego suben los cambios a tu repositorio para que puedas retomarlos.
Necesitas permisos de lectura y escritura en tu repositorio y en cualquier repositorio dependiente o submódulo.
Entornos
Los agentes son tan capaces como los entornos en los que se ejecutan. Un agente que puede escribir código pero no puede ejecutar pruebas, consultar servicios ni acceder a APIs no puede completar su trabajo de principio a fin.
No configurar un entorno de desarrollo para tus agentes en la nube es como no darles una computadora a tus ingenieros. Por eso, la configuración del entorno es el paso más importante para mejorar la eficacia de los agentes en la nube. Les permite trabajar como lo hacen los ingenieros: escribir código, ejecutar pruebas y verificar su trabajo, y lanzar software.
Puedes configurar entornos con una configuración guiada por el agente, una instantánea guardada o un Dockerfile en .cursor/environment.json. Consulta Configuración del agente en la nube para empezar. Las compilaciones preparan cada entorno en segundo plano para que los agentes comiencen con los repositorios y las dependencias listos.
El panel de control de agentes en la nube muestra qué entorno y compilación usó un agente, junto con los detalles del entorno y el historial de versiones. En la página del agente, coloca el cursor sobre el nombre del repositorio en la parte superior de la página para inspeccionar el entorno usado en esa ejecución. Consulta Configuración del agente en la nube para ver los detalles de configuración.
Controles del runtime y del entorno
Cursor se encarga del aprovisionamiento de VM, el aislamiento, las instantáneas, el inicio, los artefactos y la capacidad de cada agente en la nube. Puedes añadir secretos, restringir dominios de salida, conectarte a redes privadas con Tailscale o un cliente similar, y usar conectividad privada para rutas compatibles de control de código fuente.
Consulta Seguridad y red de los agentes en la nube para ver el conjunto completo de controles de entorno y red. Si estás valorando si autohospedarte, consulta por qué la mayoría de los equipos empiezan con Cursor Cloud.
Modelos
Los agentes en la nube usan una selección de modelos cuidadosamente elegida. Puedes seleccionar el tamaño de la ventana de contexto para los modelos admitidos.
Compatibilidad con MCP
Los agentes en la nube pueden usar servidores MCP (Model Context Protocol) configurados para tu equipo. Añade y gestiona servidores MCP desde el menú desplegable de MCP en cursor.com/agents.
Se admiten los transportes HTTP y stdio. OAuth es compatible con los servidores MCP que lo requieran. Consulta Capacidades del agente en la nube para ver los detalles de configuración.
Los agentes en la nube también incluyen un Cursor Cloud MCP integrado para diagnósticos de ejecución, incluidas transcripciones, eventos de ejecución, detalles del entorno y registros de configuración.
Compatibilidad con hooks
Los agentes en la nube ejecutan hooks basados en comandos desde .cursor/hooks.json en tu repositorio. En los planes Enterprise, también ejecutan hooks de equipo y hooks gestionados por la empresa.
Esto mantiene activos los formateadores, los scripts de auditoría y las verificaciones de políticas cuando el trabajo se ejecuta en la nube. Los hooks compatibles incluyen hooks de herramientas y archivos (preToolUse, beforeShellExecution, afterFileEdit), además de hooks de ciclo de vida (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought y stop).
Los hooks no se ejecutan durante las primeras interacciones exploratorias en un entorno de solo lectura; comienzan una vez que el agente tiene un entorno con acceso de escritura. Algunos hooks son específicos del IDE (Tab hooks, workspaceOpen). Los hooks de nivel de usuario de ~/.cursor/hooks.json tampoco están disponibles, ya que las VM en la nube no tienen acceso a tu directorio personal local.
Consulta Hooks: compatibilidad del agente en la nube para ver la matriz de compatibilidad completa y más detalles.
Artefactos y control remoto del escritorio
Los agentes en la nube generan PR listos para fusionar con artefactos para mostrar sus cambios. También puedes controlar el escritorio remoto del agente para usar el software modificado.
- Artefactos: los agentes generan capturas de pantalla, vídeos y registros para que puedas ver exactamente qué cambió y cómo el agente verificó su trabajo.
- Control remoto del escritorio: toma el control del escritorio del agente para probar tú mismo el software en un entorno de desarrollo completo sin tener que hacer checkout de la rama en local. Devuélvele el control al agente para que siga trabajando.
Consulta Capacidades del agente en la nube para obtener más información sobre artefactos, uso del ordenador y control remoto del escritorio.
Comparte agentes de programación con tu equipo
Envía la URL de un agente de programación a un compañero de equipo para que pueda abrir la ejecución y ver la conversación, los cambios de código y los artefactos que produjo el agente.
Los agentes de programación son visibles para los miembros del equipo de Cursor en el que se iniciaron. Cursor también verifica el acceso al repositorio de cada persona que quiera verlos: para abrir el agente de programación de un compañero de equipo, conecta tu propia cuenta de control de código fuente en Integraciones y asegúrate de tener acceso al repositorio en el que trabajó el agente. Pertenecer al equipo por sí solo no concede acceso.
La visualización es de solo lectura. Para permitir que los compañeros de equipo envíen mensajes de seguimiento y continúen el trabajo, un administrador de equipo puede activar los mensajes de seguimiento del equipo.
Páginas relacionadas
- Más información sobre las capacidades del agente en la nube.
- Más información sobre la configuración del agente en la nube.
- Más información sobre las compilaciones del agente en la nube.
- Más información sobre la seguridad del agente en la nube.
- Más información sobre los tokens de OIDC.
- Más información sobre los ajustes del agente en la nube.
Facturación
Los agentes en la nube se cobran según los precios de la API para el modelo seleccionado. Puedes seleccionar el tamaño de la ventana de contexto, y una ventana de contexto más grande puede aumentar el consumo de tokens y los costes. Se te pedirá que establezcas un límite de gasto cuando empieces a usarlos por primera vez.
Solución de problemas
- Asegúrate de haber iniciado sesión y de haber conectado tu cuenta de GitHub, GitLab, Azure DevOps o Bitbucket.
- Comprueba que tienes los permisos necesarios del repositorio.
- Debes estar en un plan de pago de Cursor.
- Asegúrate de haber añadido secretos en cursor.com/dashboard/cloud-agents
- Los secretos están limitados al espacio de trabajo/equipo; asegúrate de usar la cuenta correcta
- Intenta reiniciar el agente en la nube después de añadir nuevos secretos
- Si no la ves, asegúrate de tener los permisos necesarios
Las instantáneas guardan la configuración base de tu entorno (paquetes instalados, dependencias del sistema, etc.).
Si incluyes archivos .env.local durante la creación de la instantánea, se guardarán. Sin embargo, usar la pestaña Secretos
en Cursor Settings es la forma recomendada de gestionar variables de entorno.
- El compañero de equipo debe pertenecer al mismo equipo de Cursor que tú.
- Debe conectar su propia cuenta de control de código fuente en Integraciones y tener acceso al repositorio en el que trabajó el agente.
- Consulta Share agents with your team para obtener más detalles.
Verifica que el administrador de tu espacio de trabajo haya instalado la aplicación de Cursor para Slack y que tengas los permisos adecuados.
Historial de nombres
Los agentes en la nube anteriormente se llamaban agentes en segundo plano.