Registrar un agente lo convierte en un componente detectable en Agent Registry. Cuando publicas las habilidades A2A de tu agente, ayudas a otros desarrolladores y agentes de organización de tu organización a encontrar y reutilizar tu trabajo, lo que acelera el desarrollo general de la IA.
Agent Registry 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 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 Google Cloud 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 de aceptación. El registro automático opera a nivel del proyecto y no descubre automáticamente los agentes implementados en otros Google Cloud proyectos.
El registro automático es compatible con los siguientes Google Cloud entornos de ejecución:
- 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 detectar sin ninguna configuración.
- Google Kubernetes Engine: Los agentes 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 A2A 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 que los agentes declaren sus capacidades e identidad. Si tu agente implementa este protocolo, Agent Registry extrae automáticamente las habilidades A2A 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 A2A. Para proporcionar esta información de modo que tu agente sea detectable, usa el registro manual.
Para obtener información sobre los Google Cloud entornos de ejecución que admiten el registro automático, consulta Usa el registro automático.
Registro manual
Para los agentes alojados en plataformas externas, en entornos locales, en Google Cloud entornos de ejecución que no admiten el descubrimiento automático o en diferentes Google Cloud proyectos, 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: Agentes que implementan la especificación de A2A
(
A2A_AGENT_CARD). El registro analiza su tarjeta de agente (agent-card.json) extremo para indexar sus habilidades A2A. - Agentes REST estándar: Agentes remotos que no implementan la especificación de 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.
Consideraciones sobre el registro entre proyectos
Si tu organización usa una arquitectura de administración centralizada con Agent Gateway, puedes implementar una puerta de enlace de salida de agente a cualquier lugar en un proyecto de administración central y registrar agentes implementados en varios proyectos de radios o cargas de trabajo.
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 central ubique y administre los agentes. Para obtener instrucciones, consulta Registra un agente de otro proyecto.
Integra habilidades independientes
Agent Registry te permite administrar y controlar habilidades independientes
skills para agentes como recursos de nivel superior.
Las habilidades independientes se registran como Skill recursos en tu registro,
lo que permite a los administradores aplicar políticas de acceso detalladas y administrar el historial de versiones
con revisiones de habilidades.
Cuando compilas y administras 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.