View a markdown version of this page

Resolución de problemas - Amazon Quick
Problemas de instalación y lanzamientoProblemas de conectividadProblemas de rendimientoProblemas de acceso a los archivosProblemas de automatización del navegadorProblemas con las tareas programadasGestionar el consumo de horas de los agentesComprender los límites de uso de las sesionesProblemas con el servidor MCPExportación de diagnósticosRestablecer la aplicaciónCómo obtener ayuda adicional

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

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

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.

  2. Seleccione Privacidad y seguridad.

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

  4. Confirma que quieres abrir la aplicación.

nota

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.

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

  3. Compruebe que dispone de suficiente espacio en disco.

  4. Si el problema persiste, elimine el ~/.quickwork/ directorio (macOS) o el %USERPROFILE%\.quickwork\ directorio (Windows) y vuelva a instalar la aplicación.

aviso

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

La conexión a Slack o Outlook falla

Si se produce un error en la conexión a Slack o Microsoft Outlook, sigue estos pasos.

  1. Desconecta el servicio en Configuración > Capacidades > Conectores.

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

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

  4. 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.

  2. Desconecte y vuelva a conectar el servicio en Configuración > Capacidades > Conectores.

  3. 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.

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

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

Sign-in o las respuestas fallan en una red corporativa o VPN

Es posible que la aplicación Amazon Quick para escritorio no pueda iniciar sesión o cargar las respuestas solo cuando esté conectado a una red corporativa, una VPN o una puerta de enlace web segura, pero funciona normalmente cuando se desconecta. Cuando eso ocurre, es probable que la red de su organización esté bloqueando o inspeccionando la conexión. Complete los siguientes pasos con el administrador de la red.

  1. Confirme que se pueda acceder a los dominios Amazon Quick necesarios desde su red. Para ver la lista de dominios que debe añadir a su lista de dominios permitidos, consulteAcceso a la red y dominios necesarios.

  2. Si su organización inspecciona el tráfico cifrado (inspección de TLS o SSL), el almacén de certificados de su sistema operativo debe confiar en la autoridad de certificación de inspección o los dominios de Amazon Quick deben excluirse de la inspección. El administrador de la red puede confirmar si la inspección está activa y configurar cualquiera de las dos opciones.

Si el problema persiste después de que el administrador de red confirme que se puede acceder a los dominios y resuelva cualquier problema de inspección, exporte los registros de las aplicaciones (consulteExportación de diagnósticos) y póngase en contacto con AWS Support.

Problemas de rendimiento

Respuestas lentas

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

  1. Cambie al modo de respuesta rápida para obtener respuestas más rápidas. Elija el selector de preferencias de respuesta en el área de entrada del chat y seleccione Rápida.

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

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

  4. 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.

  2. 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.

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

  4. 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.

nota

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

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 concedas acceso de forma explícita, con la excepción de los directorios temporales del sistema, a los que siempre se puede acceder. En Windows, sonC:\TEMP, C:\TMP\TEMP, y\TMP. En macOS y Linux/tmp, son/var/tmp, y/usr/tmp.

  2. Selecciona + Añadir carpeta para permitir el acceso a carpetas adicionales.

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

La búsqueda no arroja resultados

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.

  2. 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.

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

  4. 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.

  5. 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

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 > Herramientas.

  2. 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.

  3. 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 con las tareas programadas

No se ejecutó una tarea programada

Las tareas programadas se ejecutan localmente en el 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.

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

  3. El agente está activado. Marca el botón en Mission Control, al que se accede desde la barra superior.

  4. 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.

importante

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 una tarea programada produce resultados inesperados, pruebe los siguientes pasos.

  1. Abre Mission Control desde la barra superior y selecciona el agente.

  2. Revisa la pestaña Avisos para comprobar que las instrucciones del agente son correctas.

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

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

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

Gestionar el consumo de horas de los agentes

Si está supervisando o reduciendo el consumo de horas de los agentes, tenga en cuenta las siguientes configuraciones.

  • Tareas programadas: considere reducir el número de tareas que se ejecutan en segundo plano. La ejecución de cada tarea programada consume horas de agente.

  • Modo de respuesta y nivel de pensamiento: utilice el modo de respuesta rápida con el nivel de pensamiento desactivado para tareas más sencillas. Los modos equilibrado e inteligente con niveles de pensamiento más altos (bajo, medio, alto) consumen más horas de agente por interacción. Adapta el modo de respuesta y el nivel de pensamiento a la complejidad de la tarea.

Comprender los límites de uso de las sesiones

Para ver el uso de la sesión actual, selecciona tu perfil en la parte inferior izquierda de la aplicación de escritorio. El límite de uso de la sesión es un límite de protección del servicio que distribuye tu asignación mensual de horas de agente a lo largo del tiempo, en lugar de permitir que se consuma toda la asignación de una sola vez.

Al alcanzar el límite de sesiones, la aplicación de escritorio muestra un mensaje que indica que se ha utilizado la asignación de sesiones. El límite se restablece en una ventana continua y se recupera gradualmente con el tiempo.

Si encuentra este límite con frecuencia, consulteGestionar el consumo de horas de los agentes.

Problemas con el servidor MCP

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.

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

  3. 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).

  4. 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.

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

  3. 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.

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

Exportación de diagnósticos

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.

  2. Ve a la sección Solución de problemas.

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

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

Si no puede abrir la aplicación para exportar los diagnósticos, puede encontrar los archivos de registro directamente en el equipo en las siguientes ubicaciones.

  • macOS: ~/Library/Application Support/QuickWork/ para el registro actual y ~/Library/Logs/QuickWork/ para los registros fechados.

  • Windows: %APPDATA%\QuickWork\ para el registro actual y %APPDATA%\QuickWork\logs\ para los registros fechados.

Restablecer la aplicación

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.

  2. Ve a la sección Zona de peligro.

  3. Selecciona Borrar todos los datos.

  4. Confirme la acción.

  5. 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

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.

  • Póngase en contacto con el administrador de TI de su organización si tiene problemas con las cuentas empresariales.

  • Consulta la documentación de Amazon Quick para obtener la guía más reciente.