Agent Registry usa terminología estandarizada para describir los componentes, los recursos y los mecanismos de administración en todo tu ecosistema de IA. Comprender estos conceptos básicos te ayuda a registrar, descubrir, conectar y administrar agentes, servidores de MCP, endpoints y habilidades en Agent Registry.
Habilidad de A2A
Compara con la habilidad.
Una descripción de la capacidad que se incluye de forma intercalada en la agent-card.json
tarjeta de agente de un agente. Una habilidad de A2A
describe las tareas que puede realizar un agente y sus interfaces de comunicación para
que otros agentes sepan cuándo y cómo delegarle trabajo.
Agent Registry admite las versiones 0.3 y 1.0 de la
especificación de Agent2Agent (A2A). Para obtener una comparación
con las habilidades independientes, consulta
Diferencias entre las habilidades independientes y las de A2A.
Agente
Es un actor autónomo en tu ecosistema de IA que planifica, razona, invoca herramientas
y colabora con otros agentes. Un agente se define por su
identificador de agente
y cada habilidad de A2A o habilidad independiente que posee. En
Agent Registry, un agente registrado se representa como un recurso de descubrimiento Agent
de solo lectura.
Principal del agente
Es la identidad única de Identity and Access Management (IAM) asignada a un agente, lo que le permite tener permisos, acceder a recursos downstream y generar registros de auditoría. Adopta la forma de una cuenta de servicio de Google Cloud verificable o una Workload Identity administrada, como un ID de SPIFFE, vinculado directamente al entorno de ejecución de cómputo del agente.
Las cadenas de principal incorporan la ruta de acceso de la referencia del entorno de ejecución y admiten tres permisos: la instancia del motor, los conjuntos de principales de todo el proyecto y los conjuntos de principales de toda la organización.
Para obtener orientación completa sobre la sintaxis y el control de acceso, consulta Principales del agente.
Componente de agente
Es una entidad modular y funcional dentro de un ecosistema de IA que Agent Registry te permite registrar, descubrir y administrar. El registro categoriza los componentes de agentes en cuatro tipos principales: agente, servidor de MCP, endpoint y habilidad.
Para obtener más información, consulta Ciclo de vida y descubrimiento de componentes.
Flujo de trabajo de agentes
Es una secuencia de pasos en la que un agente de IA determina de forma independiente el uso de herramientas, el razonamiento y las rutas de ejecución para completar una tarea.
Proveedor de autenticación
Es una configuración dentro del administrador de autenticación de Agent Identity para almacenar, adquirir y administrar credenciales, como claves de API o tokens de OAuth, para conectar tu agente a herramientas externas y servicios downstream.
Para obtener más información sobre la vinculación de agentes a proveedores de autenticación, consulta Relaciones de componentes.
Vinculación
Es una conexión dirigida entre un agente de origen y un recurso de destino, como otro agente, un servidor de MCP o un endpoint. Las vinculaciones establecen rutas de delegación explícitas entre los componentes y asocian un agente con un proveedor de autenticación para los permisos delegados.
Para obtener más información, consulta Vinculaciones.
Recurso de datos
Es un contexto de datos o un conjunto de datos específico que expone un servidor de MCP al que un agente puede acceder para fundamentar sus respuestas o informar sus acciones.
Discovery
Es el proceso de consultar Agent Registry para encontrar un agente, una herramienta de MCP, un extremo o una habilidad registrados con la búsqueda en lenguaje natural, etiquetas o identificadores de registro.
El descubrimiento en Agent Registry se enfoca en el descubrimiento de consumo, que identifica las capacidades y los componentes que tus agentes de organización pueden invocar en el entorno de ejecución. Para obtener más información, consulta Tipos de descubrimiento.
Extremo
Es una URL de destino, por lo general, una API de REST, a la que accede un agente. En
Agent Registry, un extremo registrado se representa como un recurso de descubrimiento de Endpoint
de solo lectura, lo que te permite controlar de forma centralizada a qué servicios externos puede acceder
un agente.
Proyecto de administración
Es el proyecto de Google Cloud en el que habilitas la API de Agent Registry para catalogar, descubrir y administrar de forma centralizada tus componentes de agentes. Para obtener más información sobre las configuraciones de un solo proyecto y entre proyectos, consulta Define el proyecto de administración para un registro central.
Alcance de la administración
Es el límite geográfico y de arquitectura en el que se registran y rigen los recursos de Agent Registry.
Agent Registry usa un proyecto de administración central de Google Cloud, en el que habilitas la API de Agent Registry para catalogar y administrar tus componentes de agentes. El registro automático descubre las cargas de trabajo compatibles implementadas en ese proyecto de administración. Para controlar los componentes remotos, que son agentes, servidores de MCP o extremos alojados fuera del proyecto de administración en proyectos de Google Cloud independientes, entornos locales o nubes externas, debes registrarlos de forma manual en el registro del proyecto de administración.
Cuando Agent Registry registra automáticamente un servidor de MCP remoto de Google o de Google Cloud, crea el recurso McpServer solo en la ubicación global, no en regiones individuales. Puedes registrar agentes, servidores de MCP y extremos de forma manual, y crear vinculaciones, en una región admitida o en la ubicación global. Las puertas de enlace regionales pueden controlar y enrutar el tráfico a
los recursos regionales y a los servidores de MCP de global.
Para conocer las reglas de alcance regional y los requisitos de la política completos, consulta Ubicaciones de Agent Registry.
Protocolo de contexto del modelo (MCP)
Es el estándar abierto que se usa para conectar modelos de IA a fuentes de datos y herramientas, lo que reemplaza los complementos personalizados.
Servidor de MCP
Es un programa que implementa el
Protocolo de contexto del modelo (MCP)
para exponer capacidades estandarizadas de herramientas y recursos de datos
a un agente de IA. En Agent Registry, un servidor de MCP registrado
se representa como un recurso de descubrimiento McpServer de solo lectura.
Publicador
Es una entidad que crea y registra una habilidad, representada como un
recurso Publisher en Agent Registry. Un publicador establece la propiedad y la sintaxis del identificador de habilidad para una habilidad.
Las habilidades administradas por Google usan dominios de servicio. Las habilidades creadas de forma manual se asignan automáticamente al publicador private con un prefijo private-.
Para obtener más información, consulta Publicadores.
Registro
Es el proceso de agregar un componente de agente, como un agente, un servidor de MCP, un extremo o una habilidad, a Agent Registry.
El Registro de agentes admite dos modelos de registro:
- Registro automático: transferencia automática de agentes, servidores de MCP y habilidades administradas por Google desde entornos de ejecución compatibles con Google Cloud , como Agent Runtime en Gemini Enterprise Agent Platform, implementado en el proyecto de administración en el que Agent Registry está habilitado.
- Registro manual: Es el registro explícito de agentes remotos o personalizados, servidores de MCP, endpoints y habilidades independientes privadas, incluidos los componentes alojados en proyectos de Google Cloud independientes, entornos locales, nubes externas o entornos de ejecución no compatibles, a través de la creación de recursos en el registro del proyecto de administración.
Para obtener una comparación detallada de la arquitectura, consulta Modelos de registro.
Identificador del registro
Un nombre de recurso uniforme (URN) inmutable y único a nivel global que el Registro de agentes asigna a un componente de agente registrado. Este identificador proporciona una referencia estable para que los consumidores y los agentes de organización descubran, filtren y busquen componentes en el Registro de agentes, lo que permanece constante, independientemente de los cambios en la infraestructura subyacente o las actualizaciones de código.
Para obtener información detallada sobre los formatos de sintaxis de URN, consulta Identificadores de registro.
Referencia del entorno de ejecución
Es la ubicación física del entorno de ejecución o la infraestructura de procesamiento que aloja un
agente, un servidor de MCP o un extremo, representados
en Agent Registry por el atributo
agentregistry.googleapis.com/system/RuntimeReference. Por ejemplo,
una referencia de entorno de ejecución puede apuntar a un
motor de razonamiento de Agent Runtime, una
implementación de Google Kubernetes Engine (GKE) o un servicio de Cloud Run.
La ruta de referencia del entorno de ejecución está incorporada en el principal del agente para la evaluación de la política de IAM. Para obtener más información, consulta Referencias del entorno de ejecución.
Recurso de servicio
Es el recurso que se puede escribir en el Registro de agentes, identificado por su propio
nombre de recurso, que
usas para las operaciones de administración cuando registras de forma manual un
agente, un servidor de MCP o un extremo. El recurso
Service almacena los metadatos del componente, incluido el tipo de
componente de agente y los detalles de configuración, como la URL de la interfaz, la descripción, la vinculación del protocolo y la especificación de la capacidad. Un componente registrado automáticamente o una habilidad independiente no usan un recurso Service.
Crea, actualiza o borra un recurso Service para registrar, actualizar metadatos
o cancelar el registro de un componente registrado de forma manual en Agent Registry sin
modificar ni borrar la implementación subyacente. Cuando creas o actualizas un recurso Service,
Agent Registry lee los metadatos y crea o actualiza automáticamente
el recurso de descubrimiento Agent, McpServer o Endpoint
correspondiente. En Agent Registry, los consumidores, como los agentes de organización,
las aplicaciones cliente y los desarrolladores, usan estos recursos de descubrimiento de solo lectura para
enumerar, buscar y ver componentes de agentes. Para obtener más información, consulta
Representación de componentes de agentes en el Registro de agentes.
Habilidad
Compárala con la habilidad de A2A.
Es un paquete independiente registrado como un recurso Skill de nivel superior en
Agent Registry que extiende las capacidades de un agente proporcionando
instrucciones específicas y secuencias de comandos opcionales para completar una tarea. Una habilidad
contiene un archivo de instrucciones SKILL.md, secuencias de comandos opcionales y recursos de
metadatos.
Una habilidad se identifica con un identificador de habilidad con alcance de un publicador y un nombre de recurso estándar. Cada habilidad mantiene un puntero de revisión predeterminado y tiene una o más instantáneas con versiones, cada una representada como una revisión de habilidad.
Para obtener detalles sobre la arquitectura, el empaquetado y el ciclo de vida, consulta Arquitectura de habilidades.
Revisión de habilidades
Es una instantánea inmutable y con control de versiones de un paquete de habilidades, representada como un
recurso SkillRevision en Agent Registry. Una revisión de habilidad te permite actualizar
las instrucciones de la habilidad o las secuencias de comandos opcionales sin cambiar el
identificador de habilidad superior
ni romper las dependencias existentes del agente.
Para obtener más información sobre el control de versiones y la inmutabilidad de las revisiones, consulta Revisiones de habilidades.
Herramienta
Es una función determinística que proporciona un servidor de MCP y que un agente puede invocar.