

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Resolución de problemas
<a name="desktop-troubleshooting"></a>

En las siguientes secciones se describen los problemas más comunes que pueden surgir al utilizar la aplicación de escritorio Amazon Quick y cómo resolverlos.

## Problemas de instalación y lanzamiento
<a name="desktop-ts-install"></a>

macOS muestra una advertencia de «desarrollador no identificado»  
Si macOS te impide abrir la aplicación Amazon Quick Desktop porque proviene de un desarrollador no identificado, usa el siguiente procedimiento para permitirlo.  

1. Abre la **configuración del sistema** en tu Mac.

1. Seleccione **Privacidad y seguridad**.

1. Ve a la sección Seguridad y selecciona **Abrir de todos modos** junto al mensaje sobre Quick.

1. Confirma que quieres abrir la aplicación.
La primera vez que la inicie, es posible que el sistema operativo le pida que confirme que desea abrir la aplicación. Seleccione **Abrir** para continuar.

La aplicación no se inicia  
Si la aplicación Amazon Quick Desktop no se inicia, prueba los siguientes pasos.  

1. Reinicie el ordenador e intente abrir la aplicación de nuevo.

1. Compruebe que el sistema operativo cumple los requisitos mínimos.

1. Compruebe que dispone de suficiente espacio en disco.

