View a markdown version of this page

Solução de problemas - Amazon Quick
Problemas de instalação e lançamentoProblemas de conexãoProblemas de performanceProblemas de acesso a arquivosProblemas de automação do navegadorProblemas com tarefas agendadasGerenciando o consumo de horas do agenteEntendendo os limites de uso da sessãoProblemas com o servidor MCPExportação de diagnósticosRedefinindo o aplicativoObter ajuda adicional

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas

As seções a seguir descrevem problemas comuns que você pode encontrar ao usar o aplicativo de desktop Amazon Quick e como resolvê-los.

Problemas de instalação e lançamento

O macOS exibe um aviso de “desenvolvedor não identificado”

Se o macOS impedir que você abra o aplicativo de desktop Amazon Quick porque ele é de um desenvolvedor não identificado, use o procedimento a seguir para permitir isso.

  1. Abra as configurações do sistema no seu Mac.

  2. Escolha Privacidade e segurança.

  3. Role até a seção Segurança e escolha Abrir mesmo assim ao lado da mensagem sobre Rápido.

  4. Confirme que você deseja abrir o aplicativo.

nota

Na primeira inicialização, seu sistema operacional pode solicitar que você confirme que deseja abrir o aplicativo. Escolha Abrir para continuar.

O aplicativo não inicia

Se o aplicativo de desktop Amazon Quick não for iniciado, tente as etapas a seguir.

  1. Reinicie o computador e tente abrir o aplicativo novamente.

  2. Verifique se o sistema operacional atende aos requisitos mínimos.

  3. Verifique se você tem espaço em disco suficiente disponível.

  4. Se o problema persistir, exclua o ~/.quickwork/ diretório (macOS) %USERPROFILE%\.quickwork\ ou o diretório (Windows) e reinstale o aplicativo.

Atenção

A exclusão do diretório ~/.quickwork/ (macOS) %USERPROFILE%\.quickwork\ ou (Windows) remove todos os dados locais, incluindo conversas, gráfico de conhecimento, memória e credenciais salvas. Use essa etapa somente como último recurso.

Problemas de conexão

Falha na conexão com o Slack ou o Outlook

Se uma conexão com o Slack ou o Microsoft Outlook falhar, tente as etapas a seguir.

  1. Desconecte o serviço em Configurações > Capacidades > Conectores.

  2. Reconecte o serviço escolhendo Entrar e concluindo o fluxo de autenticação.

  3. Verifique se sua conta tem as permissões necessárias no serviço de terceiros.

  4. Verifique se sua conexão com a Internet está ativa e estável.

Falha na conexão do Microsoft Teams

Se a conexão com o Microsoft Teams falhar, siga as mesmas etapas do Slack ou do Outlook. Verifique se o administrador da sua organização não restringiu o acesso a aplicativos de terceiros.

A conexão mostra o status “Não sincronizado”

Se uma conexão mostrar o status “Não sincronizada”, tente as etapas a seguir.

  1. Verifique se você tem uma conexão ativa com a Internet.

  2. Desconecte e reconecte o serviço em Configurações > Capacidades > Conectores.

  3. Se o problema persistir, o serviço terceirizado pode estar passando por uma interrupção. Verifique a página de status do serviço.

As conexões do Google Workspace falham

Se as conexões com os serviços do Google (Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Slides, Google Meet ou Google Analytics) falharem, verifique o seguinte.

  1. Sua conta do Google não é restringida pelas políticas administrativas da sua organização.

  2. Você concedeu as permissões OAuth necessárias durante o fluxo de login.

  3. Você está fazendo login com a conta correta do Google.

Sign-in ou as respostas falham em uma rede corporativa ou VPN

O aplicativo de desktop Amazon Quick pode falhar ao fazer login ou carregar respostas somente quando você está conectado a uma rede corporativa, VPN ou gateway seguro da web, mas funciona normalmente quando você se desconecta. Quando isso acontece, a rede da sua organização provavelmente está bloqueando ou inspecionando a conexão. Conclua as etapas a seguir com o administrador da rede.

  1. Confirme se os domínios do Amazon Quick necessários podem ser acessados pela sua rede. Para ver a lista de domínios a serem adicionados à sua lista de permissões, consulteAcesso à rede e domínios necessários.

  2. Se sua organização inspeciona o tráfego criptografado (inspeção TLS ou SSL), o armazenamento de certificados do seu sistema operacional deve confiar na autoridade de certificação de inspeção, ou os domínios do Amazon Quick devem ser excluídos da inspeção. Seu administrador de rede pode confirmar se a inspeção está ativa e configurar qualquer uma das opções.

Se o problema persistir após o administrador da rede confirmar que os domínios estão acessíveis e resolver quaisquer problemas de inspeção, exporte os registros do aplicativo (consulte) e entre em contato com o Support. Exportação de diagnósticos AWS

Problemas de performance

Respostas lentas

