Registrar un agente lo convierte en un componente detectable dentro de Agent Registry. Cuando publicas las habilidades de A2A de tu agente, ayudas a otros desarrolladores y agentes orquestadores de tu organización a encontrar y reutilizar tu trabajo, lo que acelera el desarrollo general de la IA.
El Registro de agentes se integra sin problemas con el protocolo Agent2Agent (A2A) y sus especificaciones. A2A es un estándar abierto que permite que los agentes declaren sus capacidades e identidad. Agent Registry admite las versiones 0.3 y 1.0 de la especificación de A2A. Para obtener más información, consulta el esquema de la tarjeta de agente.
Según los tiempos de ejecución de tu agente, Agent Registry admite dos mecanismos de registro principales: el registro automático y el registro manual.
Selecciona el mecanismo de registro que se adapte a los tiempos de ejecución de tu agente.
Registro automático
Los tiempos de ejecución de Google Cloud compatibles registran tus agentes en Agent Registry dentro del mismo proyecto, ya sea de forma predeterminada o a través de un paso de implementación opcional. El registro automático funciona a nivel del proyecto y no descubre automáticamente los agentes implementados en otros proyectos de Google Cloud.
El registro automático es compatible con los siguientes tiempos de ejecución de Google Cloud :
- Agent Runtime en Gemini Enterprise Agent Platform: Los agentes implementados con el SDK se registran sin configuración adicional. Para obtener más información, consulta Cómo registrar agentes desde Agent Runtime.
- Agentes integrados de Google: Los agentes que Google proporciona directamente, como los agentes de Google Workspace y Gemini Enterprise, se pueden descubrir sin necesidad de configuración. Para obtener más información, consulta Cómo registrar agentes integrados de Google.
- Google Kubernetes Engine: Los agentes alojados en contenedores implementados en Google Kubernetes Engine (GKE) se registran cuando se configuran con la etiqueta de tipo funcional del agente de IA y la anotación de la tarjeta del agente. El controlador de tiempo de ejecución del clúster de GKE ejecuta el análisis de introspección y publica los metadatos en Agent Registry. Para obtener más información, consulta Cómo registrar agentes desde GKE.
- Cloud Run: Los agentes en contenedores implementados en servicios o trabajos de Cloud Run se registran cuando se implementan con las marcas de tipo funcional y de identidad. Cloud Run registra automáticamente el nombre y el tipo del agente (
AGENT) en Agent Registry. Para obtener más información, consulta Cómo registrar agentes desde Cloud Run.
Los metadatos y las capacidades indexados para un agente durante el registro dependen de si el agente implementa el protocolo Agent2Agent (A2A):
- Agentes que implementan el protocolo A2A: El sistema consulta la tarjeta de agente (
/.well-known/agent-card.json) del agente para extraer automáticamente sus habilidades A2A y capacidades anunciadas en el catálogo del registro. - Agentes que no implementan el protocolo A2A (extremos estándar de REST o gRPC): El Registro de agentes registra el agente, pero no puede capturar automáticamente metadatos, como la URL del extremo, la identidad del agente y las habilidades de A2A. Para asociar capacidades con agentes que no son de A2A, usa el registro manual o registra habilidades.
Para obtener información sobre los Google Cloud tiempos de ejecución que admiten el registro automático, consulta Cómo usar el registro automático.
Registro manual
En el caso de los agentes alojados en plataformas externas, en las instalaciones, en tiempos de ejecución de Google Cloudque no admiten el descubrimiento automático o en diferentes proyectos deGoogle Cloud , debes usar el registro manual.
Para registrar un agente de forma manual, usa la API de Agent Registry, Google Cloud CLI o Terraform para crear un recurso Service que defina el extremo y la configuración del agente. Este recurso Service grabable también contiene los detalles específicos del agente. Después de crear el Service, el registro genera un recurso Agent de solo lectura que puedes usar para el descubrimiento.
Puedes registrar manualmente dos tipos de agentes:
- Agentes compatibles con A2A: Son agentes que implementan la especificación de A2A (
A2A_AGENT_CARD). El registro analiza su extremo de tarjeta de agente (agent-card.json) para indexar sus habilidades de A2A. - Agentes de REST estándar: Son agentes remotos que no implementan la especificación de A2A (
NO_SPEC), como un extremo de API de REST estándar.
Para obtener información sobre cómo registrar agentes de forma manual, consulta Usa el registro manual.
Consideraciones para el registro entre proyectos
Si tu organización usa una arquitectura de gobernanza centralizada con Agent Gateway, puedes implementar una puerta de enlace de salida de Agent-to-Anywhere en un proyecto de gobernanza central y registrar agentes implementados en varios proyectos de carga de trabajo o radiales.
Dado que el registro automático solo descubre recursos en el proyecto local, debes registrar manualmente los agentes remotos en el registro del proyecto de administración central. El registro entre proyectos permite que la puerta de enlace centralizada ubique y controle los agentes. Para obtener instrucciones, consulta Cómo registrar un agente desde otro proyecto.
Integra habilidades independientes
Agent Registry te permite administrar y controlar habilidades independientes para agentes como recursos de nivel superior.
Las habilidades independientes se registran como recursos Skill en tu registro, lo que permite que los administradores apliquen políticas de acceso detalladas y administren el historial de versiones con revisiones de habilidades.
Cuando crees y administres agentes en Gemini Enterprise, puedes hacer referencia a estas habilidades registradas para ampliar las capacidades de tu agente. Para obtener información sobre cómo registrar y administrar habilidades independientes, consulta Registra habilidades y Administra habilidades.