En este documento, se explican los términos y conceptos clave relacionados con Agent Registry.
Habilidad A2A
Comparación con habilidades.
Es un bloque de metadatos de capacidad declarativa representado en línea dentro de la tarjeta de agente
Agent Card
(agent-card.json) de un agente. Las habilidades A2A describen las interfaces de comunicación de agente a agente
y las capacidades de alto nivel que posee un agente compatible con A2A agent.
Agent Registry admite las versiones 0.3 y 1.0 de la especificación Agent2Agent (A2A).
Agente
Es un actor autónomo en tu ecosistema de IA, definido por su identificador y las habilidades A2A o habilidades específicas que posee.
Identificador del agente
Es un nombre inmutable y único a nivel global para el agente. Este identificador lógico proporciona una referencia estable para que los consumidores llamen al agente, que permanece constante independientemente de los cambios en la infraestructura subyacente.
Agent Registry genera automáticamente los identificadores de agente durante la transferencia y sigue un formato de nombre de recurso uniforme (URN). El formato exacto depende de dónde se implemente el agente. Estos son algunos ejemplos:
- Agent Runtime en Gemini Enterprise Agent Platform:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Servicios de Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - Implementaciones de GKE:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Agentes registrados de forma manual:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Principal del agente
Es el identificador único de Identity and Access Management (IAM) asignado a un agente, lo que le permite tener permisos y auditarse. Toma la forma de una cuenta de servicio verificable Google Cloud o una identidad de carga de trabajo administrada, como un ID de SPIFFE, vinculada a un agente o servidor.
Debido a que esta identidad está vinculada directamente al recurso de procesamiento del tiempo de ejecución del agente, la cadena principal incorpora la ruta de acceso exacta a ese recurso subyacente. Por ejemplo, un principal de agente para un tiempo de ejecución de agente en una implementación de Gemini Enterprise Agent Platform se ve de la siguiente manera:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Agent Registry muestra esta identidad como un atributo de solo salida cuando ves los detalles de un 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 clasifica los componentes de agente en cuatro tipos principales: agentes, servidores MCP, extremos, y habilidades.
Flujo de trabajo de agente
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 realizar una tarea.
Proveedor de Auth
Es una configuración dentro de l administrador de autenticación de identidad del agente para almacenar, adquirir y administrar credenciales, como claves de API o tokens de OAuth, para conectar tu agente a herramientas y aplicaciones externas específicas, y definir el tipo de autenticación.
Vinculación
Es una conexión entre un agente de origen agent y un recurso de destino, como otro agente, un servidor de MCP, o un extremo. Cuando creas vinculaciones, estableces relaciones explícitas que permiten que tus agentes de orquestador interactúen con las capacidades descendentes. Las vinculaciones también se usan para asociar un agente con un proveedor de autorización para admitir permisos delegados.
Recurso de datos
Es un contexto o conjunto de datos específico expuesto por un servidor de MCP al que un agente puede acceder para fundamentar sus respuestas o informar sus acciones.
Discovery
Es el proceso de consultar el registro para encontrar agentes, herramientas de MCP o extremos en función de descripciones, etiquetas o habilidades.
Discovery en Agent Registry se enfoca en las capacidades centradas en el consumo que pueden usar tus orquestadores de IA. Descubres las capacidades ya registradas para compilar y orquestar sistemas de IA.
Este proceso en Agent Registry difiere de la detección de infraestructura, como en App Hub, que identifica recursos de procesamiento no registrados en tus Google Cloud proyectos.
Extremo
Para la API de Agent Registry, es un recurso que representa una URL de destino, por lo general, una API de REST, a la que accede un agente. Al abstraer estos destinos en recursos administrables, Agent Registry te permite administrar de forma centralizada a qué servicios externos puede acceder un agente.
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, y que reemplaza los complementos personalizados.
Servidor de MCP (o servidor)
Es un servicio que implementa el Protocolo de contexto del modelo (MCP) para proporcionar herramientas y recursos de datos estandarizados a los agentes de IA.
Identificador del servidor de MCP
Es un nombre de recurso uniforme (URN) inmutable y único a nivel global para un servidor de MCP. Al igual que los identificadores de agente, este nombre proporciona una referencia estable para descubrir conjuntos de herramientas específicos.
El formato depende de si es un servicio integrado de Google o un servidor externo registrado. Estos son algunos ejemplos:
- Google Cloud Servidores de MCP remotos:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Servidores de MCP registrados de forma manual:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
Registro
Es el proceso de agregar un componente de agente, como un agente, un servidor de MCP o un extremo, al registro. Agent Registry proporciona los siguientes mecanismos de registro:
- Registro automático: Transferencia automática de recursos de Google Cloud IA compatibles, como en Agent Runtime. El registro automático opera dentro del alcance de un solo proyecto.
- Registro manual: Incorporación manual de componentes de agente personalizados o externos, o agentes implementados en varios Google Cloud proyectos para la detección y administración centralizadas.
URI de recursos
Es la ubicación o infraestructura física del tiempo de ejecución que aloja un agente o servidor de MCP. El identificador de recursos uniforme (URI) es la secuencia única de caracteres que identifica este recurso de tiempo de ejecución. Por ejemplo, un URI de recursos puede ser un extremo de Agent Runtime, una implementación de Google Kubernetes Engine (GKE) o un servicio de Cloud Run.
El URI de recursos difiere del identificador de agente o identificador del servidor de MCP. Estos valores son los nombres únicos en formato URN que identifican tus agentes y servidores de MCP en el registro. Por el contrario, el URI de recursos apunta al recurso de procesamiento real en el que se ejecuta el agente o el servidor.
La ruta de acceso al URI de recursos de un agente está integrada en la cadena principal del agente para identificar de forma única ese recurso en las políticas de IAM. Para los registros entre proyectos, el URI de recursos hace referencia al proyecto en el que reside el recurso de procesamiento.
Agent Registry muestra este URI como un atributo de solo salida cuando tú ves los detalles de un agente.
Puedes usar el URI de recursos para compilar consultas en el gráfico
detopología
para visualizar los flujos de tráfico y las relaciones de agentes específicos. En la API de Agent Registry, este valor se representa con el atributo agentregistry.googleapis.com/system/RuntimeReference.
Servicio
Para la API de Agent Registry, es el recurso de escritura que se usa para registrar de forma manual componentes de agente personalizados o
externos agenticos en el registro. Un Service representa un agente, un servidor de MCP o un extremo que se agrega de forma manual a tu registro. Creas y administras un recurso Service para definir el extremo y los metadatos de los componentes de agente que Agent Registry no transfiere automáticamente.
Según la especificación que proporciones, Agent Registry proyecta automáticamente este Service en el lado del consumidor como un recurso Agent, McpServer o Endpoint de solo lectura para la detección.
Siempre usas el recurso Service para crear, editar o borrar entradas de registro. Sin embargo, para obtener, enumerar o buscar esas entradas, debes consultar los recursos Agent, McpServer o Endpoint de solo lectura.
Habilidad
Comparación con habilidades A2A.
Es un paquete ejecutable independiente registrado como un recurso de nivel superior en
Agent Registry que extiende las capacidades de un agente proporcionando instrucciones, lenguaje natural o código específicos para completar una tarea.
Las habilidades contienen archivos de instrucciones (SKILL.md), secuencias de comandos de ejecución de tiempo de ejecución y recursos de metadatos.
Las habilidades se identifican con un nombre de recurso uniforme (URN). El formato exacto depende del publicador. Estos son algunos ejemplos:
- Habilidades creadas por Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Por ejemplo,urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Habilidades registradas de forma manual:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Por ejemplo,urn:skill:projects-123456789:locations:global:private-create-docs.
Las habilidades creadas por Google son visibles de inmediato cuando configuras Agent Registry. Sin embargo, también puedes registrar tus propias habilidades. Registras habilidades en Agent Registry como recursos hermanos de agentes y servidores de MCP. Cada habilidad tiene una revisión predeterminada y puede contener varias revisiones de habilidades con versiones.
Los administradores de la plataforma administran las habilidades mediante la administración de sus estados del ciclo de vida y el establecimiento de punteros de versión predeterminados para la resolución del tiempo de ejecución.
Revisión de habilidades
Es una instantánea inmutable y con versiones de un paquete de habilidades. Las revisiones te permiten actualizar las instrucciones o el código de las habilidades sin cambiar el identificador de la habilidad superior.
Puedes administrar las revisiones de habilidades para permitir el control de versiones de tus habilidades.
Publisher
Es una entidad que crea y registra habilidades en Agent Registry.
Los publicadores precompletados incluyen publicadores de Google, como cloud.google.com y discoveryengine.googleapis.com, y socios verificados. Las habilidades creadas por Google de estos publicadores son visibles de inmediato cuando configuras Agent Registry.
Las habilidades que creas se asignan automáticamente al private
publicador predeterminado, por lo que el ID publicado de una habilidad en particular tiene el prefijo
private-. No puedes registrar recursos de publicadores personalizados.
Revisa e inspecciona los detalles del publicador de tus habilidades registradas.
Herramienta
Es una función determinista que proporciona un servidor de MCP que un agente puede invocar.