Mejores prácticas

Usa estas recomendaciones para obtener ejecuciones más fiables del Cloud Agent.

Configura primero el entorno

Usa Configuración del agente en la nube para que Cursor tenga su entorno configurado. Al igual que un desarrollador humano, Cursor trabaja mejor si su entorno está bien configurado.

Asegúrate de que el agente pueda acceder a lo que necesita

Antes de ejecutar un agente en la nube, verifica estos requisitos previos:

• Secretos: Asegúrate de que el agente tenga acceso a los secretos necesarios (claves de API, credenciales de base de datos, etc.) a través de la pestaña Secretos en tu panel. Para los roles en la nube, prefiere los tokens OIDC en lugar de las claves de acceso de larga duración.
• Controles de salida: Si tienes activadas las restricciones de acceso a la red, asegúrate de que todas las URL que tu entorno de desarrollo local necesita estén en la lista de permitidas.
• Capacidad de prueba local: Tu repositorio debe estar configurado para ejecutarse correctamente de forma local sin requerir servicios externos a los que no se pueda acceder desde una VM. Si es difícil para una persona desarrolladora hacer pruebas en local, también será difícil para un agente.

Usa skills y agents.md para configurar tu agente

Si el cloud agent tiene dificultades para probar sus cambios, te recomendamos usar skills y agents.md para configurar tu agente.

Piensa en el agente como un desarrollador humano inteligente, pero con poco contexto. La mejor manera de asegurarte de que haga lo correcto es darle el contexto que necesita para entender qué debe hacer.

Por ejemplo, en Cursor nuestro agents.md enumera consejos para ejecutar y depurar los microservicios más utilizados en nuestro monorepo. También tenemos muchas skills sobre cómo probar y depurar servicios clave, cada una con instrucciones claras sobre cuándo usar la skill.

Las skills contienen detalles detallados, como cómo depurar un microservicio específico o cómo configurar una dependencia de terceros cuando se necesite para las pruebas.

Usa reglas para hacer cumplir convenciones

Los agentes en la nube pueden leer y seguir reglas en tres niveles:

• Reglas de usuario: Configuradas en Cursor Settings, se aplican a tus sesiones en todos los repositorios. Son ideales para reglas que solo quieres que se te apliquen a ti.
• Reglas del equipo: Configuradas en el Panel de control de Reglas, Comandos y Hooks, se aplican a todos los miembros del equipo en todos los repositorios. Son ideales para convenciones de toda la organización.
• Reglas del repositorio: Archivos .cursor/rules/*.mdc confirmados en el repositorio; se aplican a todos los agentes de programación que usan ese repositorio. Son ideales para convenciones específicas del repositorio o del proyecto.

Proporciona al agente las herramientas que necesita

A menudo hemos observado que los agentes están limitados por las herramientas a las que tienen acceso. Recomendamos usar MCP y crear herramientas personalizadas para que el agente tenga acceso a los mismos sistemas que tendría un desarrollador humano.

Adapta las herramientas al agente

Es importante crear herramientas que el agente sepa usar bien. Recomendamos crear herramientas e iterar a partir de observaciones sobre cómo el agente las utiliza.

Por ejemplo, en Cursor hemos creado una CLI personalizada para que el modelo ejecute microservicios en nuestra base de código. Descubrimos que, al ejecutar comandos de desarrollo personalizados, p. ej. desde un archivo package.json, algunos modelos olvidaban argumentos o los agentes se distraían con registros de compilación ruidosos que los desarrolladores humanos sabían ignorar.