Conceptos y terminología
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.
Registro
Un registro es un catálogo centralizado que se crea en la AWS cuenta para organizar y administrar los recursos. Cada registro tiene un nombre, una descripción, una configuración de autorización que controla la forma en que los consumidores acceden a las API de búsqueda y de MCP, y una configuración de aprobación que determina si los registros requieren una revisión manual antes de poder descubrirlos.
La forma en que organice sus registros depende de sus necesidades, por ejemplo, registros dedicados para diferentes tipos de recursos (un registro de agentes, un registro de servidores MCP, un registro de habilidades), registros para diferentes etapas de desarrollo (producción, control de calidad, desarrollo), registros independientes para diferentes equipos o unidades de negocio, o un registro único para toda la organización.
Registro de registro
Un registro de registro representa los metadatos de un recurso individual publicado en un registro. Cada registro captura los metadatos clave que describen el recurso subyacente y proporcionan información sobre qué es, qué hace y cómo se puede encontrar. Los registros tienen un nombre, una descripción opcional, una versión, un tipo y metadatos específicos del tipo de recurso.
Tipos de recurso
Servidores MCP: los servidores del Model Context Protocol (MCP) proporcionan herramientas que los agentes de IA pueden descubrir e invocar. Un registro de servidor MCP contiene una definición de servidor que describe la configuración del servidor y las definiciones de herramientas para todas las herramientas que proporciona el servidor, incluidos sus parámetros de entrada y formatos de salida. AWS El registro de agentes valida los registros del servidor MCP según el esquema del protocolo MCP
Agentes: los agentes son programas autónomos que pueden razonar, planificar y tomar medidas para realizar tareas. El registro de un agente contiene una tarjeta de agente que describe las capacidades, habilidades e interfaz de comunicación del agente según la especificación del protocolo A2A (Agent-to-Agent)
Habilidades: las habilidades son capacidades reutilizables que pueden compartirse entre los agentes. Un registro de habilidades contiene metadatos descriptivos básicos, como el nombre, la descripción, información de acceso opcional, como los detalles del paquete o el repositorio, y documentación de marcado opcional que describe lo que hace la habilidad y cómo usarla.
Recursos personalizados: en el caso de los recursos que no se ajustan a los tipos estándar anteriores, puedes definir tu propio esquema de metadatos mediante cualquier estructura JSON válida.
Proveedor de credenciales
Al configurar un registro de registro para sincronizar los metadatos de una fuente externa (autorización de salida), AWS Agent Registry necesita credenciales para acceder a esa fuente. Un proveedor de credenciales almacena los detalles de autorización (credenciales de OAuth o un rol de IAM) que AWS Agent Registry utiliza para invocar el punto final del recurso externo durante la sincronización. Al configurar la sincronización en un registro, se hace referencia a un proveedor de credenciales por su ARN. Para obtener más información, consulte Administrar proveedores de credenciales.
La autorización de registro es de dos tipos:
-
Autorización entrante: esta configuración permite a los administradores del registro controlar cómo los consumidores pueden buscar en el registro (mediante AWS CLI, AWS SDK o invocando el punto final MCP). El registro admite la autorización de entrada basada en IAM y en JWT. Los administradores del registro lo especifican como parte del flujo de trabajo para crear un registro.
-
Autorización de salida: como parte de la sincronización de los registros MCP y A2A con sus puntos finales remotos (en el caso de los registros en los que la sincronización está configurada), el registro requiere credenciales de salida para invocar el recurso remoto en el punto final especificado y recuperar los metadatos. Los editores proporcionan estas credenciales como parte de la configuración del trabajo de sincronización para un registro de registro concreto.
Personas clave
Las personas que utilizan el Registro pueden variar de una organización a otra. Sin embargo, hemos visto las siguientes personas generales que interactúan con el Registro y que suelen encontrarse en todas las organizaciones.
- Administrador
-
El administrador es el propietario de la infraestructura de registro. Son responsables de crear y configurar los registros dentro de la AWS cuenta, decidir cómo se organiza cada registro (por equipo, entorno o tipo de recurso) y elegir el método de autorización (IAM o JWT) que determina la forma en que los consumidores acceden al registro. Los administradores configuran el flujo de trabajo de aprobación (decidiendo si los registros requieren una revisión manual o se aprueban automáticamente) y configuran EventBridge las integraciones de Amazon para conectar el registro a los sistemas de notificación y revisión existentes de la organización. Administran los permisos de IAM para controlar qué editores, curadores y consumidores pueden acceder a cada registro. Como son los administradores, también tienen acceso total para crear, actualizar y eliminar registros, y pueden aprobar, rechazar o desaprobar los registros cuando sea necesario.
- Publicador
-
El publicador es un creador de la organización que ha creado un recurso (un servidor MCP, un agente, una habilidad o alguna otra herramienta) y quiere que otros puedan descubrirlo. Los editores crean registros de registro que describen sus recursos y proporcionan los metadatos, las definiciones y la información de versión que ayudarán a otros usuarios a encontrar y comprender la función del recurso. Iteran los registros en estado de borrador, refinan las descripciones y los esquemas hasta que el registro está listo y, a continuación, lo envían para su aprobación. Si se rechaza un registro, el editor revisa los comentarios del curador, realiza los cambios necesarios y los vuelve a enviar. Los editores también pueden configurar la URL-based sincronización para que sus registros permanezcan sincronizados con los servidores MCP activos sin necesidad de actualizaciones manuales.
- Curador o aprobador
-
El curador es el guardián de calidad del registro y, a menudo, también puede ser el administrador del registro. Son responsables de revisar los registros que los editores han presentado para su aprobación y de evaluar cada registro según las normas de la organización en materia de seguridad, cumplimiento, integridad de los metadatos y cualquier otro criterio que la organización defina. Los curadores aprueban los registros que cumplen estos estándares, lo que los hace visibles en los resultados de búsqueda y a través del punto final del MCP, y rechazan los registros que no los cumplen, lo que proporciona una opinión clara sobre lo que hay que corregir. Cuando un recurso se retira del servicio, tiene problemas conocidos o se reemplaza por una versión más reciente, el administrador desaprueba el registro para eliminarlo del proceso de detección. Los curadores se aseguran de que el registro siga siendo un catálogo fiable y de alta calidad en el que puedan confiar los creadores de toda la organización.
- Consumidor
-
El consumidor es cualquier persona, humana o agente, que necesita encontrar y utilizar recursos. Los consumidores buscan en el registro mediante consultas en lenguaje natural o búsquedas de palabras clave para descubrir los servidores, los agentes, las habilidades y otros recursos de MCP que han sido aprobados y publicados. También pueden conectarse al punto final MCP del registro mediante cualquier MCP-compatible cliente para descubrir las herramientas disponibles mediante programación. Los consumidores solo ven los registros aprobados, por lo que pueden confiar en que todo lo que encuentran en el registro ha sido revisado y cumple con los estándares de calidad de la organización. Los consumidores pueden autorizarlos mediante credenciales de IAM o tokens JWT de un proveedor de identidad corporativa, en función de cómo esté configurado el registro.
