Registrar un agente lo convierte en un servicio detectable. Cuando publicas las habilidades de tu agente, ayudas a otros desarrolladores y agentes de orquestación de tu organización a encontrar y reutilizar tu trabajo, lo que acelera el desarrollo general de la IA.
Según los entornos de ejecución de tu agente, Agent Registry 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 entornos de ejecución de tu agente.
Registro automático
Los entornos de ejecución compatibles registran tus agentes en Agent Registry de forma predeterminada o a través de un paso de implementación de participación. Google Cloud
El registro automático es compatible con los siguientes Google Cloud entornos de ejecución:
- Vertex AI Agent Engine: 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 detectar sin ninguna configuración.
- Google Kubernetes Engine: Los agentes en contenedores implementados en GKE se registran cuando incluyen una anotación 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 Agent2Agent (A2A): A2A es un estándar abierto que permite a los agentes declarar sus capacidades e identidad. Si tu agente implementa este protocolo, Agent Registry extrae automáticamente las habilidades del agente de su tarjeta de agente y propaga 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 de modo que tu agente sea detectable, usa el registro manual.
Para obtener información sobre los entornos de ejecución que admiten el registro automático, consulta Usa el registro automático. Google Cloud
Registro manual
Para los agentes alojados en plataformas externas, en las instalaciones o en Google Cloud entornos de ejecución que no admiten la detección automática, debes usar el registro manual.
Para registrar un agente de forma manual, usa la API de Agent Registry para crear un recurso Service que defina el extremo y la configuración del agente. Este recurso 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 la detección.
Puedes registrar manualmente dos tipos de agentes:
- Agentes compatibles con A2A: Agentes que implementan la
especificación Agent2Agent (A2A)
(
A2A_AGENT_CARD). El registro analiza su extremo de tarjeta de agente (agent-card.json) para indexar sus habilidades. - Agentes REST estándar: Agentes remotos que no implementan la especificación A2A (
NO_SPEC), como un extremo de API de REST estándar.
Para aprender a registrar agentes de forma manual, consulta Usa el registro manual.