Registra un agente personalizado del ADK

Agent Registry te permite registrar agentes personalizados que creas con el Kit de desarrollo de agentes (ADK) y alojar en tu propia infraestructura para que otros desarrolladores y agentes de organización puedan descubrirlos. Si expones una tarjeta de agente que cumpla con el protocolo Agent2Agent (A2A) y registras manualmente el extremo del agente, harás que sus habilidades de A2A se puedan descubrir en el registro de agentes.

Antes de comenzar

  1. Configura el Registro de agentes.

  2. Obtén el ID del proyecto para el proyecto de administración en el que está habilitado el Registro de agentes.

  3. Para usar los comandos de Google Cloud CLI en este documento, configura tu entorno de gcloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para registrar agentes de ADK personalizados en el Registro de agentes, pídele a tu administrador que te otorgue el rol de IAM de editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto de administración en el que está habilitado el Registro de agentes. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Extremo de Agent Card

Para que el Registro de agentes pueda indexar las capacidades de tu agente personalizado, este debe exponer sus metadatos y 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 de A2A del ADK para registrar tu agente, el framework puede generar y entregar automáticamente esta tarjeta de agente según la definición de Agent y el tools que proporciones en tu código.

Registra el agente expuesto

Después de implementar el agente del ADK en tu entorno de hosting y de que este entregue correctamente sus extremos de REST, indícale al Registro de agentes que lo descubra.

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

Usa gcloud CLI para registrar el agente con el comando gcloud agent-registry services create, 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 darle a tu agente, por ejemplo, my-custom-agent.
  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación o región del registro.
  • DISPLAY_NAME: Es el nombre legible por humanos de tu agente.

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