Modelo de datos de Agent Registry

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

  • Agentes: Son 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: Son proveedores de recursos de datos y herramientas estandarizados. Las herramientas son funciones determinísticas 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 grabable que representa un agente, un servidor de MCP o un extremo que agregas manualmente a tu registro. El Registro de agentes también registra automáticamente los agentes y servidores implementados en los tiempos de ejecución Google Cloud compatibles.

Habilita la API de Agent Registry para registrar y administrar tus agentes, servidores de MCP y extremos. Puedes usar el recurso Service grabable para crear, actualizar y borrar manualmente entradas en tu registro. Luego, consulta los recursos de solo lectura Agent, McpServer o Endpoint para obtener, enumerar y buscar tus agentes, servidores y extremos registrados, respectivamente.

Para comenzar, consulta Configura el Registro de agentes.

Cómo registrar componentes agenticos 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 de Google Cloud compatibles
Registro automático Puedes configurar y usar Agent Registry para descubrir y, luego, transferir automáticamente recursos específicos implementados en tiempos de ejecución de Google Cloud compatibles. 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 agenticos personalizados en tiempos de ejecución no compatibles o los agentes REST estándar que no implementan el protocolo A2A, debes registrarlos manualmente creando un recurso Service en el registro. Agentes Agentes remotos
Servidores de MCP Componentes de agentes personalizados en tiempos de ejecución no compatibles o servidores de MCP externos

¿Qué sigue?