Registra un agente personalizado del ADK

Si compilas un agente personalizado con el Kit de desarrollo de agentes (ADK) y lo alojas en tu propia infraestructura, puedes hacer que se pueda descubrir en Agent Registry si expones una tarjeta de agente y registras manualmente su extremo.

En este documento, se explica cómo asegurarte de que tu agente del ADK cumpla con el protocolo Agent2Agent (A2A), lo que permite que el registro indexe sus habilidades de A2A.

El extremo de la tarjeta de agente

Para permitir que Agent Registry comprenda las capacidades de tu agente personalizado, este debe exponer sus metadatos y las habilidades de A2A disponibles con el protocolo Agent2Agent (A2A).

La especificación de A2A requiere que los agentes entreguen una tarjeta de agente, que es un documento JSON que describe la identidad y las herramientas del agente, en un extremo específico, por lo general, /.well-known/agent-card.json.

Cuando usas los complementos o módulos específicos del servidor A2A del ADK para registrar tu agente, el framework puede generar y entregar automáticamente esta tarjeta de agente en función de la definición de Agent y las tools que proporcionas en tu código.

Registra el agente expuesto

Después de implementar el agente del ADK en tu entorno de hosting y de que entregue correctamente sus extremos de REST, indica a Agent Registry que lo descubra.

Debido a que las implementaciones personalizadas requieren registro manual, debes crear un recurso Service en el registro. Guarda la tarjeta de agente generada de tu agente como un archivo JSON local, por ejemplo, agent-card.json.

Usa Google Cloud CLI para registrar el agente. Asegúrate de especificar el tipo de especificación a2a-agent-card y sube tu archivo local con la marca --agent-spec-content:

gcloud agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=agent-card.json

El tamaño máximo del archivo de especificación es de 10 KB.

Reemplaza lo siguiente:

  • AGENT_NAME: Es el nombre que deseas asignarle a tu agente, por ejemplo, my-custom-agent.
  • PROJECT_ID: El ID del proyecto
  • LOCATION: La ubicación o región del registro
  • DISPLAY_NAME: El nombre legible de tu agente

Después de crear el recurso Service, Agent Registry analiza la tarjeta de agente, crea un recurso Agent que se puede descubrir y, luego, indexa las habilidades de A2A definidas en tu código de Python del ADK para que otros desarrolladores puedan buscarlas.