Membuat aplikasi rekomendasi kustom

Catatan: Fitur ini adalah penawaran Pratinjau, yang tunduk pada "Persyaratan Penawaran Pra-GA" dari Persyaratan Khusus Layanan GCP. Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran. Selanjutnya, dengan menggunakan fitur ini, Anda menyetujui persyaratan dan ketentuan Pratinjau AI Generatif ("Persyaratan Pratinjau"). Untuk fitur ini, Anda dapat memproses data pribadi sebagaimana diuraikan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada batasan dan kewajiban yang berlaku dalam Perjanjian (sebagaimana didefinisikan dalam Persyaratan Pratinjau).

Halaman ini menjelaskan cara membuat aplikasi rekomendasi kustom.

Konsol

Untuk menggunakan konsol Google Cloud guna membuat aplikasi rekomendasi kustom, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di halaman Aplikasi, klik Buat aplikasi.

3. Di halaman Create App, pada bagian Recommendations engine, klik Create.

4. Di kolom Your app name, masukkan nama untuk aplikasi Anda. ID aplikasi Anda akan muncul di bawah nama mesin.

5. Opsional: Klik Edit untuk mengedit ID aplikasi Anda.

6. Klik Lanjutkan.

7. Untuk terhubung ke penyimpanan data, di halaman Data Stores, pilih penyimpanan data yang berisi data terstruktur atau pilih untuk membuat penyimpanan data. Lakukan salah satu hal berikut:

   • Pilih penyimpanan data yang ada, jika tersedia. Penyimpanan data hanya dapat dilampirkan ke satu aplikasi, dan tidak dapat dihapus dari aplikasi tersebut di kemudian hari.

   • Buat penyimpanan data terstruktur baru dan masukkan data ke dalamnya. Lakukan ini dengan mengklik Create data store dan mengikuti langkah-langkah di panel Create a new data store yang terbuka. Kemudian, pilih penyimpanan data baru Anda. Untuk mengetahui informasi selengkapnya tentang cara membuat penyimpanan data, lihat Membuat penyimpanan data rekomendasi kustom.

8. Opsional: Untuk melihat daftar penyimpanan data yang tidak tersedia, klik Pelajari alasannya.

   Tabel ditampilkan dengan daftar penyimpanan data dan alasan mengapa penyimpanan data tersebut tidak tersedia. Berikut beberapa alasan mengapa penyimpanan data mungkin tidak tersedia:

   • Jenis penyimpanan data Anda hanya mengizinkan koneksi ke satu aplikasi dan penyimpanan data sudah terhubung.
   • Penyimpanan data dan aplikasi Anda berada di region yang berbeda.
   • Penyimpanan data dan aplikasi Anda memiliki jenis yang berbeda. Misalnya, Anda tidak dapat menghubungkan penyimpanan data media ke aplikasi rekomendasi kustom.
   • Penyimpanan data Anda memiliki penelusuran situs dasar, sedangkan aplikasi rekomendasi kustom memerlukan penyimpanan data dengan pengindeksan situs lanjutan.

9. Klik Buat.

REST

Sebelum menggunakan command line untuk membuat aplikasi, Anda harus memiliki penyimpanan data yang ada. Jika Anda belum memiliki penyimpanan data, buat penyimpanan data dengan mengikuti langkah-langkah di Membuat penyimpanan data rekomendasi kustom.

Catatan: Fitur ini bersifat eksperimental.

Untuk menggunakan command line guna membuat aplikasi rekomendasi, ikuti langkah-langkah berikut:

1. Temukan ID penyimpanan data Anda. Jika Anda sudah memiliki ID penyimpanan data, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman AI Applications dan di menu navigasi, klik Data Stores.

      Buka halaman Data Stores

   2. Klik nama penyimpanan data Anda.

   3. Di halaman Data untuk penyimpanan data Anda, dapatkan ID penyimpanan data.

2. Buat aplikasi dan hubungkan ke penyimpanan data terstruktur. Penyimpanan data hanya dapat dilampirkan ke satu aplikasi dan tidak dapat dihapus dari aplikasi tersebut di kemudian hari.

   Istilah Penting: Di Vertex AI Search, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • APP_ID: ID aplikasi rekomendasi yang ingin Anda buat.
   • APP_DISPLAY_NAME: nama tampilan aplikasi rekomendasi yang ingin Anda buat.
   • DATA_STORE_ID: ID penyimpanan data rekomendasi yang ada yang ingin Anda tambahkan ke aplikasi rekomendasi.

Langkah berikutnya

• Untuk melihat pratinjau tampilan rekomendasi, lihat bagian Mendapatkan rekomendasi.