Cómo usar
- Barra lateral de agentes en segundo plano: Usá la pestaña de agentes en segundo plano en la barra lateral nativa de Cursor para ver todos los agentes en segundo plano asociados con tu cuenta, buscar agentes existentes y arrancar nuevos.
- Modo de agente en segundo plano: Presioná para activar el modo de agente en segundo plano en la UI.
Los agentes en segundo plano requieren retener datos por unos pocos días.
Configuración
Conexión con GitHub
Configuración de la lista de IP permitidas
Configuración base del entorno
- El comando de instalación se ejecuta antes de que arranque un agente e instala las dependencias de runtime. Esto puede implicar ejecutar
npm install
obazel build
. - Los terminales ejecutan procesos en segundo plano mientras el agente trabaja, como iniciar un servidor web o compilar archivos protobuf.
COPY
de todo el proyecto: nosotros gestionamos el workspace y hacemos checkout del commit correcto. Aun así, gestiona la instalación de dependencias en el script de instalación.
Ingresa cualquier secreto requerido para tu entorno de desarrollo: se almacenan cifrados en reposo (usando KMS) en nuestra base de datos y se proporcionan en el entorno del agente en segundo plano.
La configuración de la máquina vive en .cursor/environment.json
, que puedes commitear en tu repo (recomendado) o almacenar de forma privada. El flujo de configuración te guía para crear environment.json
.
Comandos de mantenimiento
install
de tu environment.json
. Este comando es el que ejecutaría un desarrollador al cambiar de rama: instalar cualquier dependencia nueva.
Para la mayoría, el comando install
es npm install
o bazel build
.
Para asegurar un arranque rápido de la máquina, almacenamos en caché el estado del disco después de que se ejecute el comando install
. Diseñalo para que pueda ejecutarse varias veces. Solo persiste el estado del disco desde el comando install
: los procesos iniciados aquí no seguirán en ejecución cuando el agente arranque.
Comandos de inicio
install
, la máquina arranca y ejecutamos el comando start
, seguido de iniciar cualquier terminals
. Esto levanta procesos que deberían estar en ejecución cuando se ejecute el agente.
El comando start
a menudo se puede omitir. Úsalo si tu entorno de dev depende de Docker: pon sudo service docker start
en el comando start
.
Los terminals
son para código de la app. Estos terminales se ejecutan en una sesión de tmux
disponible para ti y para el agente. Por ejemplo, muchos repos de sitios web ponen npm run watch
como un terminal.
La especificación de environment.json
environment.json
puede tener este aspecto:
Modelos
Precios
Seguridad
- Concede privilegios de lectura y escritura a nuestra app de GitHub en los repos que quieras editar. Usamos esto para clonar el repo y hacer cambios.
- Tu código se ejecuta dentro de nuestra infraestructura en AWS, en VMs aisladas, y se almacena en discos de VM mientras el agente está activo.
- El agente tiene acceso a Internet.
- El agente ejecuta automáticamente todos los comandos de terminal, lo que le permite iterar en las pruebas. Esto difiere del foreground agent, que requiere tu aprobación para cada comando. La ejecución automática introduce riesgo de exfiltración de datos: atacantes podrían lanzar ataques de prompt injection, engañando al agente para que suba código a sitios web maliciosos. Consulta la explicación de OpenAI sobre los riesgos de prompt injection para background agents.
- Si Privacy Mode está deshabilitado, recopilamos prompts y entornos de desarrollo para mejorar el producto.
- Si deshabilitas Privacy Mode al iniciar un background agent y luego lo habilitas durante la ejecución, el agente sigue con Privacy Mode deshabilitado hasta que termine.
Configuración del dashboard
Configuración predeterminada
- Modelo predeterminado – el modelo que se usa cuando una ejecución no especifica ninguno. Elige cualquier modelo compatible con Max Mode.
- Repositorio predeterminado – si está vacío, los agentes te piden que elijas un repo. Indicar un repo aquí te permite saltarte ese paso.
- Rama base – la rama desde la que los agentes crean un fork al abrir pull requests. Déjala en blanco para usar la rama predeterminada del repositorio.
Configuración de seguridad
- Restricciones de usuario – elige Ninguna (todos los miembros pueden iniciar agentes en segundo plano) o Lista de permitidos. Cuando está en Lista de permitidos, especificas exactamente qué compas de equipo pueden crear agentes.
- Seguimientos del equipo – cuando está activado, cualquiera en el espacio de trabajo puede añadir mensajes de seguimiento a un agente que inició otra persona. Apágalo para restringir los seguimientos al propietario del agente y a los admins.
- Mostrar resumen del agente – controla si Cursor muestra las imágenes de diferencias de archivos del agente y los fragmentos de código. Desactívalo si prefieres no exponer rutas de archivo o código en la barra lateral.
- Mostrar resumen del agente en canales externos – extiende la opción anterior a Slack o cualquier canal externo que tengas conectado.