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 agente durante la ingesta y sigue un formato de nombre de recurso uniforme (URN). El formato exacto depende de dónde se implemente el agente. Los siguientes son 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 de forma manual:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Principal del agente
Es el identificador único de 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 entorno 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 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
Agent Registry muestra esta identidad como un atributo de solo salida cuando ves los detalles de un agente.
Flujo de trabajo con 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 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 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 autenticació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 o herramientas de MCP existentes en función de descripciones, etiquetas o habilidades. La detección 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
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 controlar 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 estandarizadas y recursos de datos a los agentes de IA .
Identificador del servidor de MCP
Es un nombre de recurso uniforme (URN) global único e inmutable 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. Los siguientes son ejemplos:
- Google Cloud Servidores de MCP remotos:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVICE_NAME - Servidores de MCP registrados de forma manual:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Registro
Es el proceso de agregar un servicio al registro. Agent Registry proporciona los siguientes mecanismos de registro:
- Registro automático: Ingesta automática de cargas de trabajo compatibles Google Cloud, por ejemplo, en Vertex AI Agent Engine.
- Registro manual: Incorporación manual de cargas de trabajo externas o personalizadas.
URI de recursos
Es la ubicación o infraestructura física del entorno de ejecución 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 del entorno de ejecución. Por ejemplo, un URI de recursos puede ser un extremo de Vertex AI, una implementación de 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 esa carga de trabajo en las políticas de IAM.
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
de topologí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 cargas de trabajo externas o personalizadas en el registro. Un servicio 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 las cargas de trabajo que Agent Registry no ingiere automáticamente.
Según la especificación que proporciones, Agent Registry proyecta automáticamente este servicio 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 A2A agent. Las habilidades se extraen de las tarjetas de agente A2A y sirven como los puntos de datos principales para la detección de agentes .
Herramienta
Es una función determinista que proporciona un servidor de MCP y que un agente puede invocar.