Resolución de problemas de Agent
Soluciones a problemas comunes de Agent relacionados con el acceso a archivos, las reglas, los comandos de terminal y más.
¿Cómo puedo mejorar la precisión de Agent?
- Sé específico en tus instrucciones: incluye el comportamiento esperado y las restricciones
- Usa primero el modo Plan para tareas que afecten a muchos archivos
- Inicia un chat nuevo al terminar una funcionalidad o cambiar de tarea
- Añade reglas en
.cursor/rules/para los patrones que quieras que Agent siga siempre - Escribe
@seguido del nombre de un archivo o carpeta para proporcionar a Agent contexto específico
¿Qué ocurre si Agent no detecta mis archivos?
- Revisa el archivo
.cursorignoreen la raíz del proyecto. Los archivos incluidos allí quedan bloqueados para Agent, la búsqueda en la base de código y las menciones con@. - Revisa
.gitignore. Los patrones incluidos también pueden impedir que Agent detecte archivos. - Vuelve a indexar el proyecto: abre la paleta de comandos y busca "Reindex".
- Adjunta archivos directamente escribiendo
@seguido del nombre del archivo en el campo de entrada del chat.
¿Cómo deshago los cambios realizados por el Agent?
Pasa el cursor sobre un mensaje anterior y haz clic en Restaurar punto de control en la esquina inferior derecha para revertir todos los cambios realizados por el Agent después de ese momento.
Los puntos de control se guardan localmente y son independientes de git. Usa git para el control de versiones permanente.
¿Qué ocurre si Agent establece CI=1 en los comandos de terminal?
Cherri Code establece CI=1 como variable de entorno al ejecutar comandos de terminal a través de Agent. Esto ayuda a las herramientas de terminal a generar una salida más limpia. Si tu proyecto se comporta de forma diferente cuando CI=1 está establecida (por ejemplo, omite instrucciones interactivas o usa rutas específicas de CI), puedes desactivarla en tus comandos:
unset CI && your-command-hereO añade esto a una regla para que el Agent siempre lo desactive:
Al ejecutar comandos de terminal, añade el prefijo `unset CI &&` si el comportamiento del comando cambia en entornos de CI.¿Cómo soluciono problemas de configuración de Máquinas autohospedadas?
Ejecuta agent worker debug para obtener un informe previo. Consulta Máquinas autohospedadas para ver soluciones habituales y saber cuándo contactar con soporte.
¿Cómo compruebo si el pool de mi equipo ha alcanzado su capacidad máxima o por qué no se inició una ejecución de agente?
Consulta el panel de control de Cloud Agents o llama a GET /v0/private-workers/summary. Consulta Máquinas autohospedadas para conocer los modos de error y obtener orientación sobre el escalado.
¿Qué hacer si un archivo adjunto de un Cloud Agent en la web es demasiado grande?
Si cursor.com/agents muestra <filename> is too large (4MB limit), consulta Límites de archivos adjuntos de Cloud Agent en la web para ver los tipos de archivo admitidos y cómo reducir o dividir el archivo.
¿Qué ocurre si aparece "Se agotó el tiempo de espera durante la ejecución de Agent"?
Este error significa que el host de extensiones de Cherri Code no terminó de iniciarse en 60 segundos, por lo que las funciones de Agent no pudieron inicializarse. La misma causa raíz aparece como "Timeout waiting for EverythingProvider" en los diagnósticos de red.
Las causas pueden variar, así que recopila los registros antes de cambiar nada:
- Pulsa Cmd/Ctrl+Shift+P y ejecuta Developer: Export Logs...
- Selecciona Main, Window y Extension Host
- Comprueba también Output → Extension Host (Cmd/Ctrl+Shift+P → "Output" y luego elige "Extension Host" en el menú desplegable). Si está vacío, haz una captura de pantalla; un panel vacío es una señal de diagnóstico importante.
- Comparte el archivo ZIP exportado y la captura de pantalla con el equipo de soporte, junto con tu sistema operativo y la versión de Cherri Code.
En equipos gestionados o Enterprise, el software de seguridad de endpoints (antivirus, EDR) puede ser una de las causas. Si el equipo de TI confirma que hay un agente de seguridad activo, comparte la página Configuración de seguridad del endpoint para que puedan añadir las exclusiones de procesos y rutas adecuadas.
¿Cómo reporto una respuesta incorrecta del Agent?
- Haz clic en el menú ... al final de la respuesta y selecciona Copy Request ID.
- Publica en forum.cursor.com el ID de solicitud, los pasos para reproducir el problema y la información de tu sistema (disponible en Cherri Code > About Cherri Code en macOS o Help > About en Windows/Linux).