La livraison en ligne vous permet de livrer des valeurs de caractéristiques pour de petits lots d'entités avec une faible latence. Pour chaque requête, vous ne pouvez livrer que les valeurs de caractéristiques d'un seul type d'entité. Vertex AI Feature Store (ancien) ne renvoie que la dernière valeur non nulle de chaque caractéristique.
Vous utilisez généralement la livraison en ligne pour livrer des valeurs de caractéristiques dans des modèles déployés pour des prédictions en ligne. Par exemple, imaginons que vous soyez propriétaire d'une entreprise de vélos en libre-service. Vous souhaitez pouvoir prédire la durée de location d'un vélo lorsqu'un utilisateur particulier le loue. Vous pouvez inclure des entrées en temps réel de l'utilisateur et des données du magasin de caractéristiques pour effectuer une prédiction en ligne. Ainsi, vous pouvez déterminer l'allocation des ressources en temps réel.
Valeurs nulles
Pour les résultats de livraison en ligne, si la dernière valeur d'une caractéristique est nulle, Vertex AI Feature Store (ancien) renvoie la dernière valeur non nulle. S'il n'existe aucune valeur précédente, Vertex AI Feature Store (ancien) renvoie une valeur nulle.
Avant de commencer
Vérifiez que le magasin de caractéristiques auquel vous adressez les appels dispose d'un magasin en ligne (le nombre de nœuds doit être supérieur à 0
). Sinon, les requêtes de livraison en ligne renvoient une erreur. Pour plus d'informations, consultez Gérer les magasins de caractéristiques.
Livrer des valeurs à partir d'une seule entité
Livrez des valeurs de caractéristiques à partir d'une seule entité pour un type d'entité particulier.
REST
Pour obtenir les valeurs de caractéristiques d'une entité, envoyez une requête POST à l'aide de la méthode featurestores.entityTypes.readFeatureValues.
L'exemple suivant obtient les dernières valeurs de deux caractéristiques différentes pour une entité spécifique. Notez que dans le champ ids
, vous pouvez spécifier ["*"]
au lieu des ID de caractéristiques pour sélectionner toutes les caractéristiques de l'entité.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION_ID : région dans laquelle le magasin de caractéristiques est créé. Par exemple :
us-central1
. - PROJECT_ID : ID de votre projet.
- FEATURESTORE_ID : ID du magasin de caractéristiques.
- ENTITY_TYPE_ID : ID du type d'entité.
- ENTITY_ID : ID de l'entité pour laquelle obtenir des valeurs de caractéristiques.
- FEATURE_ID : ID de la caractéristique pour laquelle obtenir des valeurs.
Méthode HTTP et URL :
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues
Corps JSON de la requête :
{ "entityId": "ENTITY_ID", "featureSelector": { "idMatcher": { "ids": ["FEATURE_ID_1", "FEATURE_ID_2"] } } }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{ "header": { "entityType": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID", "featureDescriptors": [ { "id": "FEATURE_ID_1" }, { "id": "FEATURE_ID_2" } ] }, "entityView": { "entityId": "ENTITY_ID", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_1", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_2", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } } ] } }
SDK Vertex AI pour Python
Pour savoir comment installer ou mettre à jour le SDK Vertex AI pour Python, consultez Installer le SDK Vertex AI pour Python. Pour en savoir plus, consultez la documentation de référence de l'API SDK Vertex AI pour Python.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Vertex AI sur l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Vertex AI pour Java.
Pour vous authentifier auprès de Vertex AI, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js décrites dans le guide de démarrage rapide de Vertex AI sur l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Vertex AI pour Node.js.
Pour vous authentifier auprès de Vertex AI, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Livrer des valeurs à partir de plusieurs entités
Livrez des valeurs de caractéristiques à partir d'une ou de plusieurs entités pour un type d'entité particulier.
Pour de meilleures performances, utilisez la méthode streamingReadFeatureValues
au lieu d'envoyer des requêtes parallèles à la méthode readFeatureValues
.
REST
Pour obtenir des valeurs de caractéristiques à partir de plusieurs entités, envoyez une requête POST à l'aide de la méthode featurestores.entityTypes.streamingReadFeatureValues.
L'exemple suivant récupère les dernières valeurs de deux caractéristiques différentes pour deux entités différentes. Notez que dans le champ ids
, vous pouvez spécifier ["*"]
au lieu des ID de caractéristiques pour sélectionner toutes les caractéristiques de l'entité.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION_ID : région dans laquelle le magasin de caractéristiques est créé. Par exemple :
us-central1
. - PROJECT_ID : ID de votre projet.
- FEATURESTORE_ID : ID du magasin de caractéristiques.
- ENTITY_TYPE_ID : ID du type d'entité.
- ENTITY_ID : ID de l'entité pour laquelle obtenir des valeurs de caractéristiques.
- FEATURE_ID : ID de la caractéristique pour laquelle obtenir des valeurs.
Méthode HTTP et URL :
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues
Corps JSON de la requête :
{ "entityIds": ["ENTITY_ID_1", "ENTITY_ID_2"], "featureSelector": { "idMatcher": { "ids": ["FEATURE_ID_1", "FEATURE_ID_2"] } } }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
[{ "header": { "entityType": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID", "featureDescriptors": [ { "id": "FEATURE_ID_1" }, { "id": "FEATURE_ID_2" } ] } }, { "entityView": { "entityId": "ENTITY_ID_1", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_A", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_B", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } } ] } }, { "entityView": { "entityId": "ENTITY_ID_2", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_C", "metadata": { "generateTime": "2019-10-28T21:21:37Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_D", "metadata": { "generateTime": "2019-10-28T21:21:37Z" } } } ] } }]
Langages supplémentaires
Vous pouvez installer et utiliser les bibliothèques clientes Vertex AI suivantes pour appeler l'API Vertex AI. Les bibliothèques clientes Cloud optimisent l'expérience des développeurs en utilisant les conventions et styles naturels de chaque langage compatible.
Étapes suivantes
- Découvrez comment ingérer des valeurs de caractéristiques par lots.
- Apprenez à livrer des caractéristiques avec la livraison par lots.
- Consultez les quotas de livraison en ligne de Vertex AI Feature Store (ancien).
- Résolvez les problèmes courants liés à Vertex AI Feature Store (ancien).