Jika Anda baru menggunakan Penelusuran Agen, sebaiknya ikuti tutorial Mulai menggunakan penelusuran kustom untuk membuat aplikasi contoh.
Siapkan project, aktifkan Penelusuran Agen, dan siapkan kontrol akses untuk project Anda. Google Cloud Anda dapat menggunakan project yang sudah ada jika Anda sudah memilikinya. Google Cloud
Tindakan
- Tinjau Sebelum memulai dan pastikan Anda telah menyelesaikan langkah-langkahnya.
Tentukan jenis data yang akan Anda sediakan di aplikasi penelusuran dan siapkan untuk diimpor ke Penelusuran Agen.
Anda dapat mendasarkan penyimpanan data pada jenis data berikut:
- Data tidak terstruktur. Dokumen (seperti file PDF, HTML, dan TXT) yang disimpan di Cloud Storage. Secara opsional, Anda dapat memberikan metadata dalam file JSON atau dalam tabel BigQuery.
- Data terstruktur. Data yang disediakan dengan skema tertentu. Misalnya, Anda dapat memberikan data dalam tabel BigQuery, sebagai file JSON di Cloud Storage, atau dari konektor pihak ketiga seperti Jira.
Tindakan
Tinjau informasi tentang data yang didukung dan hubungan antara aplikasi dan penyimpanan data di Tentang aplikasi dan penyimpanan data.
Siapkan data Anda sesuai dengan persyaratan dalam Menyiapkan data untuk penyerapan.
Jika Anda perlu menyiapkan kontrol akses untuk membatasi data yang dapat dilihat pengguna di hasil aplikasi penelusuran Anda, tinjau prasyarat dan ikuti petunjuk untuk jenis penyedia identitas dan sumber data Anda di Menggunakan kontrol akses sumber data.
Buat penyimpanan data, lalu impor data Anda ke dalamnya, atau siapkan konektor pihak ketiga sebagai sumber data yang disinkronkan.
Cara Anda mengimpor data bergantung pada tempat asal impor. Misalnya, jika data Anda ada di Cloud Storage, Anda dapat mengimpornya menggunakan konsol atau API dengan memberikan lokasi bucket data Anda.
Tindakan
- Ikuti petunjuk untuk sumber data Anda di Membuat penyimpanan data penelusuran.
Buat aplikasi penelusuran kustom Anda dan hubungkan ke penyimpanan data baru Anda.
Tindakan
Penelusuran Agen untuk penelusuran kustom mendukung dua model harga:
- Umum: Model berbasis konsumsi bayar sesuai penggunaan.
- Dapat dikonfigurasi: Model harga campuran yang memungkinkan Anda memisahkan kemampuan dan membuat paket langganan yang lebih sesuai dengan kasus penggunaan spesifik Anda. Model harga ini memungkinkan Anda membayar hanya untuk fitur yang Anda butuhkan dan memanfaatkan kemampuan canggihnya. Layanan ini menawarkan dua langganan dan add-on opsional. Setelah mengaktifkan model harga ini di tingkat project, Anda dapat memilih harga yang dapat dikonfigurasi untuk aplikasi dan penyimpanan data.
Tindakan
Secara default, project disetel ke model bayar sesuai penggunaan. Namun, untuk beralih ke harga yang dapat dikonfigurasi, lakukan hal berikut:
- Ikuti petunjuk untuk Menyiapkan harga yang dapat dikonfigurasi untuk penelusuran khusus.
Penelusuran Agen menyediakan banyak opsi konfigurasi. Beberapa opsi bergantung pada apakah Anda berencana men-deploy widget penelusuran.
Tindakan
Bergantung pada kasus penggunaan Anda dan apakah Anda berencana men-deploy widget penelusuran siap pakai atau mengintegrasikan panggilan API penelusuran ke dalam kode Anda sendiri, Penelusuran Agen menyediakan beberapa opsi untuk konfigurasi.
Anda dapat menyematkan widget penelusuran ke situs Anda. Widget ini otomatis menyediakan kotak penelusuran dan antarmuka penelusuran yang dapat diperluas. Jika Anda berencana men-deploy widget penelusuran, konfigurasi hal berikut:
Hasil widget penelusuran. Lihat Mengonfigurasi hasil untuk widget penelusuran.
Faset widget penelusuran (Pratinjau). Lihat Mengonfigurasi faset untuk widget penelusuran.
Jika Anda berencana mengintegrasikan panggilan API penelusuran ke server atau aplikasi Anda, bukan menggunakan widget, Anda dapat mengonfigurasi setelan penelusuran menggunakan opsi berikut:
Setelan kolom. Untuk data terstruktur atau data tidak terstruktur dengan metadata, perbarui setelan kolom untuk menyempurnakan cara Penelusuran Agen menggunakan metadata untuk penelusuran. Lihat Mengonfigurasi kolom untuk penelusuran.
Pelengkapan otomatis. Bergantung pada data Anda, siapkan saran pelengkapan otomatis berdasarkan konten dokumen, kolom, histori penelusuran, atau peristiwa pengguna. Lihat Mengonfigurasi pelengkapan otomatis.
Kontrol penayangan. Mengontrol kapan hasil penelusuran dipromosikan, disembunyikan, difilter, atau dialihkan, atau apakah kueri tertentu dikaitkan dengan kueri lain. Lihat Mengonfigurasi kontrol penayangan.
Penyesuaian penelusuran (Pratinjau). Sesuaikan model penelusuran dengan data pelatihan Anda sendiri. Lihat Meningkatkan hasil penelusuran dengan penyesuaian penelusuran.
Embedding kustom (Pratinjau). Jika telah membuat embedding sendiri, Anda mungkin lebih suka menggunakannya daripada embedding yang dihasilkan oleh Penelusuran Agen untuk memperkaya penelusuran dengan konteks tambahan. Fitur ini tersedia untuk penyimpanan data dengan data terstruktur atau data tidak terstruktur dengan metadata. Lihat Menggunakan penyematan kustom.
Jika Anda berencana men-deploy aplikasi dengan mengintegrasikan panggilan API penelusuran ke dalam kode Anda sendiri, Penelusuran Agen menyediakan opsi tambahan untuk mengonfigurasi cara hasil penelusuran Anda ditampilkan.
Tindakan
Konfigurasi hasil penelusuran Anda dengan opsi berikut:
- Memfilter penelusuran kustom untuk data terstruktur atau tidak terstruktur.
- Dapatkan cuplikan, jawaban ekstraktif, atau segmen ekstraktif. Lihat Mendapatkan cuplikan dan konten yang diekstrak.
Anda dapat melihat pratinjau hasil penelusuran untuk memeriksa apakah konfigurasi aplikasi Anda berfungsi seperti yang diharapkan.
Tindakan
Untuk melihat pratinjau hasil penelusuran, gunakan konsol atau API.
Konsol. Gunakan halaman Pratinjau konsol Agent Search untuk melihat pratinjau pengaruh konfigurasi widget penelusuran terhadap hasil Anda. Lihat petunjuk Konsol di Mendapatkan hasil penelusuran.
API. Jika Anda mengintegrasikan panggilan API ke dalam aplikasi, lakukan panggilan API untuk melihat pratinjau konfigurasi penelusuran Anda. Lihat petunjuk REST di Mendapatkan hasil penelusuran.
Jika Anda puas dengan versi pratinjau aplikasi penelusuran, bagikan kepada pengguna dengan men-deploy-nya ke situs Anda.
Tindakan
Anda dapat men-deploy aplikasi penelusuran dengan salah satu cara berikut:
Sematkan widget penelusuran ke situs Anda. Penelusuran Agen menyediakan kode yang dapat Anda salin ke situs atau aplikasi web Anda. Ini akan men-deploy widget penelusuran. Anda dapat melihat pratinjau hasil penelusuran di konsol. Lihat Menambahkan widget penelusuran ke halaman web.
Integrasikan panggilan API penelusuran ke server atau aplikasi Anda. Untuk kontrol penuh atas cara hasil penelusuran ditampilkan, Anda dapat mengintegrasikan panggilan API ke server atau aplikasi Anda. Untuk mengetahui informasi selengkapnya tentang cara melakukan panggilan API, lihat Mendapatkan hasil penelusuran. Untuk mengetahui resource library klien, lihat Library klien Agent Search.
Untuk mendapatkan hasil penelusuran dan penjelajahan yang dipersonalisasi, Anda dapat memperbarui peristiwa pengguna di aplikasi penelusuran Anda. Untuk mengetahui informasi selengkapnya, lihat Tentang peristiwa pengguna untuk aplikasi kustom.
Tindakan
Anda dapat memelihara aplikasi untuk memastikan data terbaru dan yang diperlukan tersedia di penyimpanan data Anda.