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 ressources gérées, vous pouvez contrôler de manière centralisée les services externes auxquels votre parc d'agents peut se connecter.

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

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 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 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 tester votre connexion à l'URL de destination à partir de ce panneau.

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

• SERVICE_NAME: nom que vous souhaitez attribuer à votre ressource, 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.