Memulai penelusuran umum

Vertex AI Search menyatukan kemampuan pengambilan informasi yang mendalam, natural language processing yang canggih, dan pemrosesan bahasa besar terbaru untuk memahami intent pengguna dan menampilkan hasil yang paling relevan bagi pengguna.

Dengan Vertex AI Search, Anda dapat membuat aplikasi untuk melakukan penelusuran dan memberikan rekomendasi. Vertex AI Search juga memiliki kemampuan khusus untuk beberapa industri, seperti media, layanan kesehatan, dan retail.

Tutorial ini berfokus pada pembuatan aplikasi penelusuran untuk data umum; yaitu data yang tidak spesifik untuk vertikal industri.

Tutorial ini menjelaskan cara membuat aplikasi penelusuran untuk berbagai jenis data:

  • Data situs dari crawling cloud.google.com/generative-ai-app-builder/
  • Data terstruktur dalam bentuk set data berformat NDJSON yang diserap dari bucket Cloud Storage
  • Data tidak terstruktur dalam bentuk PDF yang ditransfer dari bucket Cloud Storage

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.

    Buka pemilih project

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

  4. Aktifkan API Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage.

    Mengaktifkan API

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

    Buka pemilih project

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

  7. Aktifkan API Vertex AI Agent Builder (Discovery Engine), BigQuery, 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

Pertama, Anda akan membuat penyimpanan data yang berisi data yang akan diindeks oleh aplikasi penelusuran Anda.

Klik tab untuk jenis data yang ingin Anda masukkan ke penyimpanan data: situs, terstruktur, atau tidak terstruktur.

