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. # Navegar por los registros aprobados **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](registry-faq.md) completa de migración del registro. Como consumidor, puede explorar el catálogo de registros aprobados de un registro mediante dos API de plano de datos: `ListDiscoverableRegistryRecords` para la publicación paginada y `BatchGetDiscoverableRegistryRecord` para la recuperación masiva del contenido completo de los registros por ID de registro. Ambas API solo están disponibles en el espacio de `agent-registry` nombres y solo muestran los registros cuya última revisión tenga el estado Aprobada. ** ** Los registros en ** estado ** Borrador**, ** Pendiente de aprobación ****, ** Rechazado o ** Obsoleto no se devuelven. Para buscar registros con una consulta en lenguaje natural, utilice en su lugar. `SearchDiscoverableRegistryRecords` Consulte [ Buscar registros de registro. ](registry-search-records.md) **nota** `ListDiscoverableRegistryRecords`y solo `BatchGetDiscoverableRegistryRecord` están disponibles en el espacio de `agent-registry` nombres. Los registros creados en el espacio de `bedrock-agentcore` nombres no exponen estas API; utilícelas. `SearchDiscoverableRegistryRecords` ## Enumere los registros aprobados `ListDiscoverableRegistryRecords`Utilícelo para obtener resúmenes paginados de cada registro aprobado en un registro. Los resúmenes no incluyen los descriptores del registro; utilícelos `BatchGetDiscoverableRegistryRecord` para obtener el contenido completo del descriptor después de identificar los registros que necesita. ### Parámetros de solicitud + **RegistryID ** (obligatorio, ruta): ARN o ID del registro desde el que se va a incluir la lista. + **maxResults ** (opcional): número máximo de resultados por página. El rango válido es de 1 a 100. + **nextToken ** (opcional): token de paginación de una respuesta anterior. Omitir para la primera página. + **filtros ** (opcional): una lista de las entradas de filtro del formulario`{"name": "", "values": [""]}`. Nombres de filtros compatibles: + `recordType`— Tipo semántico del registro. Valores válidos: `AGENT`, `MCP`, `SKILL`, `CUSTOM`. + `descriptorType`— Clave descriptora principal utilizada por el registro. Valores válidos: `a2aAgentCard`, `mcpServer`, `agentSkillsDefinition`, `custom`. Se rechazan los nombres de filtro duplicados. Si especifica varios valores para un solo filtro, los valores se unen mediante ** OR**. Si especifica varios filtros, los filtros se unen mediante ** AND**. Cada resumen de la respuesta contiene:`registryArn`,`recordArn`,`recordId`,`name`,`displayName`,`description`,`recordType`,`recordVersion`,`status`,`createdAt`,`updatedAt`. ### Orden y paginación de las respuestas Los resultados se ordenan alfabéticamente por nombre de registro. `ListDiscoverableRegistryRecords`no garantiza páginas densas. Cualquier respuesta individual puede contener menos `maxResults` registros o cero registros, incluso cuando existen más registros coincidentes. Continúe llamando a la API con `nextToken` el resultado de cada solicitud subsiguiente hasta que la respuesta no contenga `nextToken` (o `nextToken` contenga`null`) ningún registro coincidente. ### Consola **Example** 1. Abra la consola [AWS de registro de agentes](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#). 1. En el panel de navegación, seleccione el directorio de ** registros**. 1. Elija el registro que desea explorar. La página llama automáticamente a los registros aprobados `ListDiscoverableRegistryRecords` y los muestra en una tabla paginada. 1. (Opcional) Utilice el ** menú ** Propiedades situado junto a la barra de búsqueda para filtrar por tipo ** de ** registro. 1. Elija el nombre de un registro para ver su contenido descriptor completo. La navegación por el catálogo de registros aprobados solo `ListDiscoverableRegistryRecords` está disponible en el espacio de nombres. `agent-registry` La Bedrock-AgentCore consola anterior no tiene una ** página de directorio de ** registros ni una función de exploración. Para buscar registros en un registro creado en el espacio de `bedrock-agentcore` nombres, utilice la ** pestaña ** Buscar registros de la página de detalles del registro (consulte [ Buscar registros ](registry-search-records.md) de registro). **nota** La ** página del directorio de ** registros requiere una autorización de IAM-based entrada en el registro seleccionado. En el JWT-authorized caso de los registros, llama `ListDiscoverableRegistryRecords` directamente con un cliente HTTP y un token portador de JWT válido. ### AWS CLI ``` aws agent-registry list-discoverable-registry-records \ --registry-id "" \ --filters '[{"name": "recordType", "values": ["MCP"]}]' \ --max-results 50 \ --region us-east-1 ``` Para ver los resultados, pasa el `nextToken` valor de la respuesta anterior: ``` aws agent-registry list-discoverable-registry-records \ --registry-id "" \ --next-token "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('agent-registry') paginator = client.get_paginator('list_discoverable_registry_records') for page in paginator.paginate( registryId='', filters=[{'name': 'recordType', 'values': ['MCP']}] ): for record in page['registryRecords']: print(f"{record['displayName']} ({record['name']}) - {record['recordType']} v{record['recordVersion']}") ``` ### Cliente HTTP ``` curl -X POST "https://agent-registry..api.aws/registries//discoverable-records-list" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "filters": [{"name": "recordType", "values": ["MCP"]}], "maxResults": 50 }' ``` ## Recupera por lotes los registros aprobados `BatchGetDiscoverableRegistryRecord`Utilícelo para recuperar el contenido completo del descriptor de hasta 100 ID de registro en una sola llamada. Caso práctico habitual: después de buscar `ListDiscoverableRegistryRecords` e identificar los registros que desea, busque sus descriptores en una llamada en lugar de realizar una `SearchDiscoverableRegistryRecords` llamada por registro. ### Parámetros de solicitud + **entradas ** (obligatorio): una lista de grupos de registros con ámbito de registro. En el momento del lanzamiento, se acepta exactamente una entrada (un registro por solicitud); esto es compatible con versiones posteriores para que en el futuro se puedan realizar registros por lotes cruzados. Cada entrada contiene: + **RegistryID ** (obligatorio): ARN o ID del registro. + **ID de registro ** (obligatorio): lista de 1 a 100 ARN o ID de registros para recuperarlos del registro. ### Respuesta + **RegistryRecords**: objetos de registro completos (con descriptores) para los registros que se recuperaron correctamente. + **errores**: una lista de errores por registro. Vacía cuando todos los registros solicitados se devolvieron correctamente. La llamada devuelve el protocolo HTTP 200 incluso si se produce un error parcial: los registros que no se han podido recuperar aparecen en la `errors` lista, en lugar de provocar un error en toda la llamada. Cada entrada de error se repite `recordId` desde `registryId` y hacia la solicitud, además de`errorCode`: + **RESOURCE\_NOT\_FOUND**: el registro no existe, se ha eliminado o su última revisión no está aprobada. ** ** Non-approved los registros están agrupados en este código para que no se revele su existencia a las personas que llaman y carecen de visibilidad. + **ACCESS\_DENIED**: la persona que llama no está autorizada a leer este registro específico. + **INTERNAL\_ERROR: un error ** de recuperación transitorio. Es seguro volver a intentar el subconjunto fallido con un retraso exponencial. Batch-level los errores (el registro no existe, la persona que llama no tiene acceso al registro, error de servicio irrecuperable) se devuelven mediante errores de operación estándar, no mediante la lista por registro. `errors` ### AWS CLI ``` aws agent-registry batch-get-discoverable-registry-record \ --entries '[{"registryId": "", "recordIds": ["", "", ""]}]' \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('agent-registry') response = client.batch_get_discoverable_registry_record( entries=[ { 'registryId': '', 'recordIds': ['', '', ''] } ] ) for record in response['registryRecords']: print(f"Retrieved: {record['displayName']} ({record['recordId']})") for error in response['errors']: print(f"Failed: {error['recordId']} ({error['errorCode']}): {error.get('message', '')}") ``` ### Cliente HTTP ``` curl -X POST "https://agent-registry..api.aws/discoverable-records-batch" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "entries": [ { "registryId": "", "recordIds": ["", "", ""] } ] }' ```