Gérer les liaisons

Dans Agent Registry, une liaison représente une connexion entre un agent source et une ressource cible, telle qu'un autre agent, un serveur MCP ou un point de terminaison. En créant des liaisons, vous établissez des relations explicites qui permettent à vos agents d'orchestration d'interagir avec les capacités en aval.

Vous utilisez des liaisons pour gérer deux scénarios :

  • Connexions de ressources : vous pouvez associer un agent source à une ressource cible, telle qu'un autre agent, un serveur MCP ou un point de terminaison. Ce scénario vous permet de cartographier des workflows multi-agents dans lesquels un orchestrateur principal délègue des tâches à des sous-agents ou des outils spécialisés.
  • Autorisations déléguées : vous pouvez associer un agent à un fournisseur d'authentification pour permettre à votre agent de se connecter à des cibles externes ou à des outils personnalisés à l'aide de ses propres identifiants ou au nom d'un utilisateur individuel. Cette liaison est requise si votre agent doit s'authentifier auprès de serveurs ou d'outils MCP distants à l'aide de jetons OAuth ou de clés API. Avec les liaisons, vous n'avez pas besoin de définir manuellement les fournisseurs d'authentification dans votre code. Pour obtenir des instructions détaillées, consultez Créer une liaison de fournisseur d'authentification dans ce document.

Ce document explique comment créer, afficher, modifier et supprimer des liaisons dans le registre d'agents.

Avant de commencer

Avant de pouvoir gérer les liaisons, procédez comme suit :

  1. Configurez le registre d'agents.
  2. Enregistrez les ressources source et cible. Pour en savoir plus, consultez Enregistrer des services.
  3. Si vous souhaitez configurer des liaisons pour les autorisations déléguées, créez un fournisseur d'authentification avec le gestionnaire d'authentification de l'identité de l'agent. Pour en savoir plus, consultez S'authentifier auprès des outils et des ressources.
  4. Pour utiliser les commandes gcloud CLI de ce document, assurez-vous d'avoir configuré votre environnement Google Cloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les liaisons dans le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une liaison

Créez une liaison pour connecter un agent source à une ressource cible :

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --target-identifier="TARGET_ID"

Remplacez les éléments suivants :

  • BINDING_NAME : nom que vous souhaitez attribuer à la liaison, par exemple my-custom-binding.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.
  • DISPLAY_NAME : nom lisible que vous souhaitez attribuer à votre liaison, par exemple My Custom Binding.
  • SOURCE_ID : identifiant de l'agent source au format URN (Uniform Resource Name).
  • TARGET_ID : identifiant de la ressource cible au format URN, tel qu'un identifiant de serveur MCP.

Créer une liaison de fournisseur d'authentification

Vous pouvez associer un agent à un fournisseur d'authentification pour les autorisations déléguées. Avant de créer cette liaison, vous devez d'abord créer le fournisseur d'authentification avec le gestionnaire d'authentification de l'identité de l'agent. Pour en savoir plus, consultez S'authentifier auprès des outils et des ressources.

Lorsque vous spécifiez le nom de ressource --auth-provider, vous devez utiliser votre ID de projet :

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --auth-provider="projects/PROJECT_ID/locations/REGION/connectors/AUTH_PROVIDER_ID"

Remplacez AUTH_PROVIDER_ID par l'ID de votre fournisseur d'authentification.

Pour obtenir des exemples d'utilisation de ces liaisons dans le code de votre agent, consultez Résoudre les liaisons dans votre code ADK.

Répertorier les liaisons

Répertoriez toutes les liaisons dans un emplacement spécifique :

gcloud alpha agent-registry bindings list \
  --project=PROJECT_ID \
  --location=REGION

Afficher les détails de la liaison

Récupérez les détails d'une seule liaison :

gcloud alpha agent-registry bindings describe BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Mettre à jour une liaison

Mettez à jour les paramètres d'une liaison existante, tels que son nom à afficher ou sa description, à l'aide des indicateurs gcloud CLI :

gcloud alpha agent-registry bindings update BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="NEW_DISPLAY_NAME"

Supprimer une liaison

Pour supprimer une association entre des ressources, supprimez l'enregistrement de liaison :

gcloud alpha agent-registry bindings delete BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Étapes suivantes