Mulai menggunakan rekomendasi kustom

Mulai menggunakan 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).

Anda dapat dengan cepat membuat aplikasi rekomendasi kustom canggih berdasarkan data Anda sendiri yang dapat menyarankan konten serupa dengan konten yang sedang dilihat pengguna.

Tutorial ini menjelaskan cara membuat aplikasi rekomendasi kustom untuk data terstruktur. Dalam hal ini, data terstruktur berbentuk NDJSON yang diserap dari bucket Cloud Storage.

Sebelum mengikuti tutorial ini, pastikan Anda telah melakukan langkah-langkah di bagian Sebelum Anda memulai.

---

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Pandu saya

---

Sebelum memulai

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the AI Applications, Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Make sure that you have the following role or roles on the project: Discovery Engine Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Buka IAM
2. Pilih project.
3. Klik Grant access.

4. Di kolom New principals, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

5. Di daftar Select a role, pilih peran.
6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
7. Klik Simpan.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the AI Applications, Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Make sure that you have the following role or roles on the project: Discovery Engine Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Buka IAM
2. Pilih project.
3. Klik Grant access.

4. Di kolom New principals, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

5. Di daftar Select a role, pilih peran.
6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
7. Klik Simpan.

Mengaktifkan Aplikasi AI

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

   Aplikasi AI

2. Opsional: Klik Izinkan Google mengambil sampel input dan respons model secara selektif.

3. Klik Continue and activate the API.

Membuat penyimpanan data

Prosedur ini memandu Anda membuat penyimpanan data dan mengupload contoh data yang diberikan.

1. Buka halaman Data Stores.

2. Klik Buat penyimpanan data.

3. Di halaman Select a data source, pilih Cloud Storage.

4. Di halaman Import data from Cloud Storage, pilih Structured data (JSONL).

5. Klik File.

6. Di kolom gs://, masukkan nilai berikut:

   cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
   

   Bucket Cloud Storage ini berisi file film berformat NDJSON yang disediakan oleh Kaggle.

7. Klik Lanjutkan.

8. Tetapkan properti utama sebagai berikut:

   Nama kolom	Properti kunci
   homepage	uri
   overview	description

   Kemudian, klik Lanjutkan.

9. Masukkan nama tampilan untuk penyimpanan data Anda, lalu klik Buat.

10. Klik nama penyimpanan data Anda.

11. Di halaman Data, buka tab Aktivitas untuk melihat status penyerapan data Anda. Impor selesai ditampilkan di kolom Status saat proses impor selesai. Untuk set data ini, proses ini biasanya memerlukan waktu dua hingga tiga menit. Anda mungkin perlu mengklik Muat ulang untuk melihat Impor selesai.

12. Klik tab Dokumen untuk melihat dokumen yang diimpor.

Buat aplikasi

Selanjutnya, Anda membuat aplikasi rekomendasi dan menautkan penyimpanan data yang Anda buat sebelumnya.

1. Buka halaman Aplikasi.

2. Klik Buat aplikasi.

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

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

5. Klik Lanjutkan.

6. Di daftar penyimpanan data, pilih penyimpanan data yang Anda buat sebelumnya.

7. Klik Buat.

Melihat pratinjau aplikasi Anda

1. Di menu navigasi, klik Pratinjau untuk menguji aplikasi.

2. Jika Anda melihat pesan "Anda akan dapat melihat pratinjau mesin rekomendasi di sini. Kami masih menyiapkan mesin Anda, harap periksa kembali nanti", tunggu dan muat ulang halaman secara berkala. Anda mungkin harus menunggu beberapa jam atau hingga hari berikutnya untuk melihat pratinjau data.

3. Klik kolom ID Dokumen. Daftar ID dokumen akan muncul.

4. Klik ID dokumen untuk dokumen yang rekomendasinya Anda inginkan. Atau, masukkan ID dokumen ke kolom ID Dokumen.

5. Klik Dapatkan rekomendasi. Daftar dokumen yang direkomendasikan akan muncul.

6. Klik dokumen untuk mendapatkan detail dokumen.

Men-deploy aplikasi Anda

Tidak ada widget rekomendasi untuk men-deploy aplikasi Anda. Untuk menguji aplikasi Anda sebelum deployment:

1. Buka halaman Data dan salin ID dokumen.

2. Buka halaman Integrasi. Halaman ini menyertakan contoh perintah untuk metode servingConfigs.recommend di REST API.

3. Tempelkan ID dokumen yang Anda salin sebelumnya ke kolom Document ID.

4. Biarkan kolom ID Pseudo Pengguna apa adanya.

5. Salin contoh permintaan dan jalankan di Cloud Shell.

   Hasilnya adalah ID dokumen yang direkomendasikan berdasarkan dokumen yang Anda pilih.

Untuk mendapatkan bantuan dalam mengintegrasikan aplikasi rekomendasi ke dalam aplikasi web Anda, lihat contoh kode untuk C#, Go, Java, Node.js, PHP, dan Ruby di Mendapatkan rekomendasi untuk aplikasi.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

1. Untuk menghindari biaya yang tidak perlu, gunakan Google Cloud console untuk menghapus project Anda jika tidak lagi diperlukan. Google Cloud
2. Jika Anda membuat project baru untuk mempelajari Aplikasi AI dan Anda tidak lagi memerlukan project tersebut, hapus project tersebut.
3. Jika Anda menggunakan project Google Cloud yang sudah ada, hapus resource yang Anda buat untuk menghindari tagihan pada akun Anda. Untuk mengetahui informasi selengkapnya, lihat Menghapus aplikasi.
4. Ikuti langkah-langkah di Menonaktifkan Vertex AI Search.

Langkah berikutnya

• Pengantar Vertex AI Search
• Tentang aplikasi dan penyimpanan data