Modelo de datos de Agent Registry

Agent Registry categoriza los componentes de agentes de tu ecosistema en cuatro tipos principales de recursos 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 A2A) o como un paquete modular y ejecutable (habilidades).
• Servidores 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 independientes de instrucciones, código y metadatos que se administran directamente en Agent Registry. Las habilidades independientes son distintas de las habilidades 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 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 marcas de especificación que usas cuando creas un Service determinan la colección de recursos de solo lectura resultante:

Marcas	Colección de recursos	Caso de uso	Valores válidos
--agent-spec-type --agent-spec-content	Agent (agents)	Agentes remotos (agentes REST estándar o compatibles con A2A)	a2a-agent-card, no-spec
--endpoint-spec-type --endpoint-spec-content	Endpoint (endpoints)	URLs de servicio o APIs de REST de destino externas	no-spec
--mcp-server-spec-type --mcp-server-spec-content	McpServer (mcp-servers)	Servidores del Protocolo de contexto del modelo (MCP) externos	tool-spec

Estos pares de marcas se excluyen mutuamente. Si especificas marcas no válidas, tu recurso se crea en la colección incorrecta y es posible que no funcione con políticas específicas del tipo.

Las habilidades independientes no usan el modelo de Service proyección. En cambio, puedes administrar, controlar las versiones 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 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 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 A2A de su tarjeta de agente.	Agentes	Agent Runtime en Gemini Enterprise Agent Platform Google Workspace Gemini Enterprise Implementaciones de Google Kubernetes Engine (GKE) incluida una etiqueta de tipo funcional específica Cargas de trabajo de Cloud Run configuradas con una marca de tipo funcional específica
		Servidores MCP	Servidores MCP remotos y oficiales de Google Google Cloud Implementaciones de Google Kubernetes Engine incluida una etiqueta de tipo funcional específica Servicios de Cloud Run configurados con una marca de tipo funcional específica
		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 REST estándar que no implementan el protocolo A2A, debes registrarlos de forma manual creando un recurso Service en el registro. Para las habilidades independientes, usa el recurso Skill.	Agentes	Agentes remotos
		Servidores MCP	Componentes de agentes personalizados en runtimes no compatibles o servidores MCP externos
		Habilidades	Tus propias habilidades independientes

¿Qué sigue?

• Revisa los conceptos clave para familiarizarte con los términos esenciales que se usan en Agent Registry.
• Configura Agent Registry.
• Obtén más información sobre la diferencia entre el registro automático y manual para los agentes.