Registrar un agente lo convierte en un componente detectable en Agent Registry. Cuando publicas las habilidades 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. El Registro de agentes 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, el Registro de agentes admite dos mecanismos de registro principales: el registro automático y el registro manual.
Este documento te ayuda a elegir el mecanismo de registro que se adapta 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 el Registro de agentes de forma predeterminada o a través de un paso de implementación opcional.
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.
- 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.
- Google Kubernetes Engine: Los agentes alojados en contenedores implementados en Google Kubernetes Engine (GKE) se registran cuando incluyen una etiqueta de tipo funcional específica de Agent Registry.
Los metadatos y las habilidades de un agente capturados durante su registro dependen del protocolo del agente:
- Agentes que implementan el protocolo A2A: Si tu agente implementa el protocolo A2A, el Registro de agentes extrae automáticamente las habilidades del agente de su tarjeta de agente y completa el registro.
- Agentes que no implementan el protocolo A2A: Agent Registry registra el agente, pero no puede capturar automáticamente metadatos como la URL de inferencia y las habilidades. Para proporcionar esta información y que se pueda encontrar a tu agente, usa el registro manual.
Para obtener información sobre los tiempos de ejecución que admiten el registro automático, consulta Cómo usar el registro automático. Google Cloud
Registro manual
En el caso de los agentes alojados en plataformas externas, de forma local o en tiempos de ejecución de Google Cloudque no admiten el descubrimiento automático, 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. - 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.