Enregistrer des points de terminaison

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Dans Agent Registry, un point de terminaison représente une URL cible, généralement une API REST, à laquelle vos agents accèdent. En enregistrant ces destinations en tant que composants agentiques gérés dans Agent Registry, vous pouvez contrôler de manière centralisée les points de terminaison externes auxquels votre parc d'agents peut se connecter.

Ce document explique comment enregistrer explicitement des points de terminaison externes dans le registre.

Remarque : L'enregistrement manuel n'est pas compatible avec les emplacements multirégionaux us et eu. Vous devez enregistrer les ressources dans une région compatible ou dans l'emplacement global. Pour en savoir plus, consultez Emplacements Agent Registry.

Avant de commencer

Avant de commencer, configurez Agent Registry. Vous avez besoin de l'ID de votre projet pour effectuer ces tâches.

Pour utiliser les commandes Google Cloud CLI de ce document, assurez-vous d'avoir configuré votre environnement gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour enregistrer des points de terminaison dans Agent Registry, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de l'API Agent Registry (roles/agentregistry.editor) 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.

Enregistrer un point de terminaison

Étant donné que les points de terminaison sont des destinations externes personnalisées, utilisez l'enregistrement manuel pour les ajouter à Agent Registry :

Console

1. Dans la Google Cloud console, accédez à Agent Registry:

   Accéder à Agent Registry

2. Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.

3. Sélectionnez l'onglet Points de terminaison.

4. Cliquez sur Ajouter un point de terminaison.

5. Dans le panneau Détails du point de terminaison , saisissez le nom à afficher, une description, la région géographique et l'URL de destination.

   Vous pouvez également cliquer sur Tester la connexion dans ce panneau pour tester votre connexion à l'URL de destination.

   Remarque : Vous pouvez enregistrer des points de terminaison qui utilisent des URL privées. Toutefois, le test de connexion ne fonctionne que pour les points de terminaison publics, en vérifiant si l'URL publique est accessible. Le test n'est pas compatible avec les URL privées ni avec les points de terminaison qui nécessitent l'envoi de données authentifiées, comme Agent Runtime sur les points de terminaison Gemini Enterprise Agent Platform.

6. Cliquez sur Enregistrer.

gcloud

Vous créez une ressource Service avec un endpoint-spec-type de no-spec.

Enregistrez le point de terminaison et définissez les détails de sa connexion d'interface :

gcloud alpha agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Remplacez les éléments suivants :

• ENDPOINT_NAME: nom que vous souhaitez attribuer à votre point de terminaison, par exemple my-external-api.
• PROJECT_ID : ID du projet.
• REGION : région du registre.
• DISPLAY_NAME: nom lisible du point de terminaison.
• ENDPOINT_URL: URL cible, par exemple https://api.example.com/v1/data.
• PROTOCOL : liaison de protocole pour l'interface. Les valeurs valides sont HTTP_JSON, GRPC ou JSONRPC.

Une fois la ressource Service créée, Agent Registry génère automatiquement une ressource Endpoint en lecture seule côté consommateur que les agents et les orchestrateurs peuvent découvrir et utiliser.