Modelo de datos de Agent Registry

Agent Registry categoriza los componentes de agentes de tu ecosistema en cuatro tipos de recursos principales que puedes administrar y descubrir:

  • Agentes: Son actores de IA autónomos que llevan a cabo flujos de trabajo de IA específicos. Un agente comprende sus capacidades de flujo de trabajo porque posee habilidades específicas. En Agent Registry, las habilidades de los agentes se representan como metadatos declarativos (habilidades de A2A) o como un paquete modular y ejecutable (habilidades).
  • Servidores de MCP: Son 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.
  • Endpoints: Son 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.
  • Habilidades: Son paquetes ejecutables y autónomos de instrucciones, código y metadatos que se controlan directamente en Agent Registry. Las habilidades autónomas son distintas de las habilidades de A2A, que son manifiestos de bloques de metadatos declarativos que se declaran en línea dentro de la tarjeta de agente de un agente.

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

Recursos de la API

La API de Agent Registry separa las operaciones de lectura y escritura para agentes, endpoints y servidores de MCP:

  • Recurso de API de escritura: Para administrar estos componentes de agentes, crea, actualiza o borra manualmente un recurso Service en el registro.
  • Recurso de API de solo lectura: Para consultar, enumerar o buscar estos componentes de agentes, solicita el recurso Agent, McpServer o Endpoint de solo lectura a la API de Agent Registry.

Las habilidades autónomas no usan el modelo de Service proyección. En cambio, puedes administrar, controlar la versión y enumerar las habilidades directamente con los recursos de la API Skill, SkillRevision, y Publisher.

Para comenzar, consulta Configura Agent Registry. Para obtener más información sobre la API de Agent Registry, consulta la documentación de referencia de la API.

Registra componentes de agentes 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.

Agent Registry registra automáticamente los agentes y servidores implementados en runtimes compatibles Google Cloud . Para registrar y administrar tus agentes, servidores de MCP y endpoints, habilita la API de Agent Registry. Las habilidades creadas por Google también se muestran de inmediato cuando configuras Agent Registry.

Además, puedes usar el recurso Service para crear, actualizar y borrar entradas de forma manual. Luego, consulta los recursos Agent, McpServer o Endpoint de solo lectura para obtener, enumerar y buscar tus agentes, servidores y endpoints registrados, respectivamente. Para el registro manual y la búsqueda de habilidades, usa el recurso Skill.

Mecanismo de registro Descripción Componente registrado Productos decompatibles Google Cloud
Registro automático Puedes configurar y usar Agent Registry para descubrir y transferir automáticamente recursos específicos implementados en runtimes compatibles Google Cloud . 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 A2A de su tarjeta de agente. Agentes
Servidores de MCP Servidores de MCP oficiales de Google y Google Cloud remotos
Habilidades Las habilidades públicas de Google se pueden descubrir de forma global desde todos los proyectos
Registro manual En el caso de los recursos externos, los componentes de agentes personalizados en runtimes no compatibles o los agentes de REST estándar que no implementan el protocolo A2A, debes registrarlos de forma manual creando un Service resource en el registro. Para las habilidades autónomas, usa el recurso Skill. Agentes Agentes remotos
Servidores de MCP Componentes de agentes personalizados en runtimes no compatibles o servidores de MCP externos
Habilidades Tus propias habilidades independientes

¿Qué sigue?