Scopri come creare, elencare ed eliminare i tipi di entità.
Crea un tipo di entità
Crea un tipo di entità in modo da poter creare le relative funzionalità.
UI web
- Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.
- Dalla barra delle azioni, fai clic su Crea tipo di entità per aprire il riquadro Crea tipo di entità.
- Seleziona un'area geografica dall'elenco a discesa Regione che include l'archivio di caratteristiche in cui vuoi creare un tipo di entità.
- Seleziona un archivio di caratteristiche.
- Specifica un nome per il tipo di entità.
- Se vuoi includere una descrizione per il tipo di entità, inseriscine una.
- Per abilitare il monitoraggio dei valori delle caratteristiche (anteprima), imposta il monitoraggio su Abilitato e specifica l'intervallo in giorni. Questa configurazione di monitoraggio si applica a tutte le caratteristiche in questo tipo di entità. Per maggiori informazioni, consulta la pagina Monitoraggio dei valori delle funzionalità.
- Fai clic su Crea.
REST &CMD LINE
Per creare un tipo di entità, invia una richiesta POST utilizzando il metodo featurestores.entityTypes.create.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION: area geografica in cui si trova l'archivio di caratteristiche, ad esempio
us-central1
. - PROJECT: il tuo ID progetto.
- FEATURESTORE_ID: ID dell'archivio di caratteristiche.
- ENTITY_TYPE_ID: ID del tipo di entità.
- DESCRIPTION: descrizione del tipo di entità.
Metodo HTTP e URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID
Corpo JSON richiesta:
{ "description": "DESCRIPTION" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth application-default 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-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID" | Select-Object -Expand Content
Dovresti vedere un output simile al seguente. Puoi utilizzare OPERATION_ID nella risposta per ottenere lo stato dell'operazione.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/bikes/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateEntityTypeOperationMetadata", "genericMetadata": { "createTime": "2021-03-02T00:04:13.039166Z", "updateTime": "2021-03-02T00:04:13.039166Z" } } }
Python
Per informazioni su come installare e utilizzare la libreria client per Vertex AI, consulta le librerie client di Vertex AI. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python AI Vertex.
Lingue aggiuntive
Puoi installare e utilizzare le seguenti librerie client Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.
Elenco tipi di entità
Elenca tutti i tipi di entità in un archivio di caratteristiche.
UI web
- Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.
- Seleziona un'area geografica dall'elenco a discesa Regione.
- Nella tabella delle caratteristiche, visualizza la colonna Tipo di entità per vedere i tipi di entità nel tuo progetto per l'area geografica selezionata.
REST &CMD LINE
Per elencare i tipi di entità, invia una richiesta GET utilizzando il metodo featurestores.entityTypes.list.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION: area geografica in cui si trova l'archivio di caratteristiche, ad esempio
us-central1
. - PROJECT: il tuo ID progetto.
- FEATURESTORE_ID: ID dell'archivio di caratteristiche.
Metodo HTTP e URL:
GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes"
PowerShell
Esegui questo comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "entityTypes": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID_1", "description": "ENTITY_TYPE_DESCRIPTION", "createTime": "2021-02-25T01:20:43.082628Z", "updateTime": "2021-02-25T01:20:43.082628Z", "etag": "AMEw9yOBqKIdbBGZcxdKLrlZJAf9eTO2DEzcE81YDKA2LymDMFB8ucRbmKwKo2KnvOg=" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID_2", "description": "ENTITY_TYPE_DESCRIPTION", "createTime": "2021-02-25T01:34:26.198628Z", "updateTime": "2021-02-25T01:34:26.198628Z", "etag": "AMEw9yNuv-ILYG8VLLm1lgIKc7asGIAVFErjvH2Cyc_wIQm7d6DL4ZGv59cwZmxTumU=" } ] }
Lingue aggiuntive
Puoi installare e utilizzare le seguenti librerie client Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.
Elimina un tipo di entità
Elimina un tipo di entità. Se utilizzi Cloud Console,
Vertex AI Feature Store elimina il tipo di entità e tutti i suoi
contenuti. Se utilizzi l'API, abilita il parametro di ricerca force
per eliminare il tipo di entità e tutti i suoi contenuti.
UI web
- Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.
- Seleziona un'area geografica dall'elenco a discesa Regione.
- Nella tabella delle caratteristiche, visualizza la colonna Tipo di entità e trova il tipo di entità da eliminare.
- Fai clic sul nome del tipo di entità.
- Nella barra delle azioni, fai clic su Elimina.
- Fai clic su Conferma per eliminare il tipo di entità.
REST &CMD LINE
Per eliminare un tipo di entità, invia una richiesta DELETE utilizzando il metodo featurestores.entityTypes.delete.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION: area geografica in cui si trova l'archivio di caratteristiche, ad esempio
us-central1
. - PROJECT: il tuo ID progetto.
- FEATURESTORE_ID: ID dell'archivio di caratteristiche.
- ENTITY_TYPE_ID: ID del tipo di entità.
- BOOLEAN: scegli se eliminare il tipo di entità anche se
contiene funzionalità. Il parametro di ricerca
force
è facoltativo ed èfalse
per impostazione predefinita.
Metodo HTTP e URL:
DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Esegui questo comando:
curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN"
PowerShell
Esegui questo comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata", "genericMetadata": { "createTime": "2021-02-26T17:32:56.008325Z", "updateTime": "2021-02-26T17:32:56.008325Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.protobuf.Empty" } }
Lingue aggiuntive
Puoi installare e utilizzare le seguenti librerie client Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.
Passaggi successivi
- Scopri come gestire le funzionalità.
- Scopri come monitorare i valori delle funzionalità importate nel tempo.
- Visualizza la quota dei tipi di entità di Vertex AI Feature Store.
- Risolvi i problemi comuni relativi a Vertex Feature Store.