View a markdown version of this page

Solução de problemas - Amazon Bedrock AgentCore
Erros de validação de esquemaErros de sincronização de registros

Solução de problemas

Próxima migração de namespace

AWS O Agent Registry está atualmente em versão prévia pública sob o namespace bedrock-agentcore. A partir de 6 de agosto de 2026, o serviço passa para o namespace de registro do agente. Se você usa o AWS Agent Registry, deve atualizar seus endpoints, políticas do IAM, clientes SDK, scripts de CLI e dados de registro. Para obter mais informações sobre a migração da versão prévia pública, consulte o guia abrangente de migração do registro.

Erros de validação de esquema

Ao criar tipos diferentes de registros, você pode ver uma exceção de validação para os descritores. Consulte a seção Tipos de registro compatíveis para ver esquemas válidos.

Erros comuns:

  • “A versão do esquema '0.3.0' não é suportada para o tipo de descritor 'a2a'.” — O valor do campo SchemaVersion deve ser 0.3 em vez de. 0.3.0 Isso se alinha com a descrição oficial da versão do protocolo A2A: “Use a versão secundária mais recente suportada por versão principal”.

  • “Falha na validação do esquema: o conteúdo não está em conformidade com a versão '0.3' do tipo de descritor 'a2a'.” — Você pode encontrar o esquema em Tipos de registro compatíveis. Observe que o conteúdo será validado em relação a #/ definitions/AgentCard no esquema json.

Erros de sincronização de registros

Quando você cria ou atualiza um registro usando o recurso de sincronização, o registro pode passar para o status CREATE_FAILED ou UPDATE_FAILED, com uma explicação do que aconteceu. statusReason

Em alto nível, os erros podem ser categorizados como: erros de permissão, erros de conexão, erros de validação e erros do lado do servidor.

Erros de permissão

A configuração de sincronização está errada ou expirou:

  • “Não é possível conectar-se ao servidor MCP porque as credenciais do chamador expiraram.” — o chamador da API de criação ou atualização tem credenciais expiradas. Você pode tentar novamente com a UpdateRegistryRecord API.

  • “Exceção recebida da GetWorkloadAccessToken API:<detailed message>” — o registro chama a GetWorkloadAccessTokenAPI em nome do chamador. Consulte a mensagem detalhada para saber mais sobre o erro. Consulte Sincronizar registros de fontes externas se você ver a exceção de acesso negado.

  • “Não foi possível analisar o ARN do provedor de credenciais:<arn>” — ARN do provedor de credenciais malformado. Esse deve ser um ARN de provedor de credenciais válido criado AgentCore a partir do Identity.

  • “Exceção recebida da GetResourceOauth2Token API:<detailed message>” — o registro chama a GetResourceOauth2TokenAPI em nome do chamador. Consulte a mensagem detalhada para saber mais sobre o erro. Consulte Sincronizar registros de fontes externas se você ver a exceção de acesso negado.

  • “Não é possível assumir a função do IAM fornecida para autorização do servidor MCP.” — AssumeRole API de chamadas de registro em nome do chamador. Consulte Sincronizar registros de fontes externas para obter as permissões esperadas do IAM, por exemplo, o chamador deve ter iam:PassRole permissão.

Erros de conexão

Não consigo acessar o servidor:

  • “Falha ao buscar o cartão do agente a partir do URL: %s” — A2A IOException

  • “O servidor MCP retornou HTTP<code>” — resposta não 200/202 HTTP do servidor MCP. Verifique se o URL está correto e se o servidor MCP pode ser conectado.

  • “O URL fornecido é resolvido para um endereço IP não público” — O Registro só suporta a conexão com servidores de endereços IP públicos.

  • “Falha na conexão com o servidor MCP” — IOException/connection falha

  • “URL inválida do servidor MCP” — URL incorreta

  • “Falha ao inicializar a conexão MCP” — exceção de inicialização da solicitação

  • “Falha ao enviar a notificação inicializada” — exceção de notificação

  • “Falha ao listar ferramentas do servidor MCP” — exceção tools/list

  • “Tempo limite de tools/list paginação do servidor MCP” — o registro suporta apenas no máximo 30 segundos ao paginar ferramentas do servidor MCP. Entre em contato com o AWS suporte se o servidor MCP precisar de mais tempo para sincronização.

Erros de validação

O servidor respondeu, mas o conteúdo não é suportado:

  • “Falha ao analisar o JSON do cartão do agente” — conteúdo A2A vazio ou JSON malformado

  • “O cartão do agente excede o limite máximo de tamanho” — resposta A2A muito grande

  • “Falha ao analisar a resposta JSON do servidor MCP” — Conteúdo MCP vazio ou malformado

  • “O servidor MCP retornou uma resposta inválida: resultado ausente” — Resultado ausente do JSON-RPC MCP

  • “A resposta do servidor MCP excede o tamanho máximo permitido” — a resposta do MCP é muito grande

  • “O tipo de descritor %s não suporta sincronização de URL” — tipo de descritor não suportado

Erros do lado do servidor

  • “Erro desconhecido” — Esse é um erro do lado do servidor. Tente novamente mais tarde ou entre em contato com o AWS suporte para obter ajuda.