Se as respostas rápidas forem lentas, tente as etapas a seguir.

  1. Alterne para o modo de resposta rápida para obter respostas mais rápidas. Escolha o seletor de preferências de resposta na área de entrada do bate-papo e selecione Rápido.

  2. Reduza o nível de esforço de raciocínio. Menor esforço de raciocínio (desligado ou baixo) produz respostas mais rápidas.

  3. Feche os aplicativos não utilizados para liberar recursos do sistema.

  4. Verifique a velocidade da sua conexão com a internet. As solicitações do modelo de IA exigem uma conexão de rede com o API Gateway.

Alto uso de memória

Se o aplicativo de desktop Amazon Quick usar memória excessiva, tente as etapas a seguir.

  1. Reduza o número de pastas indexadas em Configurações > Meu computador. Desative a pesquisa semântica para pastas que não a exijam, pois a pesquisa semântica usa mais recursos do que a pesquisa por palavra-chave.

  2. Abaixe o controle deslizante Max parallel tasks em Configurações > Personalização > Desempenho. O valor padrão é 50. Reduzir esse valor limita o número de operações simultâneas em segundo plano.

  3. Reinicie o aplicativo para limpar os dados em cache.

  4. Ajuste os limites de indexação de pesquisa em Configurações > Meu computador > Indexação de pesquisa. Reduza o limite de armazenamento, o tamanho máximo do arquivo para indexação ou o tamanho máximo da pasta para os controles deslizantes de indexação.

nota

A indexação de pesquisa é pausada automaticamente quando o espaço livre em disco fica abaixo de 8,0 GiB.

Problemas de acesso a arquivos

Quick, não consigo encontrar um arquivo

Se o Quick não conseguir encontrar um arquivo que você referencie no chat, verifique o seguinte.

  1. A pasta principal do arquivo é adicionada em Configurações > Meu computador > Pastas locais. O Quick só pode acessar arquivos em pastas às quais você concede acesso explícito, com exceção dos diretórios temporários do sistema, que estão sempre acessíveis. No Windows, são C:\TEMPC:\TMP,\TEMP, \TMP e. No macOS e no Linux, esses são /tmp/var/tmp, e. /usr/tmp

  2. Escolha + Adicionar pasta para conceder acesso a pastas adicionais.

  3. Depois de adicionar uma pasta, o Quick pode ler imediatamente os arquivos nela. A indexação para pesquisa acontece em segundo plano.

A pesquisa não retorna resultados

Se a pesquisa de arquivos não retornar resultados, tente as etapas a seguir.

  1. Verifique se a pesquisa por palavra-chave está ativada para a pasta em Configurações > Meu computador > Pastas locais. Expanda a pasta para ver suas opções de indexação.

  2. Verifique o status da indexação. Um status Pronto com contagens de arquivos e entradas confirma que a indexação foi concluída.

  3. Se você adicionou recentemente uma nova pasta, aguarde a conclusão da indexação. O status mostra o progresso.

  4. Verifique se o arquivo não é maior que o tamanho máximo do arquivo para o limite de indexação em Configurações > Meu computador > Indexação de pesquisa. Arquivos maiores que esse limite são ignorados durante a indexação, mas ainda estão disponíveis para o agente por meio do acesso direto aos arquivos.

  5. Para uma pesquisa mais ampla, ative a pesquisa semântica na pasta para permitir consultas em linguagem natural.

Problemas de automação do navegador

A automação do navegador não funciona

Se o Quick não conseguir navegar em páginas da Web, tente as etapas a seguir.

  1. Verifique se a automação do navegador está ativada em Configurações > Capacidades > Ferramentas.

  2. Se estiver usando o modo “Usar meu Chrome”, verifique a configuração em Configurações > Personalização > Navegador. Abra o Chrome e navegue até chrome://inspect/#remote-debugging. Escolha Ativar depuração remota. Volte para Rápido e escolha Testar conexão para verificar a conexão.

  3. Se estiver usando o modo padrão, o Quick inicia uma instância separada do Chrome com uma cópia do seu perfil. Verifique se o Chrome está instalado em seu sistema.

Problemas com tarefas agendadas

Uma tarefa agendada não foi executada

As tarefas agendadas são executadas localmente no seu computador. Se um agente não foi executado no horário programado, verifique o seguinte.

  1. Seu computador foi ligado e acordado no horário agendado.

  2. O aplicativo de desktop Amazon Quick estava em execução.

  3. O agente está ativado. Marque a opção no Mission Control, acessível na barra superior.

  4. Sua conexão com a internet estava ativa. Os agentes que acessam serviços conectados ou modelos de IA exigem uma conexão de rede.

Importante

Se o computador estiver desligado ou o aplicativo estiver fechado quando um agente estiver programado para ser executado, o agente não será executado até o próximo horário agendado.

O agente produz resultados inesperados