Data situs

  1. Buka halaman Create data store.

    Agent Builder - Membuat penyimpanan data

  2. Di panel Pilih sumber data, pilih Konten situs.

  3. Di panel Tentukan situs untuk penyimpanan data Anda, pastikan Pengindeksan situs lanjutan dinonaktifkan.

  4. Di kolom Situs yang akan disertakan, masukkan:

    cloud.google.com/generative-ai-app-builder/*
    
  5. Klik Lanjutkan.

  6. Di panel Configure your data store, pilih global (Global) sebagai lokasi untuk penyimpanan data Anda.

  7. Masukkan nama untuk penyimpanan data Anda. Catat ID yang dihasilkan. Anda akan memerlukannya nanti.

  8. Klik Create.

Data terstruktur

  1. Buka halaman Create data store.

    Agent Builder - Membuat penyimpanan data

  2. Di panel Select a data source, pilih Cloud Storage.

  3. Di panel Impor data dari Cloud Storage, pilih Data terstruktur (JSONL).

  4. Pastikan File dipilih.

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

  6. Klik Lanjutkan.

  7. Tetapkan properti kunci sebagai berikut:

    Nama kolom Properti kunci
    homepage uri
    overview description

    Kemudian, klik Lanjutkan.

  8. Di panel Configure your data store, pilih global (Global) sebagai lokasi untuk penyimpanan data Anda.

  9. Masukkan nama untuk penyimpanan data Anda. Catat ID yang dihasilkan. Anda akan memerlukannya nanti.

  10. Klik Create.

Data tidak terstruktur

  1. Buka halaman Create data store.

    Agent Builder - Membuat penyimpanan data

  2. Di panel Select a data source, pilih Cloud Storage.

  3. Di panel Impor data dari Cloud Storage, pilih Dokumen tidak terstruktur (PDF, HTML, TXT, dan lainnya).

  4. 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. Di panel Configure your data store, pilih global (Global) sebagai lokasi untuk penyimpanan data Anda.

  7. Masukkan nama untuk penyimpanan data Anda. Catat ID yang dihasilkan. Anda akan memerlukannya nanti.

  8. Klik Create.

Membuat aplikasi penelusuran

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

Data situs

  1. Buka halaman Create App.

    Agent Builder - Create App

  2. Di bagian Telusuri situs Anda, klik Buat.

  3. Pastikan Fitur edisi Enterprise diaktifkan.

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

  5. Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama perusahaan atau organisasi. Untuk tutorial ini, Anda dapat menggunakan Google Cloud, karena aplikasi akan menelusuri situs Google Cloud.

  6. Pilih global (Global) sebagai lokasi untuk aplikasi Anda, lalu klik Lanjutkan.

  7. Di daftar penyimpanan data, pilih penyimpanan data yang Anda buat sebelumnya, lalu klik Buat.

  8. Buka halaman Data aplikasi Anda untuk melihat daftar situs yang diindeks dan mengubahnya jika diperlukan.

Data terstruktur

  1. Buka halaman Create App.

    Agent Builder - Create App

  2. Di bagian Telusuri situs Anda, klik Buat.

  3. Pastikan Fitur edisi Enterprise diaktifkan.

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

  5. Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama perusahaan atau organisasi. Untuk tutorial ini, Anda dapat menggunakan Cymbal Cinemas, karena aplikasi akan menelusuri penyimpanan data film.

  6. Pilih global (Global) sebagai lokasi untuk aplikasi Anda, lalu klik Lanjutkan.

  7. Di daftar penyimpanan data, pilih penyimpanan data yang Anda buat sebelumnya, lalu klik Buat.

  8. Di halaman Data aplikasi, klik 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.

  9. Klik tab Dokumen untuk melihat jumlah dokumen yang diimpor.

Data tidak terstruktur

  1. Buka halaman Create App.

    Agent Builder - Create App

  2. Di bagian Telusuri situs Anda, klik Buat.

  3. Pastikan Fitur perusahaan diaktifkan.

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

  5. Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama perusahaan atau organisasi. Untuk tutorial ini, Anda dapat menggunakan Alphabet, karena aplikasi akan menelusuri dokumen Alphabet.

  6. Pilih global (Global) sebagai lokasi untuk aplikasi Anda, lalu klik Lanjutkan.

  7. Di daftar penyimpanan data, pilih penyimpanan data yang Anda buat sebelumnya, lalu klik Buat.

  8. Di halaman Data aplikasi, klik tab Aktivitas untuk melihat status penyerapan data Anda. Setelah proses impor selesai, kolom Status akan menampilkan Impor selesai. Untuk set data ini, proses impor biasanya memerlukan waktu dua hingga tiga menit. Anda mungkin perlu mengklik Refresh untuk melihat status Impor selesai.

  9. Klik tab Dokumen untuk melihat jumlah dokumen yang diimpor.

Melihat pratinjau aplikasi Anda

Data situs

  1. Di halaman Apps, klik nama aplikasi baru Anda.

  2. Di menu navigasi, klik Preview untuk menguji aplikasi penelusuran.

  3. Opsional: Klik ikon tampilan untuk beralih antara tampilan seluler dan tampilan desktop.

  4. Di kotak penelusuran, telusuri Vertex AI Search untuk melihat hasil tentang produk.

Data terstruktur

  1. Di halaman Apps, klik nama aplikasi baru Anda.

  2. Di menu navigasi, klik Preview untuk menguji aplikasi penelusuran.

  3. Opsional: Klik ikon tampilan untuk beralih antara tampilan seluler dan tampilan desktop.

  4. Di kotak penelusuran, masukkan trains, lalu tekan Enter untuk mendapatkan hasil film yang terkait dengan kereta api.

Data tidak terstruktur

  1. Di halaman Apps, klik nama aplikasi baru Anda.

  2. Di menu navigasi, klik Preview untuk menguji aplikasi penelusuran.

  3. Opsional: Klik ikon tampilan untuk beralih antara tampilan seluler dan tampilan desktop.

  4. Di kotak penelusuran, masukkan Google, lalu tekan Enter untuk melihat hasilnya.

Mengonfigurasi widget penelusuran

  1. Di menu navigasi, klik Konfigurasi.

  2. Di tab UI, konfigurasikan setelan untuk aplikasi penelusuran.

    Konfigurasi UI yang berbeda tersedia untuk berbagai jenis data. Untuk informasi selengkapnya, lihat Mengonfigurasi hasil untuk widget penelusuran.

  3. Jika Anda mengubah konfigurasi di tab UI, klik Simpan dan publikasikan.

  4. Buka tab Pelengkapan otomatis untuk mengonfigurasi setelan tertentu untuk pelengkapan otomatis.

    Untuk informasi selengkapnya, lihat Mengonfigurasi pelengkapan otomatis.

  5. Buka tab Advanced untuk mengonfigurasi fitur lanjutan.

    Untuk informasi selengkapnya, lihat Tentang fitur lanjutan.

Men-deploy aplikasi penelusuran

  1. Di halaman Aplikasi, klik nama aplikasi yang ingin Anda deploy.

  2. Di menu navigasi, klik Integration.

  3. Pastikan tab Widget dipilih.

  4. Pilih Berbasis JWT atau OAuth sebagai jenis otorisasi widget.

  5. Di kolom Domain, masukkan nama domain untuk halaman web tempat Anda akan menempatkan widget. Misalnya, jika Anda akan menyalin widget ke halaman web example.com/ai.html, masukkan example.com sebagai domain.

  6. Klik Tambahkan, lalu klik Simpan.

  7. Salin cuplikan kode yang diberikan di bagian Salin kode berikut ke aplikasi web Anda.

  8. Di codebase Anda, buat token otorisasi.

  9. Untuk meneruskan token otorisasi ke widget, gunakan cuplikan kode "Setasikan token otorisasi" yang disediakan di bagian Salin kode berikut ke aplikasi web Anda dan ganti teks <JWT or OAuth token provided by your backend> dengan token otorisasi Anda.

  10. Uji aplikasi yang di-deploy. Anda dapat menyesuaikan konfigurasi lebih lanjut dengan mengikuti langkah-langkah "Mengonfigurasi widget penelusuran". Pastikan untuk mengklik Simpan dan publikasikan agar perubahan diterapkan pada widget yang di-deploy.

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