Memulai penelusuran kustom

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

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

Tutorial ini berfokus pada pembuatan aplikasi penelusuran untuk data kustom, yaitu data yang tidak khusus 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 diserap dari bucket Cloud Storage

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

Untuk mengikuti panduan langkah demi langkah untuk tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Pandu saya

Sebelum memulai

  1. Login ke akun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Agent Search (Discovery Engine), BigQuery, Cloud Storage APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. Make sure that you have the following role or roles on the project: Discovery Engine Admin

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Verify that billing is enabled for your Google Cloud project.

  8. Enable the Agent Search (Discovery Engine), BigQuery, Cloud Storage APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  9. Make sure that you have the following role or roles on the project: Discovery Engine Admin

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

Mengaktifkan Agent Search

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

    AI Applications

  2. Opsional: Klik Allow Google to selectively sample model input and responses.

  3. Klik Continue and activate the 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.

    AI Applications - Create data store

  2. Di panel Select a data source, pilih Website content.

  3. Di panel Specify the websites for your data store, pastikan Advanced website indexing dinonaktifkan.

  4. Di kolom Sites to include, 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 Buat.

Data terstruktur

  1. Buka halaman Create data store.

    AI Applications - Create data store

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

  3. Di panel Import data from Cloud Storage, pilih Structured data (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 berformat NDJSON dari film yang disediakan oleh Kaggle.

  6. Klik Lanjutkan.

  7. Tetapkan properti kunci sebagai berikut:

    Nama kolom Properti kunci
    homepage uri
    overview description

    Lalu, 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 Buat.

Data tidak terstruktur

  1. Buka halaman Create data store.

    AI Applications - Create data store

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

  3. Di panel Import data from Cloud Storage , pilih Unstructured documents (PDF, HTML, TXT, and more).

  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 pendapatan dari situs investor Alphabet.

  6. Klik Lanjutkan.

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

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

  9. Klik Buat.

Membuat aplikasi penelusuran

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

Data situs

  1. Buka halaman Create App.

    AI Applications - Create App

  2. Di bagian Site search with AI mode, klik Create.

  3. Pastikan Enterprise edition features diaktifkan.

  4. Di kolom Your app name, masukkan nama untuk aplikasi Anda. ID aplikasi akan muncul di bawah nama aplikasi.

  5. Di kolom External name of your company or organization, masukkan nama perusahaan atau organisasi. Untuk tutorial ini, Anda dapat menggunakan Google Cloud, karena aplikasi akan menelusuri Google Cloud situs.

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

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

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

Data terstruktur

  1. Buka halaman Create App.

    AI Applications - Create App

  2. Di bagian Site search with AI mode, klik Create.

  3. Pastikan Enterprise edition features diaktifkan.

  4. Di kolom Your app name, masukkan nama untuk aplikasi Anda. ID aplikasi akan muncul di bawah nama aplikasi.

  5. Di kolom External name of your company or organization, 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 Continue.

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

  8. Di halaman Data aplikasi Anda, klik tab Activity untuk melihat status penyerapan data Anda. Import completed akan ditampilkan di kolom Status saat proses impor selesai. Untuk set data ini, biasanya diperlukan waktu dua hingga tiga menit. Anda mungkin perlu mengklik Refresh untuk melihat Import completed.

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

Data tidak terstruktur

  1. Buka halaman Create App.

    AI Applications - Create App

  2. Di bagian Site search with AI mode, klik Create.

  3. Pastikan Enterprise features diaktifkan.

  4. Di kolom Your app name, masukkan nama untuk aplikasi Anda. ID aplikasi akan muncul di bawah nama aplikasi.

  5. Di kolom External name of your company or organization, 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 Continue.

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

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

  9. Klik tab Documents 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, lakukan penelusuran untuk Agent Search guna 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.

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 hasil Anda.

Mengonfigurasi widget penelusuran

  1. Di menu navigasi, klik Configurations.

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

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

  3. Jika Anda mengubah konfigurasi di tab UI, klik Save and publish.

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

    Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pelengkapan otomatis.

  5. Buka tab Response Settings untuk mengonfigurasi fitur lanjutan.

    Untuk mengetahui informasi selengkapnya, lihat Tentang fitur lanjutan.

Men-deploy aplikasi penelusuran

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

  2. Di menu navigasi, klik Integration.

  3. Pastikan tab Widget dipilih.

  4. Pilih JWT or OAuth based 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 Add, lalu klik Save.

  7. Salin cuplikan kode yang disediakan di bagian Copy the following code to your web application.

  8. Dalam codebase Anda, buat token otorisasi.

  9. Untuk meneruskan token otorisasi ke widget Anda, gunakan cuplikan kode "Set authorization token" yang disediakan di bagian Copy the following code to your web application 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 Save and publish agar perubahan diterapkan pada widget yang di-deploy.

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Google Cloud

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

Langkah berikutnya