En este documento, se explican los términos y conceptos clave relacionados con Agent Registry.
Agente
Es un actor autónomo en tu ecosistema de IA, definido por su identificador y las habilidades específicas que posee.
Identificador del agente
Es un nombre global único e inmutable 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 agentes durante la transferencia y sigue un formato de nombre de recurso uniforme (URN). El formato exacto depende de dónde se implemente el agente. A continuación, se muestran 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, 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 la 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 tres tipos principales: agentes, servidores MCP y extremos.
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 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 autenticación para admitir permisos delegados.
Recurso de datos
Es un contexto o conjunto de datos específico expuesto por un servidor 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 MCP o extremos existentes en función de descripciones, etiquetas o habilidades.
Discovery en Agent Registry se centra 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 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 MCP
Es un nombre de recurso uniforme (URN) global único e inmutable para un servidor MCP. Al igual que los identificadores de agentes, 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. A continuación, se muestran algunos ejemplos:
- Google Cloud Servidores MCP remotos:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Servidores 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 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.
- Registro manual: Incorporación manual de componentes de agente externos o personalizados.
URI de recursos
Es la ubicación o infraestructura física del tiempo de ejecución que aloja un agente o servidor 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 del agente o identificador del servidor MCP. Estos valores son los nombres únicos en formato URN que identifican tus agentes y servidores 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.
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 está representado por 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 externos o
personalizados en el registro. Un Service representa un agente, un servidor 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
Es una capacidad de alto nivel que posee un agente. Las habilidades se extraen
de las tarjetas de agente de Agent2Agent (A2A) y sirven como los puntos de datos principales para la detección de agentes .
Agent Registry admite las versiones 0.3 y 1.0 de la especificación de A2A.
Herramienta
Es una función determinista que proporciona un servidor MCP y que un agente puede invocar.