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 e perguntas e respostas
<a name="emr-spark-upgrade-agent-troubleshooting"></a>

## Solução de problemas
<a name="spark-upgrade-agent-troubleshooting-common"></a>

A mensagem de erro do processo de atualização está disponível de maneiras diferentes para diferentes clientes MCP. Nesta página, listamos algumas orientações gerais para problemas comuns que você pode ver usando o Apache Spark Upgrade Agent para Amazon EMR.

**Topics**
+ [Erro: Falha ao carregar o servidor MCP gerenciado do SMUS](#spark-upgrade-agent-mcp-server-failed)
+ [Observação: carregamento lento da ferramenta](#spark-upgrade-agent-slow-tool-loading)
+ [Erro: falha na invocação da ferramenta com erro de limitação](#spark-upgrade-agent-throttling-error)
+ [Erro: a ferramenta responde com erro do usuário](#spark-upgrade-agent-user-error)
+ [Erro: a ferramenta responde com erro interno](#spark-upgrade-agent-internal-error)

### Erro: Falha ao carregar o servidor MCP gerenciado do SMUS
<a name="spark-upgrade-agent-mcp-server-failed"></a>
+  Verifique se a configuração do MCP está configurada corretamente. 
+ **Valide a sintaxe JSON:**
  + Certifique-se de que seu JSON seja válido sem erros de sintaxe
  + Verifique se há vírgulas, aspas ou colchetes ausentes
+ Verifique suas AWS credenciais locais e verifique se a política da função MCP IAM está configurada corretamente.
+ Execute /mcp para verificar a disponibilidade do servidor MCP para o caso `Kiro-CLI`

### Observação: carregamento lento da ferramenta
<a name="spark-upgrade-agent-slow-tool-loading"></a>
+ As ferramentas podem levar alguns segundos para serem carregadas na primeira tentativa de iniciar o servidor.
+ Se as ferramentas não aparecerem, tente reiniciar o bate-papo,
+ Execute `/tools` o comando para verificar a disponibilidade da ferramenta.
+ Execute `/mcp` se o servidor for iniciado sem erros.

### Erro: falha na invocação da ferramenta com erro de limitação
<a name="spark-upgrade-agent-throttling-error"></a>

Se você atingir seu limite de serviço, aguarde alguns segundos para emitir uma invocação de ferramenta caso veja a exceção de limitação.

### Erro: a ferramenta responde com erro do usuário
<a name="spark-upgrade-agent-user-error"></a>
+ AccessDeniedException - verifique a mensagem de erro e corrija o problema de permissão.
+ InvalidInputException - verifique a mensagem de erro e corrija os parâmetros de entrada da ferramenta.
+ ResourceNotFoundException - verifique a mensagem de erro e corrija o parâmetro de entrada para referência do recurso.

### Erro: a ferramenta responde com erro interno
<a name="spark-upgrade-agent-internal-error"></a>
+ Se você ver`The service is handling high-volume requests`, tente novamente invocar a ferramenta em alguns segundos.
+ Se você ver`INTERNAL SERVICE EXCEPTION`, documente o ID da análise, o nome da ferramenta, qualquer mensagem de erro disponível no registro do mcp ou na resposta da ferramenta e o histórico de conversas higienizado opcional e entre em contato com o suporte. AWS 

## Perguntas e respostas
<a name="spark-upgrade-agent-qa"></a>

### 1. Devo habilitar a configuração de “confiança” para as ferramentas por padrão?
<a name="spark-upgrade-agent-qa-trust-setting"></a>

Não ative a configuração “confiança” por padrão para todas as chamadas de ferramentas inicialmente e opere em um ambiente de compilação com versão git. Analise a execução de cada ferramenta para entender quais mudanças estão sendo feitas, por exemplo, revise o plano de atualização antes de fornecer consentimento. Nunca confie no Kiro ou na `fs_write` ferramenta do seu agente - essa ferramenta modifica seus arquivos de projeto e você deve sempre revisar as alterações antes que elas sejam salvas/confirmadas. Em geral, examine todas as alterações propostas nos arquivos antes de permitir que elas sejam gravadas. Use o git para alterar a versão e criar pontos de verificação durante todo o processo de atualização. Crie confiança gradualmente - Se você estiver usando o sistema repetidamente para várias atualizações e tiver adquirido confiança nas ferramentas, poderá confiar seletivamente em determinadas ferramentas.

### 2. Quais são os exemplos comuns de solicitações para aproveitar as ferramentas de atualização?
<a name="spark-upgrade-agent-qa-prompt-examples"></a>

Consulte [Exemplos imediatos do Spark Upgrade Agent](emr-spark-upgrade-agent-prompt-examples.md) para obter exemplos imediatos sobre como aproveitar as ferramentas de atualização.