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 en un solo proyecto o en un límite de administración. Comprender cómo el Registro de agentes separa los recursos de Service de escritura de los recursos de descubrimiento de solo lectura, asigna permisos a los recursos en todos los proyectos y admite 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.

Modelo de datos entre proyectos

Cuando configuras un límite de administración, Agent Registry centraliza el descubrimiento y la administración en todos los proyectos miembros desde tu proyecto de administración.

Cuando consultas, enumeras o buscas recursos desde el proyecto de administración, Agent Registry aplica las siguientes reglas de alcance para proporcionar un catálogo consolidado sin duplicar recursos ni crear colisiones de extremos:

Categoría del recurso Alcance en un límite de administración Descripción
Recursos descubiertos automáticamente Agregados de proyectos miembros Los agentes y los servidores de MCP que se descubren automáticamente en los proyectos miembros se agregan a la vista del proyecto de administración cuando los enumeras o los buscas en una ubicación del proyecto de administración. Cuando ves, enumeras o buscas un agente o servidor de MCP, puedes especificar el ID del proyecto de administración o el ID del proyecto miembro en la solicitud. El nombre del recurso conserva el ID que el Registro de agentes asigna al componente y usa el proyecto especificado en la solicitud.
Recursos registrados de forma manual Se limitan al proyecto en el que se crean. Los agentes personalizados, los servidores de MCP externos y los endpoints registrados de forma manual como recursos de Service tienen como alcance el proyecto en el que se crean. Créalas en el proyecto de administración para que sean visibles en todo el límite de administración, o en un proyecto miembro para que sean visibles solo dentro de ese proyecto.
Vinculaciones Se limitan al proyecto en el que se crean. Los recursos de Binding se limitan al proyecto en el que se crean. Créalas en el proyecto de administración para obtener visibilidad en todo el límite o en un proyecto miembro para obtener visibilidad de un solo proyecto.
Habilidades y publicadores independientes Se limitan al proyecto en el que se crean. Los recursos personalizados independientes Skill, SkillRevision y Publisher se limitan al proyecto en el que se crean y no se agregan de los proyectos miembros al proyecto de administración. Las habilidades independientes administradas por Google se pueden descubrir en todos los proyectos automáticamente cuando configuras el Registro de agentes.
Aplicaciones de IA Se limitan al proyecto en el que se crean. Los recursos de solo lectura de AiApplication y sus vistas de componentes vinculadas tienen como alcance el proyecto y la ubicación en los que se creó la aplicación.

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

Agent Registry descubre y transfiere automáticamente las cargas de trabajo deGoogle Cloud compatibles que se implementan en tu proyecto o en los proyectos miembros de tu límite de administración. 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 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
Servidores de MCP
Habilidades Las habilidades administradas por Google se pueden descubrir desde todos los proyectos.

Registro manual

Los componentes remotos son agentes, servidores de MCP o extremos alojados fuera de tu proyecto de administración o límite de administración, como en proyectos de Google Cloud independientes sin un límite, infraestructura local o nubes externas. Registras manualmente esos componentes remotos en el proyecto de administración con un recurso Service. También puedes usar un recurso Service para registrar manualmente componentes en entornos de ejecución no compatibles o para agentes que no implementan el protocolo A2A. Para las habilidades independientes personalizadas, usas 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?