Gérer les liaisons

Dans le registre d'agents, les liaisons permettent à vos agents d'orchestration de se connecter aux agents en aval, aux serveurs MCP et aux points de terminaison sans coder en dur les détails de connexion ou d'authentification dans votre code. Vous pouvez créer, afficher, mettre à jour et supprimer des liaisons dans le registre d'agents pour gérer les connexions de ressources et les autorisations déléguées.

Avant de commencer

  1. Configurer le registre d'agents.

  2. Pour une configuration à projet unique, obtenez l'ID de projet du projet de gouvernance où le registre d'agents est activé. Si vous avez configuré une limite de gestion pour plusieurs projets, utilisez l'ID de votre projet de gestion pour la découverte et l'enregistrement à l'échelle de la limite, ou spécifiez l'ID d'un projet membre pour les opérations sur un seul projet.

  3. Enregistrez les composants source et cible. Pour en savoir plus, consultez Modèles d'enregistrement.

  4. 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 des outils et des ressources.

  5. Pour utiliser les commandes de la Google Cloud CLI dans ce document, configurez votre environnement gcloud 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 de gouvernance où le registre d'agents est activé :

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.

Scénarios de liaison

Vous pouvez utiliser des liaisons pour connecter des ressources et déléguer des autorisations. Par exemple, vous pouvez utiliser des liaisons dans les scénarios suivants :

  • Connexions de ressources : associez 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 planifier 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 : associez un agent à un fournisseur d'authentification pour lui permettre 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.

Vous pouvez créer et gérer des liaisons dans un emplacement régional ou multirégional compatible, ou dans l'emplacement global. Pour en savoir plus sur les emplacements compatibles, consultez Emplacements Agent Registry.

Créer une liaison

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

gcloud

Exécutez la commande gcloud agent-registry bindings create :

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

Terraform

Pour créer une liaison entre un agent source et une ressource cible, configurez une ressource google_agent_registry_binding. Une liaison nécessite le bloc target :

resource "google_agent_registry_binding" "agent_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Connects a source agent to a target resource."

  source {
    identifier = "SOURCE_ID"
  }

  target {
    identifier = "TARGET_ID"
  }
}

Remplacez les éléments suivants :

  • REGION : région du registre.
  • BINDING_NAME : nom unique que vous souhaitez attribuer à la liaison.
  • DISPLAY_NAME : nom lisible par l'humain de la liaison.
  • SOURCE_ID : identifiant de l'agent source au format URN.
  • TARGET_ID : identifiant de registre de la ressource cible au format URN.

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

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

gcloud

Exécutez la commande gcloud agent-registry bindings create avec l'option --auth-provider-binding :

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

Remplacez les éléments suivants :

  • BINDING_NAME : nom unique que vous souhaitez attribuer à la liaison.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.
  • DISPLAY_NAME : nom lisible par l'humain de la liaison.
  • SOURCE_ID : identifiant de l'agent source au format URN.
  • TARGET_ID : identifiant de registre de la ressource cible au format URN.
  • AUTH_PROVIDER_ID : ID de votre fournisseur d'authentification.

Terraform

Pour configurer une liaison de fournisseur d'authentification dans Terraform, spécifiez le bloc auth_provider_binding avec le nom de ressource de votre fournisseur d'authentification, ainsi que ses champs d'application et son URI de continuation :

resource "google_agent_registry_binding" "auth_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"

  source {
    identifier = "SOURCE_ID"
  }

  target {
    identifier = "TARGET_ID"
  }

  auth_provider_binding {
    auth_provider = "projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"
    scopes        = [SCOPES]
    continue_uri  = "CONTINUE_URI"
  }
}

Remplacez les éléments suivants :

  • REGION : région du registre.
  • BINDING_NAME : nom unique que vous souhaitez attribuer à la liaison.
  • DISPLAY_NAME : nom lisible par l'humain de la liaison.
  • SOURCE_ID : identifiant de l'agent source au format URN.
  • TARGET_ID : identifiant de registre de la ressource cible au format URN.
  • PROJECT_ID : ID du projet.
  • AUTH_PROVIDER_ID : ID du fournisseur d'authentification.
  • SCOPES : liste de champs d'application OAuth 2.0 séparés par une virgule, par exemple "https://www.googleapis.com/auth/cloud-platform".
  • CONTINUE_URI : URI de continuation du fournisseur d'authentification, par exemple https://example.com/continue.

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

Répertorier les liaisons

Répertoriez toutes les liaisons d'un emplacement spécifique en exécutant la commande gcloud agent-registry bindings list :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Afficher les détails de la liaison

Récupérez les détails d'une seule liaison en exécutant la commande gcloud agent-registry bindings describe :

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

Remplacez les éléments suivants :

  • BINDING_NAME : nom de la liaison.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Mettre à jour une liaison

Mettez à jour les paramètres d'une liaison existante, tels que son nom à afficher ou sa description :

gcloud

Exécutez la commande gcloud agent-registry bindings update :

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

Remplacez les éléments suivants :

  • BINDING_NAME : nom de la liaison que vous souhaitez mettre à jour.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.
  • NEW_DISPLAY_NAME : nouveau nom lisible par l'humain pour la liaison.

Terraform

Pour mettre à jour le nom à afficher ou la description d'une liaison à l'aide de Terraform, modifiez la ressource google_agent_registry_binding existante dans votre configuration et exécutez terraform apply.

Supprimer une liaison

Pour supprimer une connexion entre des ressources, supprimez la liaison :

gcloud

Exécutez la commande gcloud agent-registry bindings delete :

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

Remplacez les éléments suivants :

  • BINDING_NAME : nom de la liaison que vous souhaitez supprimer.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Terraform

Supprimez la ressource google_agent_registry_binding représentant la liaison de votre configuration Terraform, puis exécutez terraform apply.

Étapes suivantes