Enregistrer un agent ADK personnalisé

Si vous créez un agent personnalisé à l'aide d' Agent Development Kit (ADK) et que vous l'hébergez sur votre propre infrastructure, vous pouvez le rendre détectable dans Agent Registry en exposant une carte d'agent et en enregistrant manuellement son point de terminaison.

Ce document explique comment vous assurer que votre agent ADK est conforme au protocole Agent2Agent (A2A), ce qui permet au registre d'indexer ses compétences.

Point de terminaison de la carte d'agent

Pour permettre à Agent Registry de comprendre les capacités de votre agent personnalisé, l' agent doit exposer ses métadonnées et ses compétences disponibles à l'aide du protocole Agent2Agent (A2A).

La spécification A2A exige que les agents diffusent une carte d'agent, qui est un JSON document décrivant l'identité et les outils de l'agent, à un point de terminaison spécifique, généralement /.well-known/agent-card.json.

Lorsque vous utilisez les plug-ins ou modules de serveur A2A spécifiques de l'ADK pour enregistrer votre agent, le framework peut générer et diffuser automatiquement cette carte d'agent en fonction de la définition Agent et des tools que vous fournissez dans votre code.

Enregistrer l'agent exposé

Une fois que vous avez déployé l'agent ADK dans votre environnement d'hébergement et qu'il diffuse correctement ses points de terminaison REST, demandez à Agent Registry de le détecter.

Étant donné que les déploiements personnalisés nécessitent un enregistrement manuel, vous créez une ressource Service dans le registre. Enregistrez la carte d'agent générée de votre agent en tant que fichier JSON local, par exemple agent-card.json.

Utilisez Google Cloud CLI pour enregistrer l'agent, en veillant à spécifier le type de spécification a2a-agent-card, puis importez votre fichier local à l'aide du flag --agent-spec-content :

gcloud alpha 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

La taille maximale du fichier de spécification est de 10 Ko.

Remplacez les éléments suivants :

  • AGENT_NAME: nom que vous souhaitez attribuer à votre agent, par exemple my-custom-agent.
  • PROJECT_ID : ID du projet.
  • LOCATION : emplacement ou région du registre.
  • DISPLAY_NAME : nom lisible de votre agent.

Une fois la ressource Service créée, Agent Registry analyse la carte d'agent, crée une ressource Agent détectable et indexe les compétences définies dans votre code Python ADK afin que d'autres développeurs puissent les rechercher.