Membuat fitur

Anda dapat membuat fitur setelah membuat grup fitur dan mengaitkan tabel BigQuery atau tampilan BigQuery dengannya. Anda dapat membuat beberapa fitur untuk grup fitur dan mengaitkan setiap fitur dengan kolom spesifik dalam sumber data BigQuery. Untuk mendapatkan informasi cara menggunakan BigQuery, baca dokumentasi BigQuery.

Misalnya, jika grup fitur featuregroup1 dikaitkan dengan tabel BigQuery datasource_1 yang berisi nilai fitur di kolom fval1 dan fval2, Anda dapat membuat fitur feature_1 di bagian featuregroup1 dan mengaitkannya dengan nilai fitur di kolomfval1. Demikian pula, Anda dapat membuat fitur lain bernama feature_2 dan mengaitkannya dengan nilai fitur di kolom fval2.

Grup fitur harus memiliki sumber data fitur yang terkait dengannya sebelum Anda dapat membuat fitur. Jika grup fitur tidak memiliki sumber data terkait, Anda harus mengaitkan sumber data BigQuery dengan memperbarui grup fitur, sebelum Anda dapat membuat fitur di dalamnya.

Untuk memahami apakah Anda wajib, opsional, atau tidak disarankan untuk mendaftarkan data fitur menggunakan grup fitur dan fitur, lihat hal berikut:

Sebelum memulai

Lakukan autentikasi ke Gemini Enterprise Agent Platform, kecuali jika Anda sudah melakukannya.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

Konsol

Saat menggunakan Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

Python

Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

  1. Instal Google Cloud CLI.

  2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus terlebih dahulu login ke gcloud CLI dengan identitas gabungan Anda.

  3. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan hal ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Instal Google Cloud CLI.

    Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus terlebih dahulu login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi. Google Cloud

Membuat fitur dalam grup fitur

Gunakan contoh berikut untuk membuat fitur dalam grup fitur dan mengaitkan kolom yang berisi nilai fitur dari sumber data BigQuery yang terdaftar untuk grup fitur.

Konsol

Gunakan petunjuk berikut untuk menambahkan fitur ke grup fitur yang ada menggunakan Google Cloud konsol.

  1. Di bagian Agent Platform pada Google Cloud konsol, buka halaman Feature Store.

    Buka halaman Feature Store

  2. Di bagian Feature groups, klik di baris yang sesuai dengan grup fitur tempat Anda ingin menambahkan fitur, lalu klik Add features.

  3. Untuk setiap fitur, masukkan Feature name dan klik nama kolom sumber BigQuery yang sesuai dalam daftar. Untuk menambahkan fitur lainnya, klik Add another feature.

  4. Klik Create.

Python

Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat Python dokumentasi referensi API. 


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: Project ID Anda.
  • location: Region tempat grup fitur berada, misalnya us-central1.
  • existing_feature_group_id: Nama grup fitur yang ada tempat Anda ingin membuat fitur.
  • version_column_name: Opsional: Kolom dari tabel atau tampilan BigQuery yang ingin dikaitkan dengan fitur tersebut. Jika Anda tidak menentukannya, parameter ini akan ditetapkan ke FEATURE_NAME, secara default.
  • feature_id: Nama fitur baru yang ingin Anda buat

REST

Untuk membuat resource Feature, kirim permintaan POST menggunakan metode features.create.

Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:

  • LOCATION_ID: Region tempat grup fitur berada, misalnya us-central1.
  • PROJECT_ID: Project ID Anda.
  • FEATUREGROUP_NAME: Nama grup fitur tempat Anda ingin membuat fitur tersebut.
  • FEATURE_NAME: Nama fitur baru yang ingin Anda buat.
  • VERSION_COLUMN_NAME: Opsional: Kolom dari tabel atau tampilan BigQuery yang ingin dikaitkan dengan fitur tersebut. Jika Anda tidak menentukannya, parameter ini akan ditetapkan ke FEATURE_NAME, secara default.

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "version_column_name": "VERSION_COLUMN_NAME"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

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"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

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

Langkah berikutnya