Bermigrasi dari Custom Search Site Restricted JSON API

Jika Anda menggunakan Custom Search Site Restricted JSON API 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 memerlukan coding. Atau, Anda dapat menerapkan deployment API untuk mengontrol tampilan fungsi penelusuran di situs Anda. Untuk mengetahui 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 Anda. Fitur ini mencakup ringkasan hasil penelusuran yang dihasilkan, penelusuran dengan tindak lanjut untuk penelusuran yang memahami konteks yang memungkinkan pertanyaan tindak lanjut, dan jawaban ekstraktif untuk teks yang diekstrak yang ditampilkan dengan setiap hasil penelusuran. Untuk mendapatkan fitur lanjutan ini untuk penelusuran web Anda, Anda harus melakukan 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 Aplikasi AI.

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 Aplikasi AI.

Membuat aplikasi penelusuran

Untuk membuat aplikasi penelusuran, ikuti langkah-langkah berikut:

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

    Aplikasi AI

  2. Klik Buat aplikasi.

  3. Di halaman Create App, pada bagian Site search with AI mode, klik Create.

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

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

  6. Di kolom Your app name, masukkan nama untuk aplikasi Anda.

  7. Di kolom External name of your company or organization, masukkan nama umum untuk perusahaan atau organisasi Anda.

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

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

  10. Di panel Pilih sumber data, pilih Konten Situs.

  11. Menonaktifkan pengindeksan Pengindeksan situs lanjutan. Jika fitur ini dinonaktifkan, Anda akan mendapatkan fungsi yang mirip dengan Custom Search Site Restricted JSON API dari 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 untuk 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.

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 dalam Mengautentikasi ke Aplikasi AI. 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 Credentials.

      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 dibuat, yang akan Anda gunakan saat memanggil metode searchLite.

    4. Untuk meningkatkan keamanan, tambahkan pembatasan HTTP ke Kunci API Anda untuk membatasi akses ke layanan Aplikasi AI 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 Anda, lihat Mengurutkan hasil penelusuran web.

Tentang autentikasi

Custom Search Site Restricted JSON API Programmable Search Engine melakukan autentikasi menggunakan kunci API. Meskipun, 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 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 serta 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