Modelo de datos de Agent Registry

Agent Registry clasifica los componentes de agente de tu ecosistema en tres tipos principales que puedes descubrir en tu entorno:

  • Agentes: Actores autónomos que poseen habilidades específicas. Las habilidades representan las capacidades de alto nivel de un agente y son un mecanismo principal para el descubrimiento.
  • Servidores de MCP: Proveedores de recursos de datos y herramientas estandarizados. Las herramientas son funciones deterministas expuestas por un servidor de MCP que los agentes pueden invocar para realizar acciones específicas.
  • Extremos: URLs de destino, por lo general, APIs de REST, a las que accede un agente. Al abstraer estos destinos en recursos administrables, Agent Registry te permite controlar de forma centralizada a qué APIs externas pueden acceder tus agentes.

Para obtener más información sobre estos y otros conceptos que usa Agent Registry, consulta Conceptos clave.

La API de Agent Registry separa las operaciones de lectura y escritura. En Agent Registry, un Service es un recurso de API que se puede escribir y que representa un agente, un servidor de MCP o un extremo que agregas de forma manual a tu registro. Agent Registry también registra automáticamente los agentes y servidores implementados en supportedruntimes. Google Cloud

Para registrar y administrar tus agentes, servidores de MCP y extremos, habilita la API de Agent Registry. Puedes usar el recurso Service que se puede escribir para crear, actualizar y borrar entradas de forma manual en tu registro. Luego, consulta los recursos Agent, McpServer o Endpoint de solo lectura para obtener, enumerar y buscar tus agentes, servidores y extremos registrados, respectivamente.

Para comenzar, consulta Configura Agent Registry.

Registra componentes de agente en tu registro

Agent Registry mantiene tu catálogo de agentes y servidores de MCP a través de dos mecanismos de registro: automático y manual. Usa el recurso Service para crear, actualizar y borrar entradas de forma manual.

Mecanismo de registro Descripción Componente registrado Productos decompatibles Google Cloud
Registro automático Puedes configurar y usar Agent Registry para descubrir y procesar automáticamente recursos específicos implementados en supported Google Cloud runtimes. En el caso de los agentes que implementan el protocolo abierto Agent2Agent (A2A), el registro también extrae automáticamente sus habilidades y capacidades de su tarjeta de agente. Agentes
Servidores de MCP Servidores de MCP oficiales de Google y Google Cloud remotos
Registro manual En el caso de los recursos externos, los componentes de agente personalizados en entornos de ejecución no compatibles o los agentes de REST estándar que no implementan el protocolo A2A debes registrarlos de forma manual creando un Service en el registro. Agentes Agentes remotos
Servidores de MCP Componentes de agente personalizados en entornos de ejecución no compatibles o servidores de MCP externos

¿Qué sigue?