Bermigrasi dari Custom Search Site Restricted JSON API

Jika menggunakan Custom Search Site Restricted JSON API dari Programmable Search Engine, Anda dapat membuat dan men-deploy penelusuran berkualitas Google yang dibatasi situs dalam hitungan menit, menggunakan Vertex AI Search. Untuk men-deploy aplikasi, Anda dapat menggunakan widget penelusuran dengan menyalin kode dari konsol Google Cloud langsung ke halaman web—tanpa perlu melakukan coding. Atau, Anda dapat menerapkan deployment API untuk mengontrol tampilan fungsi penelusuran di situs Anda. Untuk informasi selengkapnya tentang penggunaan API, lihat tab REST di Mendapatkan hasil penelusuran untuk aplikasi dengan data situs dan metode servingConfigs.search dalam referensi REST.

Selain cuplikan singkat standar yang ditampilkan Vertex AI Search dengan hasil penelusuran, Anda dapat menambahkan fitur lanjutan ke penelusuran. Hal ini mencakup ringkasan hasil penelusuran yang dihasilkan, penelusuran dengan pertanyaan lanjutan untuk penelusuran berbasis konteks yang memungkinkan pertanyaan lanjutan, dan jawaban ekstraktif untuk teks yang diekstrak yang ditampilkan dengan setiap hasil penelusuran. Untuk mendapatkan fitur lanjutan ini di penelusuran web, Anda memerlukan verifikasi domain dan akan dikenai biaya pengindeksan tambahan.

Anda juga dapat memfilter atau mengurutkan hasil penelusuran dan menerapkan kontrol promosi untuk menampilkan link sebagai hasil yang dipromosikan.

Untuk mengetahui informasi selengkapnya, lihat halaman Harga Vertex AI Agent Builder.

Menyiapkan Vertex AI Search

Untuk menyiapkan Vertex AI Search, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, pada halaman pemilih project, pilih project yang telah Anda gunakan untuk Custom Search Site Restricted JSON API.

  2. Aktifkan Vertex AI Agent Builder.

Membuat aplikasi penelusuran

Untuk membuat aplikasi penelusuran, ikuti langkah-langkah berikut:

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

    Agent Builder

  2. Klik Create app.

  3. Di halaman Create App, klik Create di bagian Search for your website.

  4. Pastikan Fitur edisi Enterprise diaktifkan. Hal ini diperlukan untuk penelusuran situs. Untuk mengetahui informasi selengkapnya, lihat Fitur edisi Enterprise.

  5. Nonaktifkan Fitur LLM lanjutan. Jika dinonaktifkan, Anda akan mendapatkan fungsi yang mirip dengan Custom Search Site Restricted JSON API dari Programmable Search Engine. Nonaktifkan fitur ini jika Anda tidak memerlukan ringkasan penelusuran atau penelusuran dengan tindak lanjut. Untuk informasi selengkapnya, lihat Fitur LLM lanjutan.

  6. Di kolom Nama aplikasi Anda, masukkan nama untuk aplikasi Anda.

  7. Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama umum untuk perusahaan atau organisasi Anda.

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

  9. Di halaman Data Store, klik Create data store.

  10. Di panel Select a data source, pilih Website Content.

  11. Nonaktifkan pengindeksan Pengindeksan situs lanjutan. Menonaktifkannya akan memberi Anda fungsi yang mirip dengan Custom Search Site Restricted JSON API Programmable Search Engine. Nonaktifkan setelan ini jika Anda tidak memerlukan ringkasan penelusuran atau penelusuran dengan tindak lanjut, atau jika Anda tidak memiliki domain yang Anda tentukan. Untuk mengetahui informasi selengkapnya, lihat Pengindeksan situs lanjutan.

  12. Di panel Tentukan pola URL yang akan diindeks, di kolom Situs yang akan disertakan, masukkan pola URL situs yang ingin Anda telusuri, lalu klik Lanjutkan.

  13. Di panel Configure your data store, masukkan nama tampilan untuk penyimpanan data Anda, lalu klik Create.

  14. Di halaman Data Stores, pilih penyimpanan data baru Anda, lalu klik Create.

Men-deploy aplikasi penelusuran

Tentukan cara Anda berencana mengautentikasi aplikasi penelusuran Vertex AI Search: menggunakan OAuth 2.0 atau kunci API. Untuk mengetahui informasi tentang kelebihan dan kekurangan setiap metode, lihat Tentang autentikasi.

Men-deploy aplikasi penelusuran (OAuth 2.0)

Untuk men-deploy aplikasi penelusuran menggunakan autentikasi OAuth 2.0, ikuti langkah-langkah berikut:

  1. Untuk menyiapkan OAuth 2.0, lihat Di Google Cloud di Mengautentikasi ke Vertex AI Agent Builder. Pastikan untuk menambahkan peran Pengguna Discovery Engine atau Pelihat Discovery Engine ke akun layanan.

  2. Deploy aplikasi penelusuran Anda dengan salah satu cara berikut:

Men-deploy aplikasi penelusuran (kunci API)

Untuk men-deploy aplikasi penelusuran menggunakan kunci API untuk autentikasi, ikuti langkah-langkah berikut:

  1. Buat kunci API:

    1. Di Konsol Google Cloud, buka halaman Kredensial.

      Kredensial

    2. Jika Anda belum berada di project, pilih project Anda di daftar project di bagian atas halaman konsol Google Cloud.

    3. Klik Create credentials, lalu pilih API key. Jangan tambahkan batasan perujuk. Beberapa setelan privasi pengguna tidak meneruskan URL perujuk.

      • Catat kunci API yang dihasilkan, yang akan Anda gunakan saat memanggil metode searchLite.

    4. Untuk meningkatkan keamanan, tambahkan pembatasan HTTP ke Kunci API Anda untuk membatasi akses ke layanan Vertex AI Agent Builder di https://discoveryengine.googleapis.com/*.

  2. Deploy aplikasi penelusuran Anda menggunakan API. Lihat Mendapatkan hasil penelusuran untuk aplikasi dengan data situs (kunci API) dan metode servingConfigs.searchLite di referensi REST. Untuk mengurutkan hasil kueri penelusuran web, lihat Mengurutkan hasil penelusuran web.

Tentang autentikasi

Custom Search Site Restricted JSON API dari Programmable Search Engine diautentikasi menggunakan kunci API. Namun, dengan beberapa pengecualian, Vertex AI Search memerlukan OAuth 2.0. Jika ingin terus menggunakan kunci API untuk autentikasi, Anda harus menggunakan metode searchLite melalui panggilan API.

Jika memilih untuk mengautentikasi melalui OAuth 2.0, Anda harus menggunakan metode search dan metode answer untuk membuat kueri situs Anda. Selain itu, Anda dapat men-deploy aplikasi penelusuran melalui widget penelusuran tanpa kode.

Tabel berikut mencantumkan perbedaan antara penggunaan metode searchLite dengan autentikasi kunci API dan metode search dan answer dengan autentikasi OAuth 2.0.

Fitur/Metode Metode searchLite Metode search
Authentication Kunci API OAuth 2.0
Widget penelusuran tersedia ✘ ✔
Ringkasan penelusuran ✔ ✔
Menelusuri situs publik ✔ ✔

Langkah berikutnya