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.
Conceptos y terminología
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.
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 del plano de datos detectables y al punto final del MCP, y una configuración de aprobación que determina si los registros requieren una revisión manual antes de que puedan descubrirse.
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 registral
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 descriptor opcionalname, legible por humanosdisplayName, una descripción opcional, unrecordVersion, a recordType (AGENT, MCPSKILL, oCUSTOM) y descriptores específicos del tipo de recurso que contienen el contenido real. La combinación de ambos name recordVersion debe ser única en el registro (se usa como clave de deduplicación), de modo que la misma se name pueda reutilizar en diferentes versiones del mismo 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 del agente valida los registros del servidor MCP comparándolos con el esquema del protocolo
Agentes: los agentes son programas autónomos que pueden razonar, planificar y tomar medidas para llevar a cabo las tareas. El registro de un agente contiene una tarjeta de agente que describe las capacidades, las habilidades y la interfaz de comunicación del agente según la especificación del protocolo A2A
Habilidades: las habilidades son capacidades reutilizables que se pueden compartir entre los agentes. Un registro de habilidades contiene metadatos descriptores básicos, como el nombre y la descripción, información de acceso opcional, como los detalles del paquete o el repositorio, y documentación de marcado opcional que describe para qué sirve 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 con cualquier estructura JSON válida.
Proveedor de credenciales
Cuando configuras un registro de registro para sincronizar los metadatos de una fuente externa (autorización saliente), AWS Agent Registry necesita credenciales para acceder a esa fuente. Un proveedor de credenciales almacena los detalles de autorización (ya sean credenciales de OAuth o una función 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: utilice esta configuración para controlar la forma en que los consumidores buscan, exploran e invocan las API del plano de datos detectables y los puntos de conexión MCP del registro (mediante la AWS CLI, el AWS SDK o un cliente). MCP-compatible El registro admite la autorización entrante. IAM-based JWT-based La autorización entrante se especifica como parte del flujo de trabajo para crear un registro.
-
Autorización de salida: al configurar un registro para su sincronización con un punto final MCP o A2A remoto, el registro necesita credenciales de salida para invocar el recurso remoto en el punto final especificado y recuperar los metadatos. Estas credenciales se proporcionan como parte de la configuración del trabajo de sincronización para un registro de registro determinado.
Tags
Puede adjuntar etiquetas a los registros y registros de registro para la asignación de costos, el control de acceso y el seguimiento organizacional. Cada etiqueta es un par clave-valor, y tanto las claves como los valores son cadenas que usted define. Las etiquetas no afectan al comportamiento de un registro o registro en tiempo de ejecución; existen como metadatos que usted y su organización pueden usar para clasificar los recursos de una cuenta. AWS
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 se encuentran comúnmente en todas las organizaciones.
- Administrador
-
Como administrador, usted es el propietario de la infraestructura del registro. Usted crea y configura los registros dentro de la AWS cuenta, decide cómo se organiza cada registro (por equipo, entorno o tipo de recurso) y elige el método de autorización (IAM o JWT) que determina la forma en que los consumidores acceden al registro. Tú configuras el flujo de trabajo de aprobación (decidiendo si los registros requieren una revisión manual o se aprueban automáticamente) y configuras EventBridge las integraciones de Amazon para conectar el registro a los sistemas de notificación y revisión existentes de tu organización. Gestionas los permisos de IAM para controlar qué editores, comisarios y consumidores pueden acceder a cada registro. Como administrador, también tienes acceso total para crear, actualizar y eliminar registros, y puedes aprobar, rechazar o desaprobar los registros cuando sea necesario.
- Publicador
-
Como editor, usted es un creador dentro de la organización que ha creado un recurso (un servidor MCP, un agente, una habilidad o alguna otra herramienta) y desea que otros puedan descubrirlo. Creas registros de registro que describen tus recursos y proporcionan los metadatos, las definiciones y la información de versión que ayudan a otros a encontrar y entender lo que hace el recurso. Los registros en estado de borrador se repiten, se refinan las descripciones y los esquemas hasta que el registro esté listo y, a continuación, se envía para su aprobación. Si se rechaza un registro, revisas los comentarios del comisario, haces los cambios necesarios y vuelves a enviarlo. También puede configurar la URL-based sincronización para que sus registros permanezcan sincronizados con los servidores MCP activos sin necesidad de actualizaciones manuales.
- Curador//Aprobador
-
Como comisario, usted es el guardián de calidad del registro y, a menudo, también puede ser el administrador del registro. Usted revisa los registros que los editores han enviado para su aprobación y evalúa cada registro en función de los estándares de seguridad, cumplimiento, integridad de los metadatos y cualquier otro criterio de su organización que defina. Apruebas los registros que cumplen estos estándares (haciéndolos visibles a través de las API de plano de datos que se pueden detectar (búsqueda, lista, obtención por lotes) y a través del punto final de MCP, y rechazas los registros que no lo hacen, proporcionando una opinión clara sobre lo que hay que corregir. Cuando un recurso se retira, tiene problemas conocidos o se reemplaza por una versión más reciente, el registro queda obsoleto para eliminarlo de la detección. Como responsable, contribuyes a 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
-
Como consumidor, eres una persona o un agente que necesita encontrar y usar recursos. Puede descubrir los registros aprobados de tres maneras:
-
Busque mediante consultas en lenguaje natural o búsquedas por palabra clave para encontrar registros que coincidan con un tema, una capacidad o un caso de uso ()
SearchDiscoverableRegistryRecords. -
Explore el catálogo de registros aprobados con una lista paginada, filtrada opcionalmente por tipo de registro, y recupere los detalles de uno o varios registros a la vez (
ListDiscoverableRegistryRecordsyGetDiscoverableRegistryRecord/).BatchGetDiscoverableRegistryRecord -
Conéctese al punto final MCP del registro desde cualquier MCP-compatible cliente para descubrir las herramientas disponibles mediante programación ().
InvokeRegistryMcpComo consumidor, solo ve los registros aprobados, por lo que puede confiar en que todo lo que encuentre en el registro se ha revisado y cumple con los estándares de calidad de la organización. Puedes autorizar mediante credenciales de IAM o tokens JWT de un proveedor de identidad corporativo, según cómo esté configurado el registro.
-
