Chat modo Agent

Agent Mode: IA autónoma

El Agent Mode representa el nivel más avanzado de autonomía en el chat de Cursor, diseñado para realizar modificaciones complejas en tu código base de forma independiente. 

A diferencia de los modos Manual y Ask que requieren tu intervención constante, este modo permite que la IA explore y modifique múltiples archivos de tu proyecto sin necesidad de supervisión continua.

Funcionamiento

Agent Mode sigue un enfoque sistemático para completar tareas, muy parecido a un humano:

• Análisis: Agent analiza tu solicitud y el contexto del código base para comprender completamente los requisitos y objetivos de la tarea
• Investigación: Puede buscar en tu código base, documentación y la web para identificar archivos relevantes y entender la implementación actual
• Planificación: Basándose en el análisis, divide la tarea en pasos más pequeños y planifica los cambios
• Ejecución: Realiza las modificaciones de código necesarias según el plan en toda tu base de código
• Validación: Confirma que los cambios se ven correctos después de aplicarlos, e intenta corregir errores de linter si los detecta

Para activar este modo, selecciona Agent desde el selector de modos en el chat de Cursor. Agent es el modo predeterminado y más autónomo en Cursor. También puedes acceder al Agent usando Ctrl+I (Cmd+I en Mac). Simplemente escribe tu solicitud en lenguaje natural:

Implementa un sistema de autenticación completo con JWT para la API de usuarios

La IA procederá a:

• Analizar la estructura actual de tu proyecto
• Identificar los archivos que necesitan modificación
• Crear nuevos archivos si es necesario
• Implementar los cambios de forma coordinada

Checkpoints automáticos y reversión

Agent Mode crea checkpoints antes de realizar cambios, permitiéndote revertir si es necesario. Cursor te ayuda creando automáticamente checkpoints de tu código base en cada solicitud que haces, así como cada vez que la IA hace cambios a tu código base.

Cuando el agente completa su trabajo, verás una interfaz que muestra:

• Archivos modificados con indicadores visuales de los cambios
• Nuevos archivos creados durante el proceso
• Líneas específicas que han sido añadidas, modificadas o eliminadas

Casos de uso ideales

El Agent Mode es muy efectivo para tareas que requieren coordinación entre múltiples archivos:

@agent Refactoriza la clase DatabaseManager para usar async/await y actualiza todos los archivos que la utilizan

En este ejemplo, el agente:

• Modificará la clase DatabaseManager para implementar operaciones asíncronas
• Identificará todos los archivos que importan y utilizan esta clase
• Actualizará las llamadas a métodos para usar await
• Ajustará las importaciones necesarias en cada archivo

Supervisión del proceso

Aunque el Agent Mode opera de forma autónoma, Cursor proporciona retroalimentación en tiempo real sobre el progreso. Verás indicadores que muestran:

• Archivos siendo analizados
• Cambios siendo implementados
• Errores o conflictos detectados durante el proceso

Esta transparencia te permite intervenir si detectas que el agente está tomando una dirección incorrecta, manteniendo el control sobre tu código base mientras aprovechas la automatización inteligente.

Herramientas disponibles para el agente

Cuando el Agent Mode está activo, el agente tiene acceso a un conjunto de herramientas integradas que usa según la necesidad de la tarea:

| Herramienta | Qué hace | |-------------|----------| | File editing | Crear, modificar y eliminar archivos del proyecto | | Terminal | Ejecutar comandos de terminal (con confirmación del usuario) | | Codebase search | Buscar código relevante en todo el proyecto indexado | | Web search | Buscar información en internet si tiene acceso | | Read file | Leer el contenido completo de archivos específicos | | List directory | Explorar la estructura de directorios del proyecto |

El agente decide autónomamente qué herramientas usar y en qué orden. Por ejemplo, para implementar una feature puede primero buscar en el codebase patrones existentes, luego crear archivos nuevos, modificar archivos existentes, ejecutar tests y corregir errores.

Configuración del comportamiento del agente

Desde Cursor Settings > Features > Chat puedes ajustar el comportamiento del agente:

Auto-run commands: controla si el agente puede ejecutar comandos de terminal sin pedir confirmación. Puedes especificar una lista de comandos seguros (como npm test, tsc --noEmit) que el agente puede ejecutar sin preguntar.

File editing permissions: por defecto, el agente puede editar cualquier archivo del proyecto. Puedes restringir esto con .cursorignore para proteger archivos sensibles.

Modelo del agente: selecciona qué modelo de IA usa el agente. Modelos más potentes como Claude Sonnet 4 o Opus 4 producen mejores resultados en tareas complejas, pero consumen más presupuesto.

Buenas prácticas para el Agent Mode

Describe el resultado, no los pasos: en lugar de decir "crea un archivo X, luego añade la función Y", describe qué quieres lograr: "implementa un sistema de autenticación con JWT". El agente planifica mejor cuando conoce el objetivo.

Proporciona contexto con menciones @: usa @archivo y @carpeta para indicar al agente exactamente qué código debe considerar. Un agente con buen contexto comete menos errores.

Divide tareas grandes: para proyectos complejos, es mejor hacer varias peticiones al agente que una sola petición enorme. Cada petición debe ser verificable independientemente.

Verifica con tests: siempre pide al agente que ejecute los tests tras completar los cambios. "Ejecuta los tests y corrige cualquier fallo" es una instrucción potente que cierra el ciclo.

El Agent Mode transforma la forma en que abordas modificaciones complejas, permitiéndote delegar tareas extensas mientras mantienes el control final sobre cada cambio implementado en tu proyecto.

Resumen

El Agent Mode es el modo más autónomo de Cursor: analiza, planifica, ejecuta y válida tareas complejas de forma independiente. Tiene acceso a herramientas de edición de archivos, terminal, búsqueda en el codebase y web. Los checkpoints automáticos permiten revertir en cualquier momento. Para obtener los mejores resultados, describe el objetivo deseado, proporciona contexto con menciones @ y pide al agente que verifique con tests.