Créer une caractéristique

Console

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

1. Dans la section "Vertex AI" de la console Google Cloud, accédez à la page Feature Store.

   Accéder à la page Feature Store

2. Dans la section Groupes de caractéristiques, cliquez sur more_vert sur la ligne correspondant au groupe de caractéristiques auquel vous souhaitez ajouter une caractéristique, puis cliquez sur Ajouter des caractéristiques.

3. Pour chaque caractéristique, saisissez un nom de caractéristique, puis cliquez sur le nom de la colonne source BigQuery correspondante dans la liste. Pour ajouter des caractéristiques, cliquez sur Ajouter une autre caractéristique.

4. Cliquez sur Créer.

Python

Pour savoir comment installer ou mettre à jour le SDK Vertex AI pour Python, consultez la section Installer le SDK Vertex AI pour Python. Pour en savoir plus, consultez la documentation de référence de l'API Python.

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_feature_sample(
    project: str,
    location: str,
    existing_feature_group_id: str,
    feature_id: str,
    version_column_name: str,
):
    aiplatform.init(project=project, location=location)
    feature_group = feature_store.FeatureGroup(existing_feature_group_id)
    feature = feature_group.create_feature(
        name=feature_id, version_column_name=version_column_name
    )
    return feature

• project : ID de votre projet
• location : région où se trouve le groupe de caractéristiques, par exemple us-central1.
• existing_feature_group_id : nom du groupe de caractéristiques existant dans lequel vous souhaitez créer la caractéristique.
• version_column_name Facultatif : colonne de la table ou de la vue BigQuery que vous souhaitez associer à la caractéristique. Si vous ne spécifiez pas ce paramètre, il est défini par défaut sur FEATURE_NAME.
• feature_id : nom de la nouvelle caractéristique que vous souhaitez créer.

REST

Pour créer une ressource Feature, envoyez une requête POST à l'aide de la méthode features.create.

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
• FEATUREGROUP_NAME : nom du groupe de caractéristiques dans lequel vous souhaitez créer la caractéristique.
• FEATURE_NAME : nom de la nouvelle caractéristique que vous souhaitez créer.
• VERSION_COLUMN_NAME Facultatif : colonne de la table ou de la vue BigQuery que vous souhaitez associer à la caractéristique. Si vous ne spécifiez pas ce paramètre, il est défini par défaut sur FEATURE_NAME.

Méthode HTTP et URL :

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME

Corps JSON de la requête :

{
  "version_column_name": "VERSION_COLUMN_NAME"
}

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME"

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T02:36:22.870679Z",
      "updateTime": "2023-09-18T02:36:22.870679Z"
    }
  }
}