Dans l'article 1, l'agent GAM tournait en local et la connexion OAuth était prouvée. Place à l'étape qui le rend utile à d'autres agents : le déployer dans le cloud et le rendre découvrable en A2A.
Déployer sur Vertex Agent Engine
Une seule commande empaquette l'agent et crée une ressource reasoningEngine dans Vertex AI Agent Engine (Agent Platform) :
adk deploy agent_engine \
--project=PROJECT_ID --region=us-central1 \
gam_sentinel⚙️ Deux pièges qui font perdre du temps : installer google-cloud-aiplatform[agent_engines] (pour vertexai), et épingler opentelemetry==1.42.1 (les versions plus récentes cassent l'ADK).
L'auth managée (connecteur Agent Identity)
Un agent déployé ne peut pas ouvrir un navigateur pour consentir. La voie propre est l'Agent Identity Auth Manager : un connecteur OAuth 3LO managé par Google. L'utilisateur consent une fois (dans le navigateur), Google stocke et rafraîchit les jetons et les injecte à l'agent — aucun code de refresh à écrire.
Tant qu'aucun utilisateur n'a consenti via le connecteur, l'agent renvoie Failed to retrieve credential. C'est normal — la preuve que le runtime fonctionne et que la porte d'entrée est l'autorisation utilisateur, pas un secret d'agent.
Agent Card + Agent Registry
Le déploiement sert l'Agent Card (/.well-known/agent-card.json, vue à
l'article 1) et enregistre l'agent dans l'Agent Registry — l'annuaire des
agents découvrables — en type CUSTOM. À partir de là, n'importe quel autre agent
peut le retrouver et lui déléguer une tâche.
L'orchestrateur : découvrir puis déléguer
C'est le vrai moment « A2A ». Un orchestrateur (1) découvre l'agent GAM via
une recherche dans le registre (registry_search_agents), puis (2) lui délègue via un RemoteA2aAgent qui lit sa carte et lui transmet la
tâche (transfer_to_agent). La réponse remonte à l'orchestrateur. Deux agents qui
dialoguent :
La page « Connecter un agent »
Côté OrbiAds, pas besoin de bricoler les identifiants à la main : une page self-service
provisionne un client OAuth pour l'agent. On saisit un nom et l'URL de redirection ; OrbiAds
renvoie un client_id et un secret affiché une seule fois.
L'URL de redirection du client doit correspondre au callback du connecteur Agent Identity, sinon le consentement échoue à l'exécution. La page affiche le gabarit exact à utiliser.
La suite
L'agent est déployé, découvrable, et un orchestrateur sait lui déléguer. Dans l'article 3, on compose un vrai cas métier multi-agents : un forecast et une reco de formats en parallèle, fusionnés en un plan d'optimisation.