Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Resolución de problemas
La migración ya está abierta
AWS El registro de agentes se ha lanzado en el nuevo espacio de agent-registry nombres. La compatibilidad con el espacio de bedrock-agentcore nombres de versión preliminar pública dejará de funcionar el 17 de septiembre de 2026. Para obtener instrucciones sobre la migración, consulta la Guía Guía completa de migración de registros completa de migración del registro.
Errores de validación de esquemas
Al crear diferentes tipos de registros, es posible que aparezca una excepción de validación para los descriptores. Consulte la sección Tipos de registros admitidos para ver los esquemas válidos.
Errores comunes:
-
«La versión del esquema '0.3.0' no es compatible con el tipo de descriptor 'a2a'». — El valor del campo SchemaVersion debería estar en lugar de.
0.30.3.0Esto coincide con la descripción oficial de la versión del protocolo A2A que apareceen el sitio web del Protocolo A2A: «Utilice la última versión secundaria compatible para cada versión principal». -
«Fallo en la validación del esquema: el contenido no cumple con la versión '0.3' del esquema para el tipo de descriptor 'a2a'». — Puedes encontrar el esquema en los tipos de registro compatibles. Tenga en cuenta que el contenido se validará comparándolo con el valor #/ definitions/AgentCard del esquema json.
Registra los errores de sincronización
Al crear o actualizar un registro mediante la función de sincronización, el registro puede pasar al estado CREATE_FAILED o UPDATE_FAILED, con una explicación de lo que ha ocurrido. statusReason
En el nivel superior, los errores se pueden clasificar en: errores de permiso, errores de conexión, errores de validación y errores del lado 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». — Sus credenciales para la API de creación o actualización han caducado. Puedes volver a intentarlo con la UpdateRegistryRecord API.
-
«Se recibió una excepción de la GetWorkloadAccessToken API:<detailed message>» — El registro llama a la GetWorkloadAccessToken API en tu nombre. Consulta el mensaje detallado para ver el error específico. Consulte Sincronizar registros de fuentes externas si aparece un error de acceso denegado.
-
«No se puede analizar el ARN del proveedor de credenciales:<arn>» — El ARN del proveedor de credenciales tiene un formato incorrecto. Proporcione un ARN de proveedor de credenciales válido creado a partir de Identity. AgentCore
-
«Se recibió una excepción de la GetResourceOauth2Token API:<detailed message>» — El registro llama a la GetResourceOauth2Token API en tu nombre. Consulta el mensaje detallado para ver el error específico. Consulte Sincronizar registros de fuentes externas si aparece un error 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 su nombre. Consulte Sincronizar registros de fuentes externas para ver los permisos de IAM esperados. Por ejemplo, debe tener el
iam:PassRolepermiso.
Errores de conexión
No se puede acceder al servidor:
-
«No se pudo obtener la tarjeta de agente de la URL: %s» — IOException A2A
-
«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.
-
Si el código de estado es 401 o 403, compruebe que ha configurado el proveedor de credenciales correcto y que sus credenciales tienen permiso para conectarse al servidor MCP. Para solucionar problemas, adquiera las credenciales manualmente y conéctese directamente al servidor MCP.
-
«La URL proporcionada se convierte 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»: la excepción de inicialización de la solicitud
-
«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 agotó el tiempo de espera para la tools/list paginación del servidor MCP»: el registro solo admite un máximo de 30 segundos al paginar las herramientas del servidor MCP. Póngase en contacto con AWS el servicio de asistencia si su servidor MCP necesita más tiempo para sincronizarse.
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 A2A está vacío o tiene un formato JSON incorrecto
-
«La tarjeta de agente supera el límite de tamaño máximo»: la respuesta A2A es demasiado grande
-
«No se pudo analizar el JSON de respuesta del servidor MCP»: el contenido de MCP está vacío o tiene un formato incorrecto
-
«El servidor MCP devolvió una respuesta no válida: falta el resultado» — MCP no encontró el resultado 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. Vuelve a intentarlo más tarde o ponte en contacto con el servicio de AWS asistencia para obtener ayuda.
Auto-detection errores
«La creación de un registro en el ámbito de la organización requiere que la persona que llama forme parte de un AWS Organización».
La cuenta que crea el registro no es miembro de una AWS organización (por ejemplo, es una cuenta independiente). Crea el registro desde una cuenta que pertenezca a tu organización.
«Esta organización no cumple Auto-detection las condiciones previas».
La organización aún no cumple las condiciones previas de detección automática o no ha terminado de propagarse. Confirma que el acceso de confianza está habilitado para la detección automática y que estás creando el registro desde la cuenta de administración o desde un administrador delegado registrado, y vuelve a intentarlo tras esperar un poco. Consulta Cómo habilitar la detección automática en tu organización.
«Ya existe un registro por ámbito organizativo para esta cuenta».
Esta cuenta ya posee un registro de ámbito organizativo y una cuenta solo puede tener uno. Usa el registro existente o elimínalo antes de crear otro. Si no puedes encontrar el registro en esta cuenta, consulta Cómo localizar un registro existente con ámbito organizativo.
«Ya existe otro registro por ámbito organizativo con detección automática activa para esta organización».
Otra cuenta de su organización ya posee un registro de ámbito organizativo con detección automática activa, y una organización solo puede tener uno a la vez. Por motivos de seguridad, el mensaje de error no menciona la cuenta propietaria del registro existente. Para buscarlo y elegir cómo resolver el conflicto, consulta Cómo localizar un registro existente con ámbito organizativo.
Localizar un registro existente con ámbito organizacional
Cuando se CreateRegistry informa de que ya existe un registro que abarca a una organización (ya sea en tu cuenta o en algún otro lugar de la organización), el error no indica el nombre del registro específico ni de la cuenta a la que pertenece. Busca primero el registro existente y, a continuación, decide cómo resolver el conflicto.
Un registro con ámbito organizacional normalmente es propiedad de una de estas cuentas:
-
La cuenta de administración de la organización.
-
La cuenta actualmente registrada como administradora delegada del Registro de AWS agentes.
Pida a un administrador con acceso a esas cuentas que enumere los registros de la misma región que la llamada fallida y busque uno que autoDetectionConfiguration.scope seaORGANIZATION:
aws agent-registry-control list-registries --region us-east-1
Desde la cuenta de administración, confirme qué cuenta es actualmente la de administrador delegado:
aws organizations list-delegated-administrators \ --service-principal agent-registry.amazonaws.com
El conflicto solo se aplica dentro de la misma región; un registro us-east-1 no impide crear unous-west-2.
Una vez que encuentre el registro existente, elija una de las siguientes rutas:
-
Compártelo y reutilízalo. Haga que la cuenta propietaria le conceda acceso a su cuenta mediante AWS RAM y administre los registros del registro compartido en lugar de crear uno nuevo. Consulta Compartir un registro entre cuentas con AWS RAM.
-
Libera la ranura sin eliminarla. La cuenta propietaria se establece
autoDetectionConfiguration.enabledfalseen el registro existente; cuando la actualización entre en vigor, vuelva a intentarloCreateRegistry. Consulte Desactivar la detección automática en el registro. -
Elimine el registro existente. Si ya no se necesita, la cuenta del propietario la elimina. Consulta Cómo desactivar la detección automática para el pedido de desmontaje.
CreateRegistryfalla aunque el acceso confiable esté habilitado y el administrador delegado esté registrado
Confirme que la cuenta de administración tenga la función vinculada al servicio de registro del AWS agente ()AWSServiceRoleForAgentRegistry. Debe existir en la cuenta de administración antes de poder crear un registro para toda la organización, incluso si el administrador delegado es quien lo crea. Consulte el paso 1: Habilitar el acceso confiable y crear el rol vinculado al servicio.
El registro está LISTO, pero los registros no aparecen
Confirme que el estado de detección automática del registro es ACTIVE (conget-registry) y que las cuentas de los miembros contienen los tipos de recursos compatibles (AgentCore Runtimes o Gateways). Dé tiempo para que se complete la detección: en la primera configuración, la detección inicial de los recursos preexistentes puede tardar hasta 20 minutos.
Auto-detection el estado sigue mostrando el mensaje «Se canceló el registro de la cuenta de administrador delegado del registro» después de volver a registrar a un administrador delegado
Cuando la cuenta de administración anula el registro del administrador delegado propietario de un registro que abarca a una organización, el Registro del AWS agente desactiva la detección automática en ese registro y registra el motivo del estado. The registry’s delegated administrator account was deregistered. Este motivo de estado describe por qué la detección automática se deshabilitó originalmente: es un registro histórico y no se actualiza cuando el estado de la organización cambia más adelante.
Si se vuelve a registrar a un administrador delegado, la detección automática del registro no se reanuda automáticamente y el motivo del estado sigue mostrando el mensaje de cancelación del registro. Esto es lo que se espera en cada una de las siguientes situaciones:
-
La misma cuenta se vuelve a registrar como administrador delegado.
-
Se registra una cuenta diferente como administrador delegado, incluso cuando esa cuenta ya posee su propio registro para toda la organización y la detección automática está previamente deshabilitada.
-
No hay ningún administrador delegado nuevo registrado y la cuenta de administración es propietaria directa de un registro que abarca a la organización.
Para reanudar la detección automática, la cuenta propietaria del registro afectado debe volver a establecerse explícitamente en. enabled true ACTIVEEn una organización solo se puede autoDetection.status establecer un registro de ámbito organizativo por región, por lo que, si varios registros cumplen los requisitos, vuelve a activar la detección automática únicamente en el registro que quieras mantener activo.
aws agent-registry-control update-registry \ --registry-id <registry-id-or-arn> \ --auto-detection-configuration '{"optionalValue":{"scope":"ORGANIZATION","enabled":true}}' \ --region us-east-1
Para ver el ciclo de vida completo, consulta Cómo desactivar la detección automática. Desactivar la detección automática
«El registro no se puede eliminar mientras la detección automática esté habilitada. Desactive primero la detección automática».
Debes deshabilitar la detección automática antes de poder eliminar un registro que abarque a una organización. Para eliminar el registro, complete estos pasos en orden:
-
Deshabilite la detección automática en el registro (establecida
autoDetectionConfiguration.enabledenfalse). -
Elimine todos los registros del registro.
-
Elimine el registro.
Para obtener más información, consulte Deshabilitar la detección automática en el registro.