Gestione dei tipi di entità

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

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Dalla barra delle azioni, fai clic su Crea tipo di entità per aprire il riquadro Crea tipo di entità.
  3. Seleziona un'area geografica dall'elenco a discesa Regione che include l'archivio di caratteristiche in cui vuoi creare un tipo di entità.
  4. Seleziona un archivio di caratteristiche.
  5. Specifica un nome per il tipo di entità.
  6. Se vuoi includere una descrizione per il tipo di entità, inseriscine una.
  7. 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à.
  8. 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. 

from google.cloud import aiplatform

def create_entity_type_sample(
    project: str, location: str, entity_type_id: str, featurestore_name: str,
):

    aiplatform.init(project=project, location=location)

    my_entity_type = aiplatform.EntityType.create(
        entity_type_id=entity_type_id, featurestore_name=featurestore_name
    )

    my_entity_type.wait()

    return my_entity_type

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

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Seleziona un'area geografica dall'elenco a discesa Regione.
  3. 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

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Seleziona un'area geografica dall'elenco a discesa Regione.
  3. Nella tabella delle caratteristiche, visualizza la colonna Tipo di entità e trova il tipo di entità da eliminare.
  4. Fai clic sul nome del tipo di entità.
  5. Nella barra delle azioni, fai clic su Elimina.
  6. 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