Membuat instance toko online

Untuk menyiapkan penyaluran online, Anda harus membuat instance toko online terlebih dahulu untuk penyaluran online Bigtable atau Penyaluran online yang dioptimalkan (Tidak digunakan lagi).

Perhatikan bahwa Anda tidak dapat mengubah jenis penayangan online setelah memilih penayangan online Bigtable atau penayangan online yang dioptimalkan saat membuat toko online Anda. Namun, Anda dapat mengubah konfigurasi endpoint penayangan untuk instance toko online yang dibuat untuk Penayangan online yang dioptimalkan.

Setelah membuat toko online, Anda dapat menambahkan tampilan fitur dan mengaitkan tampilan fitur tersebut dengan sumber data fitur di BigQuery.

Anda dapat mengenkripsi instance toko online dengan menentukan kunci enkripsi yang dikelola pelanggan (CMEK) saat membuat instance toko online. Hanya penyaluran online Bigtable yang mendukung enkripsi menggunakan CMEK. Untuk mempelajari lebih lanjut manfaat penggunaan CMEK dan untuk memahami apakah CMEK berguna bagi toko online Anda, lihat Manfaat CMEK.

Penggunaan CMEK dapat menimbulkan biaya penggunaan tambahan, bergantung pada jenis kunci yang digunakan. Untuk mengetahui informasi selengkapnya tentang harga, lihat Harga Cloud Key Management Service.

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 konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

Python

Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan 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 login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

   gcloud auth application-default login

   Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

   Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa 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 login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Membuat toko online untuk penyaluran online Bigtable

Saat menggunakan penyaluran online Bigtable, Anda memiliki opsi untuk mengenkripsi toko online menggunakan CMEK.

Membuat toko online untuk penyaluran online Bigtable tanpa CMEK

Untuk membuat instance toko online untuk penyaluran online Bigtable dengan penskalaan otomatis, tanpa menentukan CMEK, gunakan Google Cloud konsol atau REST API.

Catatan: Penyaluran online Bigtable tidak mendukung penyematan. Jika Anda ingin menyajikan embedding, gunakan Penelusuran Vektor.

Konsol

Gunakan petunjuk berikut untuk membuat toko online untuk penyaluran online Bigtable menggunakan Google Cloud konsol.

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

   Buka halaman Feature Store

2. Klik Toko online untuk membuka bagian Toko online.

3. Klik Buat untuk membuka halaman Buat Toko Online.

4. Tentukan nama untuk toko online.

5. Opsional: Untuk menambahkan label, klik Tambahkan label, lalu tentukan nama dan nilai label. Anda dapat menambahkan beberapa label ke toko online.

6. Di kolom Choose a storage solution for your online store, klik Bigtable.

7. Ubah Jumlah node minimum, Jumlah node maksimum, dan Target pemakaian CPU sesuai kebutuhan.

8. 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 dokumentasi referensi API Python.

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_bigtable_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_bigtable_store(
        feature_online_store_id
    )
    return fos

• project: Project ID Anda.
• location: Region tempat toko online berada, seperti us-central1.
• feature_online_store_id: Nama instance FeatureOnlineStore baru.

REST

Untuk membuat resource FeatureOnlineStore, kirim permintaan POST menggunakan metode featureOnlineStores.create.

Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

• LOCATION_ID: Region tempat Anda ingin membuat toko online, seperti us-central1.
• PROJECT_ID: Project ID Anda.
• FEATUREONLINESTORE_NAME: Nama instance toko online baru.
• BOOLEAN: Opsional: Untuk membuat toko online yang mendukung pengelolaan embedding, masukkan true. Nilai defaultnya adalah false.

Metode HTTP dan URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Meminta isi JSON:

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Membuat toko online yang menggunakan CMEK

Gunakan langkah-langkah berikut untuk membuat instance toko online untuk penyaluran online Bigtable yang dienkripsi dengan CMEK.

Penggunaan enkripsi CMEK dapat menimbulkan biaya penggunaan tambahan, bergantung pada jenis kunci yang digunakan. Untuk mengetahui informasi selengkapnya tentang harga, lihat Harga Cloud Key Management Service.

Catatan: Penyaluran online Bigtable tidak mendukung penyematan. Jika Anda ingin menyajikan embedding, gunakan Penelusuran Vektor.

1. Gunakan Cloud Key Management Service untuk mengonfigurasi kunci enkripsi yang dikelola pelanggan.

