

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
<a name="desktop-troubleshooting"></a>

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
<a name="desktop-ts-install"></a>

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.

1. Escolha **Privacidade e segurança**.

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

1. Confirme que você deseja abrir o aplicativo.
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.

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

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

1. Se o problema persistir, exclua o `~/.quickwork/` diretório (macOS) `%USERPROFILE%\.quickwork\` ou o diretório (Windows) e reinstale o aplicativo.
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
<a name="desktop-ts-connections"></a>

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** > **Conexões**.

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

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

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

1. **Desconecte e reconecte o serviço em **Configurações** > **Capacidades** > Conexões.**

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

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

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

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

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

1. Mude para o modo de modelo **Fast** AI para respostas mais rápidas. Escolha o seletor de modelo na área de entrada do bate-papo e selecione **Rápido**.

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

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

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

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

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

1. 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.**
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
<a name="desktop-ts-file-access"></a>

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.

1. Escolha **\+ Adicionar pasta** para conceder acesso a pastas adicionais.

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

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

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

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

1. 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 name="desktop-ts-browser"></a>

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

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

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

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

Um agente agendado não fugiu  
Os agentes agendados são executados localmente em 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.

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

1. O agente está ativado. Marque a opção em **Configurações** > **Capacidades** > **Tarefas agendadas** ou abra o painel **Agentes** na barra superior.

1. 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.
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 um agente agendado produzir resultados inesperados, tente as etapas a seguir.  

1. Abra **Configurações** > **Capacidades** > **Tarefas agendadas** e selecione o agente.

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

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

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

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

## Problemas com o servidor MCP
<a name="desktop-ts-mcp"></a>

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.

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

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

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

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

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

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

## Exportando diagnósticos
<a name="desktop-ts-diagnostics"></a>

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

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

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

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

## Redefinindo o aplicativo
<a name="desktop-ts-reset"></a>

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

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

1. Escolha **Limpar todos os dados**.

1. Confirme a ação.

1. 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
<a name="desktop-ts-help"></a>

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.
+ **Menu do desenvolvedor** — Escolha o ponto de status da conexão (ponto verde no canto superior direito) para acessar o Mission Control, a sobreposição de métricas, o painel de depuração e o painel Memória para diagnósticos avançados.
+ 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.