Modelo de datos de Agent Registry

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

• Agentes: Son actores autónomos de IA que llevan a cabo tareas específicas, invocan herramientas y colaboran con otros agentes.
• 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.
• Habilidades: Son capacidades modulares que extienden lo que puede hacer un agente. El Registro de agentes distingue entre las habilidades independientes, que son paquetes de instrucciones y secuencias de comandos opcionales que se administran directamente en el registro, y las habilidades A2A, que son descripciones de capacidades que se enumeran en la tarjeta de agente de un agente y que les indican a otros agentes cuándo y cómo comunicarse con él.

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 los agentes, los extremos y los servidores de MCP:

• Recurso de API grabable: Estos componentes de agentes se administran creando, actualizando o borrando manualmente un recurso Service en el registro.
• Recurso de API de solo lectura: Para consultar, enumerar o buscar estos componentes de agentes, debes solicitar el recurso de solo lectura Agent, McpServer o Endpoint 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	Recopilación de recursos	Caso de uso	Valores válidos
--agent-spec-type --agent-spec-content	Agent (agents)	Agentes remotos (agentes REST estándar o que cumplen 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 externos del Protocolo de contexto del modelo (MCP)	tool-spec

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

Las habilidades independientes no usan el modelo de proyección Service. En su lugar, puedes administrar, controlar las versiones y enumerar las habilidades directamente con los recursos de la API de Skill, SkillRevision y Publisher.

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

Productos y componentes compatibles

El Registro de agentes categoriza los productos y componentes admitidos según cómo se registran: de forma automática o manual.

Registro automático

Agent Registry descubre y procesa automáticamente lasGoogle Cloud cargas de trabajo compatibles implementadas en tu proyecto. En el caso de los agentes que implementan el protocolo abierto Agent2Agent (A2A), el registro extrae automáticamente sus habilidades y capacidades de A2A de su tarjeta de agente. Las habilidades independientes creadas por Google también se pueden descubrir a nivel mundial cuando configuras el Registro de agentes.

En la siguiente tabla, se enumeran los productos y componentes que Agent Registry registra automáticamente:

Tipo de componente	Productos compatibles
Agentes	Agent Runtime en Gemini Enterprise Agent Platform Google Workspace Gemini Enterprise Implementaciones de Google Kubernetes Engine (GKE) que incluyen una etiqueta de tipo funcional específica Cargas de trabajo de Cloud Run configuradas con una marca de tipo funcional específica
Servidores de MCP	Servidores de MCP oficiales de Google y Google Cloud remotos Implementaciones de Google Kubernetes Engine que incluyen 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 a nivel global desde todos los proyectos.

Registro manual

En el caso de las cargas de trabajo personalizadas, los tiempos de ejecución externos de Cloud, la infraestructura local o los agentes que no implementan el protocolo A2A, debes registrar los componentes de forma manual con el recurso Service grabable. Para las habilidades independientes personalizadas, usa el recurso Skill.

En la siguiente tabla, se enumeran los productos y componentes que registras manualmente:

Tipo de componente	Recursos admitidos
Agentes	Agentes remotos implementados en Compute Engine, Google Kubernetes Engine, Cloud Run, sistemas locales o nubes externas
Servidores de MCP	Componentes de agentes personalizados en tiempos de ejecución no compatibles o servidores de MCP externos
Extremos	APIs de REST o URLs de servicio de destino externas que se rigen como extremos
Habilidades	Tus propias habilidades independientes creadas por tu organización

¿Qué sigue?

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