Membuat aplikasi 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).

Halaman ini menjelaskan cara membuat aplikasi rekomendasi umum.

Konsol

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

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

   Agent Builder

2. Di halaman Aplikasi, klik Buat aplikasi.

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

4. Di kolom Nama aplikasi Anda, 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 Penyimpanan Data, pilih penyimpanan data yang sebelumnya Anda buat atau buat penyimpanan data baru. Lakukan salah satu hal berikut:

   • Pilih penyimpanan data yang ada, jika tersedia. Penyimpanan data hanya dapat disertakan ke satu aplikasi, dan tidak dapat dihapus dari aplikasi nanti.

   • Buat penyimpanan data baru dan serap 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 datastore baru Anda. Untuk mengetahui informasi selengkapnya tentang cara membuat penyimpanan data, lihat Membuat penyimpanan data rekomendasi umum.

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 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 umum.
   • Repositori data Anda memiliki penelusuran situs dasar, sedangkan aplikasi rekomendasi umum memerlukan repositori data dengan pengindeksan situs lanjutan.

9. Klik Create.

REST

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

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 Agent Builder dan di menu navigasi, klik Data Stores.

      Buka halaman Data Store

   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. Penyimpanan data hanya dapat dilampirkan ke satu aplikasi dan tidak dapat dihapus dari aplikasi nanti.

   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 project Google Cloud 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 selanjutnya

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