1. Si el problema persiste, elimine el `~/.quickwork/` directorio (macOS) o el `%USERPROFILE%\.quickwork\` directorio (Windows) y vuelva a instalar la aplicación.
Al eliminar el directorio `~/.quickwork/` (macOS) o `%USERPROFILE%\.quickwork\` (Windows), se eliminan todos los datos locales, incluidas las conversaciones, el gráfico de conocimiento, la memoria y las credenciales guardadas. Utilice este paso solo como último recurso.

## Problemas de conectividad
<a name="desktop-ts-connections"></a>

Se produce un error en la conexión con Slack o Outlook  
Si se produce un error en la conexión a Slack o Microsoft Outlook, prueba los siguientes pasos.  

1. Desconecta el servicio en **Configuración** > **Capacidades** > **Conexiones**.

1. Vuelva a conectar el servicio seleccionando **Iniciar sesión** y completando el flujo de autenticación.

1. Comprueba que tu cuenta tiene los permisos necesarios en el servicio de terceros.

1. Comprueba que tu conexión a Internet esté activa y estable.

La conexión de Microsoft Teams falla  
Si se produce un error en la conexión a Microsoft Teams, sigue los mismos pasos que para Slack o Outlook. Comprueba que el administrador de tu organización no haya restringido el acceso a aplicaciones de terceros.

La conexión muestra el estado «No sincronizada»  
Si una conexión muestra el estado «No sincronizada», prueba los siguientes pasos.  

1. Comprueba que tienes una conexión a Internet activa.

1. Desconecte y vuelva a conectar el servicio en **Configuración** > **Capacidades** > **Conexiones**.

1. Si el problema persiste, es posible que el servicio de terceros esté sufriendo una interrupción. Consulta la página de estado del servicio.

Las conexiones de Google Workspace fallan  
Si las conexiones a los servicios de Google (Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Slides, Google Meet o Google Analytics) fallan, comprueba lo siguiente.  

1. Tu cuenta de Google no está restringida por las políticas de administración de tu organización.

1. Has concedido los permisos de OAuth necesarios durante el flujo de inicio de sesión.

1. Estás iniciando sesión con la cuenta de Google correcta.

## Problemas de rendimiento
<a name="desktop-ts-performance"></a>

Respuestas lentas  
Si las respuestas rápidas son lentas, prueba los siguientes pasos.  

1. Cambie al modo de modelo de IA **rápida** para obtener respuestas más rápidas. Elija el selector de modelos en el área de entrada del chat y seleccione **Rápido**.

1. Reduzca el nivel de **esfuerzo de pensamiento**. Un menor esfuerzo para pensar (inactivo o bajo) produce respuestas más rápidas.

1. Cierre las aplicaciones que no utilice para liberar recursos del sistema.

1. Comprueba la velocidad de tu conexión a Internet. Las solicitudes de modelos de IA requieren una conexión de red a API Gateway.

Uso alto de memoria  
Si la aplicación Amazon Quick Desktop utiliza memoria excesiva, prueba los siguientes pasos.  

1. Reduzca el número de carpetas indexadas en **Configuración** > **Mi PC**. Desactiva la **búsqueda semántica** en las carpetas que no la requieran, ya que la búsqueda semántica utiliza más recursos que la búsqueda por palabra clave.

1. Baje el control deslizante **Máximo de tareas paralelas** en **Configuración** > **Personalización** > **Rendimiento.** El valor predeterminado es 50. Si se reduce este valor, se limita el número de operaciones simultáneas en segundo plano.

1. Reinicie la aplicación para borrar los datos en caché.

1. Ajusta los límites de indexación de búsquedas en **Configuración** > **Mi ordenador** > Indexación de **búsquedas**. Reduzca el **límite de almacenamiento**, el tamaño **máximo de archivo para la indexación o el tamaño** **máximo de la carpeta para** los controles deslizantes de indexación.
La indexación de búsquedas se detiene automáticamente cuando el espacio libre en disco es inferior a 8,0 GiB.

## Problemas de acceso a los archivos
<a name="desktop-ts-file-access"></a>

Quick no encuentra un archivo  
Si Quick no encuentra un archivo al que haces referencia en el chat, comprueba lo siguiente.  

1. La carpeta principal del archivo se añade en **Configuración** > **Mi ordenador** > **Carpetas locales**. Quick solo puede acceder a los archivos de las carpetas a las que tú concedas acceso de forma explícita.

1. Seleccione **\+ Añadir carpeta** para permitir el acceso a carpetas adicionales.

1. Tras añadir una carpeta, Quick puede leer inmediatamente los archivos que contiene. La indexación para la búsqueda se produce en segundo plano.

La búsqueda no devuelve ningún resultado  
Si la búsqueda de archivos no arroja resultados, prueba los siguientes pasos.  

1. Compruebe que la **búsqueda por palabra clave** esté activada para la carpeta en **Configuración** > **Mi PC** > Carpetas **locales**. Expande la carpeta para ver sus opciones de indexación.

1. Compruebe el estado de la indexación. El estado **Listo** con el recuento de archivos y entradas confirma que la indexación se ha completado.

1. Si ha agregado una carpeta nueva recientemente, espere a que se complete la indexación. El estado muestra el progreso.

1. Compruebe que el archivo no supere el **tamaño máximo de archivo para el límite de indexación** en **Configuración** > **Mi ordenador** > **Indexación de búsquedas**. Los archivos que superen este límite se omiten durante la indexación, pero el agente podrá seguir accediendo directamente a ellos.

1. Para una búsqueda más amplia, habilite la **búsqueda semántica** en la carpeta para permitir consultas en lenguaje natural.

## Problemas de automatización del navegador
<a name="desktop-ts-browser"></a>

La automatización del navegador no funciona  
Si Quick no puede navegar por las páginas web, prueba los siguientes pasos.  

1. Compruebe que la **automatización del navegador** esté habilitada en **Configuración** > **Capacidades** > **Sistema**.

1. Si utilizas el modo «Usar mi Chrome», verifica la configuración en **Configuración** > **Personalización** > **Navegador**. Abra Chrome y vaya a `chrome://inspect/#remote-debugging`. Selecciona **Activar la depuración remota**. Vuelva a Quick y elija **Probar conexión** para verificar la conexión.

1. Si utilizas el modo predeterminado, Quick lanza una instancia de Chrome independiente con una copia de tu perfil. Asegúrate de que Chrome esté instalado en tu sistema.

## Problemas programados con los agentes
<a name="desktop-ts-agents"></a>

No se postuló un agente programado  
Los agentes programados se ejecutan localmente en su ordenador. Si un agente no se ejecutó a la hora programada, compruebe lo siguiente.  

1. El ordenador estaba encendido y activo a la hora programada.

1. Se estaba ejecutando la aplicación Amazon Quick Desktop.

1. El agente está activado. Seleccione la opción **Configuración** > **Capacidades** > **Tareas programadas** o abra el panel de **agentes** desde la barra superior.