2. Untuk membuat resource FeatureOnlineStore, kirim permintaan POST berikut menggunakan metode featureOnlineStores.create dan tentukan CMEK.

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • LOCATION_ID: Region tempat Anda ingin membuat toko online, seperti us-central1.
   • PROJECT_ID: Project ID Anda.
   • FEATUREONLINESTORE_NAME: Nama instance toko online baru.
   • BOOLEAN: Opsional: Untuk membuat toko online yang mendukung pengelolaan embedding, masukkan true. Nilai defaultnya adalah false.
   • KEY_NAME: Nama kunci enkripsi yang ingin Anda gunakan untuk penyimpanan metadata ini.

   Metode HTTP dan URL:

   POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

   Meminta isi JSON:

   {
     "bigtable": {
       "auto_scaling": {
         "min_node_count": 1,
         "max_node_count": 3,
         "cpu_utilization_target": 50
       }
     },
     "encryption_spec": {
       "kms_key_name": "KEY_NAME"
     }
   }
   

   Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

   curl

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

   PowerShell

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
       "genericMetadata": {
         "createTime": "2023-09-18T17:49:23.847496Z",
         "updateTime": "2023-09-18T17:49:23.847496Z"
       }
     }
   }
   

Membuat toko online untuk Penyaluran online yang dioptimalkan

Penayangan online yang dioptimalkan Gemini Enterprise Agent Platform Feature Store tidak digunakan lagi. Mulai 17 Mei 2026, tidak ada fitur baru yang akan ditambahkan dan hanya patch penting yang akan disediakan. Pada 17 Februari 2027, kemampuan ini akan sepenuhnya dihentikan dan API tidak akan tersedia lagi.

Untuk meningkatkan pengoptimalan latensi dan biaya, migrasikan ke Penayangan online Bigtable. Untuk menyimpan dan menayangkan embedding secara efisien, gunakan Penelusuran Vektor yang dibuat khusus.

Saat menggunakan Penyaluran online yang dioptimalkan, Anda dapat mengonfigurasi penyimpanan online untuk menyajikan fitur dari endpoint publik atau endpoint Private Service Connect khusus.

Membuat toko online untuk Penyaluran online yang dioptimalkan dengan endpoint publik

Gunakan contoh berikut untuk membuat toko online untuk Penyaluran online yang dioptimalkan dengan endpoint publik.

Konsol

Gunakan petunjuk berikut untuk membuat toko online untuk Penyaluran online yang dioptimalkan menggunakan konsol Google Cloud .

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

   Buka halaman Feature Store

2. Klik Toko online untuk membuka bagian Toko online.

3. Klik Buat untuk membuka halaman Buat Toko Online.

4. Tentukan nama untuk toko online.

5. Opsional: Untuk menambahkan label, klik Tambahkan label, lalu tentukan nama dan nilai label. Anda dapat menambahkan beberapa label ke toko online.

6. Di kolom Choose a storage solution for your online store, klik Optimized.

7. 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 dokumentasi referensi API Python.

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_public_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        feature_online_store_id
    )
    return fos

• project: Project ID Anda.
• location: Region tempat Anda ingin membuat instance FeatureOnlineStore, seperti us-central1.
• feature_online_store_id: Nama instance FeatureOnlineStore baru.

REST

Untuk membuat instance toko online, kirim permintaan POST menggunakan metode featureOnlineStores.create.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION_ID: Region tempat Anda ingin membuat instance FeatureOnlineStore, seperti us-central1.
• PROJECT_ID: Project ID Anda.
• FEATUREONLINESTORE_NAME: Nama instance FeatureOnlineStore baru.

Metode HTTP dan URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Meminta isi JSON:

{
  "optimized": {}
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Membuat toko online untuk Penayangan online yang dioptimalkan dengan endpoint Private Service Connect

Gunakan contoh berikut untuk membuat toko online untuk Penyaluran online yang dioptimalkan dengan Private Service Connect.

Python

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

from typing import List

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_private_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
    project_allowlist: List[str],
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        name=feature_online_store_id,
        enable_private_service_connect=True,
        project_allowlist=project_allowlist,
    )
    return fos

• project: Project ID Anda.
• location: Region tempat Anda ingin membuat instance FeatureOnlineStore, seperti us-central1.
• feature_online_store_id: Nama instance FeatureOnlineStore baru.
• project_allowlist: Daftar nama project yang akan dimasukkan dalam daftar yang diizinkan untuk Private Service Connect (PSC).

REST

Untuk membuat instance toko online, kirim permintaan POST menggunakan metode featureOnlineStores.create.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION_ID: Region tempat Anda ingin membuat instance FeatureOnlineStore, seperti us-central1.
• PROJECT_ID: Project ID Anda.
• FEATUREONLINESTORE_NAME: Nama instance FeatureOnlineStore baru.
• PROJECT_NAMES: Daftar nama project yang akan dimasukkan dalam daftar yang diizinkan untuk Private Service Connect (PSC).

Metode HTTP dan URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Meminta isi JSON:

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAMES"]
    }
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Langkah berikutnya

• Pelajari cara membuat tampilan fitur.

• Pelajari cara memperbarui toko online.