Prompts para agentes

Dirige al agente con instrucciones de texto en el campo de entrada del chat. Puedes adjuntar contexto, imágenes y audio, y cambiar de modelo en cualquier momento.

Menciones con @

Escribe @ en el campo de entrada del chat para adjuntar contexto específico a tu instrucción. Empieza a escribir después de @ y Cursor mostrará sugerencias coincidentes.

• Archivos y carpetas: @auth.ts o @src/components/ para incluir archivos o carpetas (escribe / después de seleccionar una carpeta para profundizar en ella)
• Terminales: @Terminals para incluir la salida de la terminal como contexto
• Chats: @Chats para hacer referencia al contexto de una conversación anterior
• Diffs de Git: @Commit (Diff of Working State) para cambios sin confirmar o @Branch (Diff with Main) para ver el diff completo de tu rama
• Navegador: @Browser para adjuntar contexto del navegador integrado

Usa menciones con @ cuando sepas qué archivos son relevantes. Si no sabes qué archivos importan, omítelas: Agent encuentra los archivos relevantes mediante su propia búsqueda.

Modos personalizados

Escribe / en el campo de entrada del chat para invocar una skill. Al pulsar Enter, la skill se adjunta a un mensaje y desaparece a medida que avanza la conversación. Usa cualquier skill como Modo personalizado para mantener al agente centrado en ella mientras trabaja.

Elige la skill en el menú / y pulsa Option+EnterAlt+Enter (Mac) o Alt+Enter (Windows). También puedes seleccionar Usar como modo en la entrada de la skill. Dentro de un modo, la skill permanece en el contexto en cada interacción, incluso si el agente trabaja durante horas, hasta que salgas del modo.

Los modos personalizados son útiles para describir cómo trabajar, en lugar de una tarea puntual. Mantén activa una lista de comprobación para la revisión de código mientras avanzas por varios archivos, o usa una guía del equipo como /tdd durante toda una funcionalidad.

Los modos personalizados están disponibles en la ventana de agente y en la CLI. Cualquier skill con un bloque de frontmatter válido puede servir de base para un modo, y los campos opcionales de frontmatter icon y color aplican estilo a la insignia del modo. Consulta Usar una skill como modo personalizado.

Entrada de imágenes

Adjunta imágenes a tu instrucción para proporcionar contexto visual al trabajar en la UI, depurar o implementar diseños.

• Arrastra y suelta un archivo de imagen en el campo de entrada del chat
• Pega desde el portapapeles con Cmd+VCtrl+V, incluidas las capturas de pantalla

Resulta útil para implementar maquetas de diseño, depurar problemas visuales y consultar mensajes de error o trazas de pila sin tener que transcribirlos manualmente.

Entrada de voz

Haz clic en el icono del micrófono del campo de entrada del chat para dictar tu instrucción en lugar de escribirla. Habla con naturalidad, incluye detalles técnicos, como nombres de archivos y funciones, y revisa la transcripción antes de enviarla.

Uso del contexto

Cada chat comparte una ventana de contexto fija con el modelo. A medida que añades archivos, ejecutas herramientas e intercambias mensajes, esos tokens se acumulan. Cuando la ventana está a punto de llenarse, Cursor comprime las partes más antiguas de la conversación en un resumen para dejar más espacio para contenido nuevo.

El anillo de contexto junto al campo de entrada de la instrucción muestra de un vistazo cuánto espacio está ocupado en la ventana. Haz clic en el anillo para abrir el panel de desglose, que muestra el total de tokens usados por categoría:

• Instrucción del sistema: las instrucciones integradas de Cursor para el modelo
• Herramientas: definiciones de todas las herramientas disponibles para el agente
• Reglas: reglas de proyecto y de usuario incluidas en la instrucción
• Skills: descripciones de skills insertadas en el contexto del sistema
• MCP: instrucciones y catálogo de los servidores MCP conectados
• Subagentes: documentación sobre los tipos de subagentes que el agente puede iniciar
• Conversación resumida: resúmenes comprimidos de interacciones anteriores
• Conversación: tus mensajes, las respuestas del agente y los resultados de las herramientas

Pasa el cursor sobre un segmento de la barra o una fila de la lista para resaltar esa categoría.

Cambiar de modelo

Usa el menú desplegable del selector de modelo en la parte superior del campo de entrada del chat para cambiar de modelo, o pulsa Cmd /Ctrl / para alternar entre modelos. El cambio se aplicará a la conversación actual de ahí en adelante. Establece un modelo predeterminado en Cursor Settings > Models.

• Los modelos más rápidos son ideales para ediciones rápidas y tareas rutinarias
• Los modelos más capaces son mejores para razonamientos complejos y refactorizaciones en varios archivos

Puedes cambiar de modelo a mitad de una conversación; por ejemplo, cuando un modelo más rápido se encargó de la exploración, pero necesitas un razonamiento más profundo para la implementación. Consulta Modelos y precios para ver la lista completa.