1. Tu conexión a Internet estaba activa. Los agentes que acceden a los servicios conectados o a los modelos de IA requieren una conexión de red.
Si el equipo está apagado o la aplicación está cerrada cuando está programada la ejecución de un agente, el agente no se ejecutará hasta la próxima hora programada.

El agente produce resultados inesperados  
Si un agente programado produce resultados inesperados, pruebe los siguientes pasos.  

1. Abra **Configuración** > **Capacidades** > **Tareas programadas** y seleccione el agente.

1. Revise la **pestaña** Solicitud para comprobar que las instrucciones del agente son correctas.

1. Compruebe la pestaña **Capacidades** para comprobar que están conectados los servidores MCP correctos.

1. Considere cambiar el **modelo** en la pestaña **Descripción general**. Utilice **Balanced** o **Smart** para tareas de agente más complejas.

1. Pulse el botón **Ejecutar** (icono de reproducción) para activar el agente manualmente y observar los resultados.

## Problemas con el servidor MCP
<a name="desktop-ts-mcp"></a>

El servidor MCP no se puede conectar  
Si un servidor MCP no se puede conectar, intente los siguientes pasos según el tipo de conexión.  
**Servidor MCP local:**  

1. Compruebe que el comando es correcto y que el ejecutable está instalado en el sistema.

1. Compruebe que los argumentos estén separados por espacios y que tengan el formato correcto.

1. Aumente el valor de **tiempo** de espera si el servidor tarda más de 30 segundos en iniciarse (se puede configurar de 5 a 300 segundos).

1. Compruebe que todas **las variables de entorno** necesarias estén configuradas correctamente.
**Servidor MCP remoto:**  

1. Compruebe que la URL es correcta y que el servidor está funcionando.

1. Si es necesaria la autenticación, compruebe que el valor del **token** sea un token portador válido.

1. Compruebe la conexión de red y cualquier configuración del firewall.
**Servidor MCP importado:**  

1. Compruebe que la ruta del archivo de configuración es correcta.

1. Asegúrese de que la aplicación de origen (Kiro, Claude Code, AIM, etc.) esté instalada correctamente.

## Exportación de diagnósticos
<a name="desktop-ts-diagnostics"></a>

Si necesita compartir información de diagnóstico para solucionar problemas, puede exportar los registros de diagnóstico desde la aplicación.

1. Abre **Configuración** > **Personalización**.

1. Ve a la sección **de solución de problemas**.

1. Selecciona un intervalo de tiempo en el menú desplegable (por ejemplo, **Últimas 2 horas**).

1. Seleccione **Exportar diagnósticos** para guardar los registros de diagnóstico en su escritorio.

## Restablecer la aplicación
<a name="desktop-ts-reset"></a>

Si otros pasos de solución de problemas no resuelven el problema, puedes restablecer la aplicación borrando todos los datos.

**aviso**  
Esta acción es irreversible. Elimina todos los datos rápidos, incluidas las conversaciones, los mensajes en caché, el gráfico de conocimientos, las credenciales guardadas y las preferencias del usuario. La aplicación se cierra tras la limpieza.

1. **Abre **Configuración > Personalización**.**

1. Ve a la sección **Zona de peligro**.

1. Selecciona **Borrar todos los datos**.

1. Confirme la acción.

1. Para desinstalarlo por completo en macOS, arrastra `Amazon Quick.app` a la papelera. En Windows, abre **Configuración** > **Aplicaciones** > **Aplicaciones instaladas**, busca Amazon Quick y selecciona **Desinstalar**.

## Cómo obtener ayuda adicional
<a name="desktop-ts-help"></a>

Si los pasos de solución de problemas anteriores no resuelven el problema, puedes usar los siguientes recursos.
+ **Exporte los diagnósticos** y compártalos con su equipo de soporte.
+ **Menú para desarrolladores**: selecciona el punto de estado de la conexión (punto verde en la esquina superior derecha) para acceder a Mission Control, la superposición de métricas, el panel de depuración y el panel de memoria para realizar diagnósticos avanzados.
+ Ponte en contacto con el administrador de TI de tu organización si tienes problemas con las cuentas empresariales.
+ Consulta la documentación de Amazon Quick para obtener la guía más reciente.