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 orchestrateurs d'interagir avec les fonctionnalités en aval.

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

  • Connexions de ressources : vous pouvez lier 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 mapper 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 des 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, mettre à jour et supprimer des liaisons dans Agent Registry.

Avant de commencer

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

  1. Configurez Agent Registry.
  2. Enregistrez les composants source et cible. Pour en savoir plus, consultez Enregistrer des composants d'agent.
  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 Agent Identity. Pour en savoir plus, consultez S'authentifier auprès d'outils et de ressources.
  4. Pour utiliser les commandes Google Cloud CLI dans ce document, assurez-vous que vous avez configuré votre environnement gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les liaisons dans Agent Registry, 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 :

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 Agent Identity. Pour en savoir plus, consultez S'authentifier auprès d'outils et de ressources.

Lorsque vous spécifiez le nom de ressource --auth-provider, vous devez utiliser l'ID de votre 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 le code de votre Agent Development Kit (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 options 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 connexion entre des ressources, supprimez l'enregistrement de liaison :

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

Étape suivante