Mulai menggunakan rekomendasi umum

Mulai menggunakan rekomendasi umum

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. Selain itu, 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 generik canggih berdasarkan data Anda sendiri yang dapat menyarankan konten serupa dengan konten yang sedang dilihat pengguna.

Tutorial ini menjelaskan cara membuat tiga aplikasi rekomendasi umum, masing-masing untuk jenis data yang berbeda:

• Data tidak terstruktur dalam bentuk PDF yang ditransfer dari bucket Cloud Storage
• Data terstruktur dalam bentuk NDJSON yang diserap dari bucket Cloud Storage
• Data situs dari URL yang Anda berikan

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

---

Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:

Pandu saya

---

Sebelum memulai

1. 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.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Make sure that billing is enabled for your Google Cloud project.

4. Aktifkan API Vertex AI Agent Builder, Cloud Storage.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Make sure that billing is enabled for your Google Cloud project.

7. Aktifkan API Vertex AI Agent Builder, Cloud Storage.

   Mengaktifkan API

Mengaktifkan Vertex AI Agent Builder

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Baca dan setujui Persyaratan Layanan, lalu klik Lanjutkan dan aktifkan API.

Membuat penyimpanan data

Prosedur ini akan memandu Anda membuat penyimpanan data dan mengupload sampel data yang disediakan. Klik tab untuk jenis penyimpanan data yang ingin Anda buat.

Data situs

Catatan: Untuk menggunakan rekomendasi dengan situs, Anda harus menggunakan domain yang kepemilikannya dapat Anda verifikasi. Jika Anda tidak memiliki domain, lewati bagian ini.

1. Buka halaman Penyimpanan Data.

2. Klik Create data store.

3. Di halaman Pilih sumber data, pilih Konten Situs.

4. Di halaman Menentukan situs untuk penyimpanan data Anda, masukkan URL situs yang ingin Anda sertakan dalam aplikasi rekomendasi. Sertakan satu URL per baris, tanpa pemisah koma.

5. Klik Lanjutkan.

6. Di halaman Konfigurasi penyimpanan data Anda, masukkan nama tampilan untuk penyimpanan data Anda, lalu klik Buat.

7. Di halaman Data Stores, pilih penyimpanan data baru, lalu klik Create untuk membuat aplikasi.

8. Di halaman Data, buka tab Aktivitas untuk melihat status penyerapan data Anda. Impor selesai akan ditampilkan di kolom Status saat proses impor selesai. Anda mungkin perlu mengklik Refresh untuk melihat Impor selesai.

9. Klik tab Dokumen untuk melihat dokumen yang diimpor.

Data terstruktur

1. Buka halaman Penyimpanan Data.

2. Klik Create data store.

3. Di halaman Pilih sumber data, pilih Cloud Storage.

4. Di halaman Impor data dari Cloud Storage, pilih Data terstruktur (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 kunci sebagai berikut:

   Nama kolom	Properti kunci
   homepage	uri
   original_title	title
   overview	description

   Kemudian, klik Lanjutkan.

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

10. Klik nama penyimpanan data Anda.

11. Di halaman Data, buka tab Aktivitas untuk melihat status penyerapan data Anda. Impor selesai akan 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 Refresh untuk melihat Impor selesai.

12. Klik tab Dokumen untuk melihat dokumen yang diimpor.

Data tidak terstruktur

1. Buka halaman Penyimpanan Data.

2. Klik Create data store.

3. Di halaman Pilih sumber data, pilih Cloud Storage.

4. Di halaman Impor data dari Cloud Storage, pastikan Folder dipilih.

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

   cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs
   

   Bucket Cloud Storage ini berisi PDF laporan penghasilan dari situs investor Alphabet.

6. Pilih Dokumen tidak terstruktur, lalu klik Lanjutkan.

7. Masukkan nama untuk penyimpanan data Anda, lalu klik Buat.

8. Pilih penyimpanan data yang baru saja Anda buat, lalu klik Create untuk membuat aplikasi.

9. Di halaman Data penyimpanan data Anda, buka tab Aktivitas untuk melihat status penyerapan data Anda. Impor selesai akan 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 Refresh untuk melihat Impor selesai.

10. Klik tab Dokumen untuk melihat dokumen yang diimpor.

Buat aplikasi

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

1. Buka halaman Aplikasi.

2. Klik Create app.

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. Dalam daftar penyimpanan data, pilih penyimpanan data yang Anda buat sebelumnya.

7. Klik Create.

Melihat pratinjau aplikasi Anda

Data situs

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

2. Klik kolom URI. Daftar URL dari situs Anda akan muncul.

3. Klik URL halaman web yang ingin Anda dapatkan rekomendasinya. Atau, masukkan URL dari situs Anda ke kolom URL.

4. Klik Dapatkan rekomendasi. Daftar URL untuk halaman web yang direkomendasikan akan muncul.

5. Klik URL untuk melihat halaman web.

Data terstruktur

1. Di menu navigasi, klik Preview 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 Document ID. 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.

Data tidak terstruktur

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

2. Klik kolom Document ID. Daftar ID dokumen akan muncul.

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

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

5. Klik dokumen untuk mendapatkan detail dokumen.

Men-deploy aplikasi

Tidak ada widget rekomendasi untuk men-deploy aplikasi. Untuk menguji aplikasi 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. Tempel ID dokumen yang Anda salin sebelumnya ke kolom Document ID.

4. Biarkan kolom User Pseudo ID 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 tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

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

Langkah selanjutnya

• Pengantar Vertex AI Search
• Tentang aplikasi dan penyimpanan data