Se uma tarefa agendada produzir resultados inesperados, tente as etapas a seguir.

  1. Abra o Mission Control na barra superior e selecione o agente.

  2. Consulte a guia Prompt para verificar se as instruções do agente estão corretas.

  3. Verifique a guia Capacidades para verificar se os servidores MCP corretos estão conectados.

  4. Considere alterar o modelo na guia Visão geral. Use Balanced ou Smart para tarefas de agente mais complexas.

  5. Escolha o botão Executar (ícone de reprodução) para acionar manualmente o agente e observar os resultados.

Gerenciando o consumo de horas do agente

Se você estiver monitorando ou reduzindo o consumo de horas do agente, considere as seguintes configurações.

  • Tarefas agendadas — considere reduzir o número de tarefas executadas em segundo plano. Cada execução de tarefa agendada consome horas do agente.

  • Modo de resposta e nível de pensamento — Use o modo de resposta rápida com o nível de pensamento definido como Desligado para tarefas mais simples. Os modos equilibrado e inteligente com níveis de pensamento mais altos (baixo, médio, alto) consomem mais horas de agente por interação. Combine o modo de resposta e o nível de pensamento com a complexidade da tarefa.

Entendendo os limites de uso da sessão

Você pode ver o uso atual da sessão selecionando seu perfil na área inferior esquerda do aplicativo para desktop. O limite de uso da sessão é um limite de proteção do serviço que distribui sua alocação mensal de horas de agente ao longo do tempo, em vez de permitir que a alocação total seja consumida de uma só vez.

Quando você atinge o limite da sessão, o aplicativo de desktop exibe uma mensagem indicando que sua alocação de sessão foi usada. O limite é redefinido em uma janela rolante, recuperando-se gradualmente ao longo do tempo.

Se você encontrar esse limite com frequência, consulteGerenciando o consumo de horas do agente.

Problemas com o servidor MCP

O servidor MCP não consegue se conectar

Se um servidor MCP não conseguir se conectar, tente as etapas a seguir com base no tipo de conexão.

Servidor MCP local:

  1. Verifique se o comando está correto e se o executável está instalado em seu sistema.

  2. Verifique se os argumentos estão separados por espaços e formatados corretamente.

  3. Aumente o valor do tempo limite se o servidor levar mais de 30 segundos para iniciar (configurável de 5 a 300 segundos).

  4. Verifique se todas as variáveis de ambiente necessárias estão definidas corretamente.

Servidor MCP remoto:

  1. Verifique se o URL está correto e se o servidor está em execução.

  2. Se a autenticação for necessária, verifique se o valor do token é um token de portador válido.

  3. Verifique sua conexão de rede e todas as configurações de firewall.

Servidor MCP importado:

  1. Verifique se o caminho do arquivo de configuração está correto.

  2. Verifique se o aplicativo de origem (Kiro, Claude Code, AIM etc.) está instalado corretamente.

Exportação de diagnósticos

Se precisar compartilhar informações de diagnóstico para solucionar problemas, você pode exportar registros de diagnóstico do aplicativo.

  1. Abra Configurações > Personalização.

  2. Role até a seção Solução de problemas.

  3. Selecione um intervalo de tempo na lista suspensa (por exemplo, Últimas 2 horas).

  4. Escolha Exportar diagnóstico para salvar os registros de diagnóstico em sua área de trabalho.

Se você não conseguir abrir o aplicativo para exportar diagnósticos, poderá encontrar os arquivos de log diretamente em sua máquina nos seguintes locais.

  • macOS — ~/Library/Application Support/QuickWork/ para o registro atual e ~/Library/Logs/QuickWork/ para registros datados.

  • Windows — %APPDATA%\QuickWork\ para o registro atual e %APPDATA%\QuickWork\logs\ para registros datados.

Redefinindo o aplicativo

Se outras etapas de solução de problemas não resolverem seu problema, você poderá redefinir o aplicativo limpando todos os dados.

Atenção

Essa ação é irreversível. Ele remove todos os dados do Quick, incluindo conversas, mensagens em cache, gráfico de conhecimento, credenciais salvas e preferências do usuário. O aplicativo é encerrado após a limpeza.

  1. Abra Configurações > Personalização.

  2. Role até a seção Zona de perigo.

  3. Escolha Limpar todos os dados.

  4. Confirme a ação.

  5. Para desinstalar completamente no macOS, arraste Amazon Quick.app até a Lixeira. No Windows, abra Configurações > Aplicativos > Aplicativos instalados, encontre o Amazon Quick e escolha Desinstalar.

Obter ajuda adicional

Se as etapas de solução de problemas anteriores não resolverem seu problema, você poderá usar os seguintes recursos.

  • Exporte diagnósticos e compartilhe-os com sua equipe de suporte.

  • Entre em contato com o administrador de TI da sua organização para problemas com contas corporativas.

  • Visite a documentação do Amazon Quick para obter as orientações mais recentes.