View a markdown version of this page

Resolución de problemas - Amazon Bedrock AgentCore
Errores de validación de esquemasRegistre los errores de sincronización

Resolución de problemas

Próxima migración de namespaces

AWS Actualmente, Agent Registry se encuentra en versión preliminar pública en el espacio de nombres bedrock-agentcore. A partir del 6 de agosto de 2026, el servicio pasará al espacio de nombres del registro de agentes. Si utiliza AWS Agent Registry, debe actualizar los puntos finales, las políticas de IAM, los clientes del SDK, los scripts de CLI y los datos de registro. Para obtener más información sobre la migración desde una versión preliminar pública, consulte la guía completa de migración del registro.

Errores de validación de esquemas

Al crear diferentes tipos de registros, es posible que veas una excepción de validación para los descriptores. Consulte la sección de tipos de registros admitidos para ver los esquemas válidos.

Errores comunes:

  • «La versión de esquema '0.3.0' no es compatible con el tipo de descriptor 'a2a'». — El valor del campo SchemaVersion debe ser 0.3 en lugar de. 0.3.0 Esto coincide con la descripción de la versión oficial del protocolo A2A: «Utilice la última versión secundaria compatible por cada versión principal».

  • «Falló la validación del esquema: el contenido no cumple con la versión '0.3' del esquema para el tipo de descriptor 'a2a'». — Puede encontrar el esquema en Tipos de registros admitidos. Tenga en cuenta que el contenido se validará con el número/definitions/AgentCard en el esquema json.

Registre los errores de sincronización

Al crear o actualizar un registro mediante la función de sincronización, es posible que el registro pase al estado CREATE_FAILED o UPDATE_FAILED, con una explicación de lo sucedido. statusReason

En un nivel alto, los errores se pueden clasificar de la siguiente manera: errores de permisos, errores de conexión, errores de validación y errores del servidor.

Errores de permisos

La configuración de sincronización es incorrecta o ha caducado:

  • «No se puede conectar al servidor MCP porque las credenciales de la persona que llama han caducado». — la persona que llama a la API de creación o actualización tiene las credenciales caducadas. Puedes volver a intentarlo con la UpdateRegistryRecord API.

  • «Excepción recibida de la GetWorkloadAccessToken API:<detailed message>»: el registro llama a la GetWorkloadAccessTokenAPI en nombre de la persona que llama. Consulte el mensaje detallado para obtener información sobre el error. Consulta Sincronizar registros de fuentes externas si ves una excepción de acceso denegado.

  • «No se puede analizar el ARN del proveedor de credenciales<arn>:": el ARN del proveedor de credenciales está mal formado. Debe ser un ARN de proveedor de credenciales válido creado AgentCore a partir de Identity.

  • «Excepción recibida de la GetResourceOauth2Token API:<detailed message>»: el registro llama a la GetResourceOauth2TokenAPI en nombre de la persona que llama. Consulte el mensaje detallado para obtener información sobre el error. Consulta Sincronizar registros de fuentes externas si ves una excepción de acceso denegado.

  • «No se puede asumir la función de IAM proporcionada para la autorización del servidor MCP». — el registro llama a la AssumeRole API en nombre de la persona que llama. Consulte Sincronizar registros de fuentes externas para conocer los permisos de IAM esperados; por ejemplo, la persona que llama debe tener permiso. iam:PassRole

Errores de conexión

No se puede acceder al servidor:

  • «No se pudo obtener la tarjeta de agente desde la URL: %s» — A2A IOException

  • «El servidor MCP devolvió HTTP<code>»: respuesta no 200/202 HTTP del servidor MCP. Compruebe si la URL es correcta y si se puede conectar el servidor MCP.

  • «La URL proporcionada se resuelve en una dirección IP no pública»: el registro solo admite la conexión a servidores de direcciones IP públicas.

  • «No se pudo conectar al servidor MCP»: error IOException/connection

  • «URL del servidor MCP no válida»: URL con formato incorrecto

  • «No se pudo inicializar la conexión MCP»: excepción de solicitud de inicialización

  • «No se pudo enviar la notificación inicializada»: excepción de notificación

  • «No se pudieron enumerar las herramientas del servidor MCP»: excepción tools/list

  • «Se ha agotado el tiempo de espera de tools/list paginación del servidor MCP»: el registro solo admite un máximo de 30 segundos al paginar las herramientas desde el servidor MCP. Póngase en contacto con AWS el servicio de asistencia si su servidor MCP necesita más tiempo para la sincronización.

Errores de validación

El servidor respondió, pero el contenido no es compatible:

  • «No se pudo analizar el JSON de la tarjeta de agente»: el contenido del A2A está vacío o tiene un formato incorrecto

  • «La tarjeta de agente supera el límite de tamaño máximo»: la respuesta A2A es demasiado grande

  • «No se pudo analizar la respuesta del servidor MCP (JSON)»: el contenido del MCP está vacío o tiene un formato incorrecto

  • «El servidor MCP devolvió una respuesta no válida: falta el resultado» — Falta el resultado del MCP JSON-RPC

  • «La respuesta del servidor MCP supera el tamaño máximo permitido»: la respuesta MCP es demasiado grande

  • «El tipo de descriptor %s no admite la sincronización de URL»: tipo de descriptor no compatible

Errores del lado del servidor

  • «Error desconocido»: se trata de un error del servidor. Vuelva a intentarlo más tarde o póngase en contacto con el servicio de AWS asistencia para obtener ayuda.