Modelo de datos de Agent Registry

Agent Registry organiza tu ecosistema de IA en recursos estandarizados para que puedas registrar, descubrir y controlar agentes, servidores de MCP, endpoints y habilidades. Comprender cómo el Registro de agentes separa los recursos Service de escritura de los recursos de descubrimiento de solo lectura, y qué productos admiten el registro automático y manual, te ayuda a diseñar y administrar tu registro.

Componentes de agentes

Agent Registry te permite registrar, descubrir y administrar los siguientes tipos de componentes de agentes:

• Agentes: Son actores de IA autónomos que realizan tareas específicas, invocan herramientas y colaboran con otros agentes.
• Servidores de MCP: Son programas que implementan el Protocolo de contexto del modelo (MCP) para exponer recursos y herramientas de datos estandarizados. Las herramientas son funciones determinísticas que expone un servidor de MCP y que los agentes pueden invocar para realizar acciones específicas.
• Extremos: Son las URLs de destino, por lo general, APIs de REST, a las que accede un agente. Cuando abstrae estos destinos en recursos administrables, el Registro de agentes te permite controlar de forma centralizada a qué APIs externas pueden acceder tus agentes.
• Habilidades: Son capacidades modulares que amplían lo que puede hacer un agente. Las habilidades independientes son paquetes de instrucciones y secuencias de comandos opcionales que se rigen directamente en el registro. Las habilidades de A2A son descripciones de capacidades en la tarjeta de agente de un agente que les indican a otros agentes cuándo y cómo comunicarse con él. Para obtener más información, consulta Arquitectura de habilidades.

Recursos de Service y de descubrimiento

La forma en que el Registro de agentes representa un componente depende de su tipo de componente y modelo de registro. Para obtener más información sobre los ciclos de vida y el descubrimiento de componentes, consulta Ciclo de vida y descubrimiento de componentes.

Agentes, servidores de MCP y endpoints

Independientemente de si un agente, un servidor de MCP o un endpoint se registran de forma automática o manual, Agent Registry lo representa como un recurso de descubrimiento Agent, McpServer o Endpoint de solo lectura. Los consumidores, como los agentes de organización, las aplicaciones cliente y los desarrolladores, usan estos recursos de descubrimiento para enumerar, buscar y ver los componentes registrados.

En el caso de los componentes registrados automáticamente, Agent Registry transfiere los metadatos directamente desde los entornos de ejecución compatibles y crea el recurso de descubrimiento sin un recurso Service.

Cuando registras manualmente un agente, un servidor de MCP o un extremo, Agent Registry separa las operaciones de administración del descubrimiento de componentes creando los siguientes elementos:

• Un recurso Service de escritura: Almacena los metadatos del componente, incluido el tipo de componente de agente, su URL de interfaz, descripción, vinculación de protocolo y especificación de capacidad. Creas, actualizas o borras el recurso Service para operaciones de administración, como actualizar metadatos o cancelar el registro del componente, sin modificar ni borrar la implementación subyacente.
• Un recurso de descubrimiento: Cuando creas o actualizas un recurso Service, Agent Registry lee los metadatos y crea o actualiza automáticamente un recurso de descubrimiento Agent, McpServer o Endpoint que representa el componente en tu registro.

Las marcas de especificación que usas cuando creas un recurso 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	Recurso Agent en la colección agents	Agentes remotos compatibles con A2A o REST estándar	a2a-agent-card, no-spec
--endpoint-spec-type --endpoint-spec-content	Recurso Endpoint en la colección endpoints	APIs de REST de destino externas o URLs de servicio	no-spec
--mcp-server-spec-type --mcp-server-spec-content	Recurso McpServer en la colección mcp-servers	Servidores externos del Protocolo de contexto del modelo (MCP)	tool-spec, no-spec

Estos pares de marcas son mutuamente excluyentes. Si especificas marcas de más de un par, se mostrará un error. Si especificas el par de marcas para el tipo de componente incorrecto, el Registro de agentes crea el recurso de descubrimiento en la colección que coincide con la marca que especificaste. Por ejemplo, pasar --agent-spec-type=no-spec cuando se registra un extremo crea un recurso Agent en lugar de un recurso Endpoint, por lo que las consultas específicas del tipo y las políticas de administración no se aplicarán como se espera.

Habilidades independientes

Las habilidades independientes no usan recursos Service separados. En su lugar, registras, creas versiones y consultas habilidades directamente con recursos Skill de nivel superior, recursos SkillRevision secundarios y recursos 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 compatibles según cómo se registran: de forma automática o manual.

Registro automático

El registro de agentes descubre y transfiere automáticamente las cargas de trabajo deGoogle Cloud compatibles que se implementan en tu proyecto. Para 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 administradas por Google también se pueden descubrir en todos los proyectos 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 remotos de Google y Google Cloud Implementaciones de GKE 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 administradas por Google se pueden descubrir desde todos los proyectos.

Registro manual

Para los componentes remotos, que son agentes, servidores de MCP o extremos alojados fuera de tu proyecto de administración en proyectos de Google Cloud independientes, infraestructura local o nubes externas, debes registrar los componentes de forma manual en el proyecto de administración con un recurso Service. También usas un recurso Service para registrar de forma manual componentes en entornos de ejecución o agentes no compatibles que no implementan el protocolo A2A. Para las habilidades independientes personalizadas, usa un recurso Skill.

En la siguiente tabla, se enumeran los productos y componentes que registras de forma manual:

Tipo de componente	Recursos admitidos
Agentes	Agentes remotos implementados en Compute Engine, GKE, Cloud Run, sistemas locales o nubes externas
Servidores de MCP	Componentes de agentes personalizados en entornos de ejecución no compatibles o servidores de MCP externos
Extremos	APIs de REST de destino externas o URLs de servicio administradas 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 Identidad e identificadores.
• Obtén más información sobre el ciclo de vida y el descubrimiento de componentes.
• Obtén más información sobre la arquitectura de las habilidades.
• Configura el Registro de agentes.
• Obtén información sobre la diferencia entre el registro automático y el manual.