Creare una funzionalità

Console

Segui queste istruzioni per aggiungere funzionalità a un gruppo di funzionalità esistente utilizzando la console Google Cloud .

1. Nella sezione Vertex AI della console Google Cloud , vai alla pagina Feature Store.

   Vai alla pagina Feature Store

2. Nella sezione Gruppi di funzionalità, fai clic su more_vert nella riga corrispondente al gruppo di funzionalità a cui vuoi aggiungere una funzionalità, quindi fai clic su Aggiungi funzionalità.

3. Per ogni caratteristica, inserisci un Nome della caratteristica e fai clic sul nome della colonna di origine BigQuery corrispondente nell'elenco. Per aggiungere altre funzionalità, fai clic su Aggiungi un'altra funzionalità.

4. Fai clic su Crea.

Python

Per scoprire come installare o aggiornare l'SDK Vertex AI Python, consulta Installare l'SDK Vertex AI Python. Per saperne di più, consulta la documentazione di riferimento dell'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: il tuo ID progetto.
• location: la regione in cui si trova il gruppo di funzionalità, ad esempio us-central1.
• existing_feature_group_id: il nome del gruppo di funzionalità esistente in cui vuoi creare la funzionalità.
• version_column_name: (facoltativo) la colonna della tabella o della vista BigQuery che vuoi associare alla funzionalità. Se non specifichi questo parametro, per impostazione predefinita viene impostato su FEATURE_NAME.
• feature_id: Il nome della nuova funzionalità che vuoi creare

REST

Per creare una risorsa Feature, invia una richiesta POST utilizzando il metodo features.create.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• LOCATION_ID: la regione in cui si trova il gruppo di funzionalità, ad esempio us-central1.
• PROJECT_ID: il tuo ID progetto.
• FEATUREGROUP_NAME: il nome del gruppo di funzionalità in cui vuoi creare la funzionalità.
• FEATURE_NAME: il nome della nuova funzionalità che vuoi creare.
• VERSION_COLUMN_NAME: (facoltativo) la colonna della tabella o della vista BigQuery che vuoi associare alla funzionalità. Se non specifichi questo parametro, per impostazione predefinita viene impostato su FEATURE_NAME.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "version_column_name": "VERSION_COLUMN_NAME"
}

Per inviare la richiesta, scegli una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
    }
  }
}