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 inmutable y único a nivel global para el agente. Este identificador lógico proporciona una referencia estable para que los consumidores llamen al agente, y permanece constante independientemente de los cambios en la infraestructura subyacente.
El Registro de agentes 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 incluyen algunos ejemplos:
- Vertex AI Agent Engine:
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 manualmente:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Principal del agente
Es el identificador único de IAM asignado a un agente, que le permite tener permisos y ser auditado. Adopta la forma de una cuenta de servicio Google Cloudverificable o una identidad de carga de trabajo administrada, como un ID de SPIFFE, vinculada a un agente o servidor.
Dado 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, el principal de un agente para una implementación de Vertex AI Agent Engine 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
El Registro de agentes muestra esta identidad como un atributo de solo salida cuando consultas los detalles de un agente.
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 completar una tarea.
Proveedor de autorización
Es un parámetro de configuración dentro del 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 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 orquestadores interactúen con las capacidades de nivel inferior. Las vinculaciones también se usan para asociar un agente con un proveedor de autenticación y admitir permisos delegados.
Recurso de datos
Es un contexto de datos o un conjunto de datos específico que expone un servidor de MCP al que puede acceder un agente para fundamentar sus respuestas o informar sus acciones.
Discovery
Proceso de consulta del registro para encontrar agentes o herramientas de MCP existentes según descripciones, etiquetas o habilidades. El descubrimiento por habilidades está disponible para los agentes que exponen sus capacidades a través de una tarjeta de agente, como los que implementan el protocolo Agent2Agent (A2A).
Extremo
En 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 controlar de forma centralizada a qué servicios externos puede acceder un agente.
Protocolo de contexto del modelo (MCP)
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 (o servidor)
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 identificador de recursos uniforme (URN) inmutable y único a nivel global para un servidor de 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 se trata de un servicio integrado de Google o de un servidor externo registrado. A continuación, se incluyen algunos ejemplos:
- Google Cloud Servidores de 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
Proceso de agregar un componente agentic al registro. El registro de agentes proporciona los siguientes mecanismos de registro:
- Registro automático: Es la transferencia automática de cargas de trabajo compatibles, por ejemplo, en Vertex AI Agent Engine. Google Cloud
- Registro manual: Incorporación manual de cargas de trabajo personalizadas o externas
URI de recursos
Es la ubicación o infraestructura de ejecución física que aloja un agente o un 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 recurso puede ser un extremo de Vertex AI, una implementación de GKE o un servicio de Cloud Run.
El URI del recurso difiere del identificador del agente o del identificador del servidor de MCP. Estos valores son los nombres únicos en formato de URN que identifican tus agentes y servidores de MCP en el registro. En cambio, el URI del recurso apunta al recurso de procesamiento real en el que se ejecuta el agente o el servidor.
La ruta de acceso al URI del recurso de un agente está integrada en la cadena principal del agente para identificar de forma única esa carga de trabajo en las políticas de IAM.
El registro de agentes muestra este URI como un atributo de solo salida cuando consultas los detalles de un agente.
Puedes usar el URI del recurso para crear consultas en el gráfico de topología y 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
En el caso de la API de Agent Registry, es el recurso de escritura que se usa para registrar manualmente cargas de trabajo externas o personalizadas en el registro. Un Service representa un agente, un servidor MCP o un extremo que se agrega manualmente a tu registro. Creas y administras un recurso Service para definir el extremo y los metadatos de las cargas de trabajo que Agent Registry no ingiere automáticamente.
Según la especificación que proporciones, el Registro de agentes proyecta automáticamente este Service en el lado del consumidor como un recurso Agent, McpServer o Endpoint de solo lectura para el descubrimiento.
Siempre usas el recurso Service para crear, editar o borrar entradas del registro. Sin embargo, para obtener, enumerar o buscar esas entradas, debes consultar los recursos de solo lectura Agent, McpServer o Endpoint.
Habilidad
Es una capacidad de alto nivel que posee un agente de A2A. Las habilidades se extraen de las tarjetas de agente A2A y sirven como los principales puntos de datos para el descubrimiento de agentes.
Herramienta
Es una función determinística que proporciona un servidor de MCP y que un agente puede invocar.