Enregistrer des points de terminaison

Aperçu

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions 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 le registre d'agents, 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 disponible dans les emplacements multirégionaux us et eu. Vous devez enregistrer les ressources dans une région ou un emplacement global compatibles. Pour en savoir plus, consultez Emplacements du registre d'agents.

Avant de commencer

Avant de commencer, configurez le registre d'agents. 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 le registre d'agents, 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 au registre d'agents :

Console

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

   Accéder au registre d'agents

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

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. Il vérifie si l'URL publique est accessible. Le test n'est pas compatible avec les URL ni les points de terminaison privés qui nécessitent l'envoi de données authentifiées, comme les points de terminaison Vertex AI.

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 connexion de son 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, le registre d'agents génère automatiquement une ressource Endpoint en lecture seule côté consommateur, que les agents et les orchestrateurs peuvent découvrir et utiliser.