Répertorier des fonctionnalités

Vous pouvez récupérer la liste des caractéristiques ajoutées à un groupe de caractéristiques spécifique dans votre Google Cloud projet. Chaque caractéristique correspond aux valeurs de caractéristiques contenues dans une colonne spécifique de la table ou de la vue source BigQuery associée au groupe de caractéristiques.

Avant de commencer

Authentifiez-vous auprès de Gemini Enterprise Agent Platform, sauf si vous l'avez déjà fait.

Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

Console

Lorsque vous utilisez la Google Cloud console pour accéder aux Google Cloud services et aux API, vous n'avez pas besoin de configurer l'authentification.

REST

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

    Installez la Google Cloud CLI.

    Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Google Cloud authentification.

Répertorier les caractéristiques d'un groupe de caractéristiques

Utilisez les exemples suivants pour récupérer la liste des caractéristiques d'un groupe de caractéristiques.

Console

Suivez les instructions ci-dessous pour afficher la liste des caractéristiques d'un groupe de caractéristiques à l'aide de la Google Cloud console.

  1. Dans la section Agent Platform de la Google Cloud console, accédez à la Feature Store page.

    Accéder à la page Feature Store

  2. Dans la section Groupes de caractéristiques, cliquez sur l'icône Développer à côté du nom du groupe de caractéristiques pour afficher toutes les caractéristiques qu'il contient.

REST

Pour récupérer la liste de toutes les ressources Feature dans un groupe de caractéristiques spécifique de votre projet, envoyez une requête GET à l'aide de la méthode features.list.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • LOCATION_ID : région où se trouve le groupe de caractéristiques (par exemple, us-central1).
  • PROJECT_ID : ID de votre projet
  • FEATURE_GROUP_NAME : nom du groupe de caractéristiques dont vous souhaitez afficher la liste des caractéristiques.

Méthode HTTP et URL : 

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante : 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features"

PowerShell

Exécutez la commande suivante : 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "features": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME_1",
      "createTime": "2023-09-06T23:16:00.429055Z",
      "updateTime": "2023-09-06T23:16:00.429055Z",
      "etag": "AMEw9yP4QWrXwty9C5J9a77O3_yV5LW4DUIIagKpmoHdzctF577OtlBlOyZC7EIQUZ8_",
      "versionColumnName": "double"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME_2",
      "createTime": "2023-09-07T00:59:39.330881Z",
      "updateTime": "2023-09-07T00:59:39.330881Z",
      "etag": "AMEw9yOZhegkDL44AMibnanMoDNJeVx-MHwcOqAQuihGHWFQxJMpvG3ePH3bNDS-tIRX",
      "versionColumnName": "double2"
    }
  ]
}

Étapes suivantes