Skip to main content

Command Palette

Search for a command to run...

Agente

Cursor Agent

Agent es el asistente de Cursor que puede completar tareas de programación complejas de forma autónoma, ejecutar comandos de terminal y editar código. Accede a él desde el panel lateral con Cmd+ICtrl+I.

Obtén más información sobre cómo funcionan los agentes y crea más rápido.

Cómo funciona Agent

Un agente se compone de tres elementos:

  1. Instrucciones: La instrucción del sistema y las reglas que guían el comportamiento del agente
  2. Herramientas: Edición de archivos, búsqueda en la base de código, ejecución en la terminal y más
  3. Modelo: El modelo de agente que eliges para la tarea

El agente de Cursor coordina estos elementos para cada modelo que ofrecemos y ajusta las instrucciones y herramientas específicamente para cada modelo de vanguardia. A medida que se lanzan nuevos modelos, puedes centrarte en crear software mientras Cursor se encarga de las optimizaciones específicas de cada modelo.

Herramientas

Las herramientas son los componentes básicos de Agent. Se utilizan para buscar información relevante en tu base de código y en la web, editar tus archivos, ejecutar comandos de terminal y mucho más.

Para entender cómo funcionan internamente las llamadas a herramientas, consulta los fundamentos de las llamadas a herramientas.

No hay límite en la cantidad de llamadas a herramientas que Agent puede realizar durante una tarea.

Busca archivos por nombre, consulta estructuras de directorios y encuentra palabras clave o patrones exactos dentro de los archivos.

Genera consultas de búsqueda y realiza búsquedas en la web.

Recupera reglas específicas según el tipo y la descripción.

Lee de forma inteligente el contenido de un archivo. También admite archivos de imagen (.png, .jpg, .gif, .webp, .svg) y los incluye en el contexto de la conversación para que los analicen modelos con capacidad de visión.

Sugiere ediciones en archivos y las aplica automáticamente.

Ejecuta comandos de terminal y supervisa la salida. De forma predeterminada, Cursor usa el primer perfil de terminal disponible.

Para establecer tu perfil de terminal preferido:

  1. Abre la Paleta de comandos (Cmd/Ctrl+Shift+P)
  2. Busca "Terminal: Select Default Profile"
  3. Elige el perfil que prefieras

Controla un navegador para tomar capturas de pantalla, probar aplicaciones y verificar cambios visuales. Agent puede navegar por páginas, interactuar con elementos y capturar el estado actual para analizarlo. Consulta la documentación del navegador para obtener más información.

Genera imágenes a partir de descripciones de texto o imágenes de referencia. Resulta útil para crear maquetas de UI, recursos de producto y visualizar diagramas de arquitectura. De forma predeterminada, las imágenes se guardan en la carpeta assets/ de tu proyecto y se muestran integradas en el chat.

Haz preguntas aclaratorias durante una tarea. Mientras espera tu respuesta, el agente sigue leyendo archivos, realizando ediciones o ejecutando comandos. Tu respuesta se incorpora en cuanto llega.

Puntos de control

Los puntos de control guardan instantáneas de tu base de código durante una sesión del agente. Agent los crea automáticamente antes de realizar cambios importantes y captura el estado de todos los archivos modificados.

Si Agent se equivoca, haz clic en cualquier punto de control de la cronología del chat para previsualizar tus archivos en ese momento y, después, restáuralo para revertir todos los archivos a ese estado. También puedes restaurar desde el botón Restore Checkpoint de solicitudes anteriores o desde el botón + al pasar el cursor sobre un mensaje. Restaurar un punto de control revierte únicamente los archivos; no elimina mensajes de la conversación.

Los puntos de control son útiles para el trabajo exploratorio, las refactorizaciones complejas y el desarrollo iterativo, cuando necesitas puntos seguros a los que volver.

Mensajes en cola

Tienes dos formas de comunicarte con un agente mientras trabaja. Pon un mensaje en cola y esperará a que termine la tarea actual. Enviar un seguimiento ahora y guiarás el turno activo en la próxima llamada a una herramienta del agente.

Uso de la cola

  1. Mientras el Agent trabaja, escribe la siguiente instrucción
  2. Pulsa Enter para añadirla a la cola
  3. Los mensajes aparecen en orden debajo de la tarea activa
  4. Arrastra los mensajes en cola para reordenarlos según sea necesario
  5. El Agent los procesa en orden tras finalizar

Atajos de teclado

Mientras el Agent trabaja:

  • Pulsa Enter para poner tu mensaje en cola (se enviará cuando el Agent termine la tarea actual)
  • Pulsa Cmd+EnterCtrl+Enter para enviarlo de inmediato, sin pasar por la cola

Mensajería inmediata

Cuando usas Cmd+EnterCtrl+Enter para enviar un mensaje de inmediato, este se añade al mensaje de usuario más reciente del chat y se procesa enseguida, sin esperar en la cola.

  • Tu mensaje se adjunta a los resultados de las herramientas y se envía de inmediato
  • Ofrece una experiencia más ágil para los mensajes de seguimiento urgentes
  • Usa esta opción cuando necesites interrumpir o redirigir el trabajo actual del Agent

Redirigir a un agente en ejecución

Puedes enviar un mensaje de seguimiento para redirigir al agente mientras trabaja, sin interrumpirlo. Escribe un mensaje de seguimiento y haz clic en Enviar ahora o pulsa Enter dos veces. El mensaje se entrega en la siguiente llamada a herramienta del agente, en lugar de interrumpir el trabajo a mitad de una acción, lo que preserva el trabajo en curso y mantiene al agente centrado en la tarea.

Ya está disponible en cursor.com/agents y se está implementando en la ventana de agente de programación. En su lugar, pulsa Tab para poner el mensaje en cola hasta después del turno.

En la CLI, al pulsar Enter mientras el agente trabaja, rediriges la ejecución activa en un punto seguro; al pulsar Enter de nuevo, interrumpes el turno.

Objetivos con /goal

El Agent interpreta cada mensaje como una nueva tarea. Usa /goal para darle al agente un objetivo persistente hacia el que trabajar hasta completarlo por completo:

/goal soluciona todos los tests inestables y haz que CI quede en verde

En la CLI, Ctrl+C pausa el objetivo. Combina un objetivo con un modo personalizado cuando quieras que el agente siga una guía, o con la skill integrada /loop para supervisiones recurrentes mientras lo persigue.