View a markdown version of this page

Resolución de problemas - Amazon Quick

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

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

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 puede encontrar 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 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.

  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 de forma local 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

Toda la actividad de escritorio consume horas de agente. Si está supervisando o reduciendo el consumo de horas de los agentes, tenga en cuenta las siguientes configuraciones.

  • Indexación de archivos locales: considere deshabilitar la búsqueda semántica y la extracción de gráficos de conocimiento para las carpetas locales. En cuanto a la búsqueda semántica, la experiencia de Spaces in the web ofrece la misma capacidad mediante la carga directa de archivos o la integración de la base de conocimientos sin consumir horas de trabajo de agente de escritorio.

  • Frecuencia del feed de actividades: considere aumentar el intervalo de actualización del feed de actividades más allá del valor predeterminado. Puedes configurarlo en Ajustes > Personalización > Feed de actividades.

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

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

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. Desplázate hasta 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.

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