Tentang aplikasi dan penyimpanan data

Halaman ini menjelaskan aplikasi dan penyimpanan data Agent Search.

Dengan Agent Search, Anda membuat aplikasi penelusuran atau rekomendasi dan menghubungkannya ke penyimpanan data. Satu Google Cloud project dapat berisi beberapa aplikasi.

Hubungan antara aplikasi dan penyimpanan data

Hubungan antara aplikasi dan penyimpanan data bergantung pada jenis aplikasi:

  • Aplikasi penelusuran kustom memiliki hubungan many-to-many dengan penyimpanan data. Jika beberapa penyimpanan data terhubung ke satu aplikasi penelusuran kustom, hal ini disebut penelusuran campuran. Untuk mengetahui informasi tentang batasan menghubungkan aplikasi penelusuran ke lebih dari satu penyimpanan data, lihat Tentang penelusuran campuran.

  • Aplikasi rekomendasi kustom memiliki koneksi one-to-one dengan penyimpanan datanya.

  • Aplikasi media memiliki hubungan many-to-one dengan penyimpanan datanya. Satu aplikasi hanya dapat terhubung ke satu penyimpanan data, sedangkan satu penyimpanan data tertentu dapat terhubung ke beberapa aplikasi. Misalnya, sebuah aplikasi penelusuran media dan sebuah aplikasi rekomendasi media dapat memiliki sebuah penyimpanan data yang sama.

  • Aplikasi penelusuran layanan kesehatan memiliki hubungan many-to-one dengan penyimpanan datanya. Satu aplikasi hanya dapat terhubung ke satu penyimpanan data, sedangkan satu penyimpanan data tertentu dapat terhubung ke beberapa aplikasi. Misalnya, aplikasi yang ditampilkan kepada pasien dan aplikasi yang ditampilkan kepada penyedia layanan dapat terhubung ke penyimpanan data yang sama.

    Untuk impor data batch data layanan kesehatan, data diimpor ke penyimpanan data yang berada dalam aplikasi. Untuk impor data streaming (Pratinjau) data layanan kesehatan, data diimpor ke entitas, yang merupakan jenis penyimpanan data yang berada dalam konektor data. Konektor data juga merupakan jenis penyimpanan data yang berada dalam aplikasi.

Setelah penyimpanan data terhubung ke aplikasi, hubungan tersebut tidak dapat diputus.

Metode pembuatan aplikasi dan penyerapan data

Cara Anda membuat aplikasi dan menyerap data bergantung pada jenis data yang Anda miliki:

  • Untuk data situs, Anda dapat menggunakankonsol Google Cloud atau API. Untuk menggunakan data situs yang dibuat dengan API, Anda harus melampirkannya ke aplikasi dengan fitur Enterprise yang diaktifkan di Google Cloud konsol.

  • Untuk data terstruktur atau tidak terstruktur, Anda dapat menggunakan konsol atau API.Google Cloud

  • Untuk data layanan kesehatan, Anda dapat menggunakan Google Cloud konsol atau API.

Dokumen

Setiap penyimpanan data memiliki satu atau beberapa kumpulan data, yang disebut dokumen. Hal yang diwakilkan oleh dokumen bervariasi sesuai jenis data dalam penyimpanan data tersebut:

  • Situs. Dokumen adalah halaman web.

  • Data terstruktur. Dokumen adalah baris dalam tabel atau kumpulan data JSON yang mengikuti skema tertentu. Anda dapat memberikan skema ini sendiri atau membiarkan Agent Search menentukan skema dari data yang diserap.

  • Data terstruktur untuk media. Dokumen adalah baris dalam tabel atau kumpulan data JSON yang mengikuti skema yang khusus untuk media. Dokumen adalah kumpulan data yang berkaitan dengan konten media, seperti video, artikel berita, file musik, dan podcast. Dokumen berisi informasi yang menjelaskan item media, minimal: judul, URI ke lokasi konten, kategori, durasi, dan tanggal ketersediaan.

  • Data tidak terstruktur. Dokumen adalah file dalam salah satu format berikut: TXT, PDF, HTML, DOCX, PPTX, XLSX, dan XLSM.

  • Data FHIR layanan kesehatan. Dokumen adalah resource FHIR R4 yang didukung. Untuk mengetahui daftar resource FHIR R4 yang didukung Agent Search, lihat Referensi skema data FHIR R4 Layanan kesehatan.

Penyimpanan data dan aplikasi

Di Agent Search, ada berbagai jenis penyimpanan data. Penyimpanan data hanya dapat berisi satu jenis data.

Data situs

Penyimpanan data dengan data situs menggunakan data yang diindeks dari situs publik. Anda dapat memberikan serangkaian pola URL yang ingin disertakan dalam penyimpanan data. Halaman web yang sesuai dengan pola URL disebut halaman web yang disertakan. Kemudian, Anda dapat menyiapkan penelusuran atas data yang di-crawl dari halaman web yang disertakan.

Misalnya, Anda dapat memberikan pola URL seperti example.com/faq/* dan example.com/events/* serta mengaktifkan penelusuran atas data yang di-crawl dari halaman web yang sesuai dengan pola ini. Data ini mencakup teks, gambar yang diberi tag dengan metadata, dan data terstruktur lainnya seperti tag meta, atribut PageMap, dan data schema.org.

Anda juga dapat memberikan pola URL untuk bagian situs yang ingin dikecualikan, misalnya, example.com/events/members-only/* atau example.com/events/past-*. URL yang dikecualikan akan diprioritaskan daripada URL yang disertakan.

Ada dua jenis penyimpanan data situs:

  • Penelusuran situs dasar:

    • Menyediakan kemampuan penelusuran atas indeks Google Penelusuran yang ada untuk situs yang disertakan.
    • Tidak memerlukan verifikasi domain.

  • Pengindeksan situs lanjutan:

    • Menyediakan kemampuan penelusuran lanjutan atas indeks yang dibuat berdasarkan salah satu hal berikut:
      • Pemilik aplikasi Agent Search dapat mengontrol halaman web mana yang diindeks dengan mengirimkan peta situs dan mempertahankannya. Untuk mengetahui informasi selengkapnya, lihat Mengindeks dan memperbarui halaman web menggunakan peta situs. Proses ini membuat indeks tetap terbaru tanpa intervensi manual.
      • Pemilik aplikasi Agent Search dapat melakukan pengindeksan awal yang mencerminkan indeks Google Penelusuran, lalu memperluas cakupan indeks dengan melakukan crawl ulang pada situs jika diperlukan, sehingga indeks tetap terbaru. Untuk mengetahui informasi selengkapnya, lihat Memperbarui halaman web. Kemampuan lanjutan pengindeksan situs lanjutan tercantum di Pengindeksan situs lanjutan.
    • Memerlukan pemilik penyimpanan data Agent Search untuk memverifikasi domain tempat situs yang disertakan berada. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi domain situs.
    • Menyediakan kemampuan untuk menambahkan data terstruktur ke skema penyimpanan data. Situs berisi data tidak terstruktur, tetapi Anda dapat menambahkan data terstruktur dalam bentuk tag meta, atribut PageMap, dan data schema.org ke halaman web Anda. Kemudian, Anda dapat menggunakan data terstruktur ini untuk mengedit skema penyimpanan data seperti yang dijelaskan di Menggunakan data terstruktur untuk pengindeksan situs lanjutan.

Langkah berikutnya

Untuk penelusuran situs:

Data terstruktur

Penyimpanan data dengan data terstruktur memungkinkan penelusuran semantik atau rekomendasi atas data terstruktur. Anda dapat mengimpor data dari BigQuery atau Cloud Storage. Anda juga dapat mengupload data JSON terstruktur secara manual melalui API.

Misalnya, Anda dapat mengaktifkan penelusuran atau rekomendasi atas katalog produk untuk pengalaman e-commerce Anda atau direktori dokter untuk penelusuran atau rekomendasi penyedia layanan.

Agent Search otomatis mendeteksi skema dari data yang Anda impor. Secara opsional, Anda dapat memberikan skema untuk data Anda. Memberikan skema untuk data Anda biasanya akan meningkatkan kualitas hasil.

Langkah berikutnya

Untuk penelusuran kustom:

Untuk rekomendasi kustom:

Data terstruktur untuk media

Aplikasi media hanya dapat terhubung ke penyimpanan data media. Penyimpanan data media adalah penyimpanan data terstruktur dengan skema yang ditentukan Google atau dengan skema kustom Anda sendiri yang berisi kumpulan lima kolom terkait media tertentu. Untuk mengetahui informasi selengkapnya tentang skema, lihat Tentang dokumen dan penyimpanan data media.

Misalnya, Anda dapat mengaktifkan rekomendasi dengan membuat aplikasi rekomendasi media untuk katalog film atau situs berita sehingga pengguna Anda akan mendapatkan saran yang sesuai dan dipersonalisasi.

Selain dokumen media, penyimpanan data media juga berisi informasi peristiwa pengguna yang memungkinkan Agent Search menyesuaikan rekomendasi dan penelusuran untuk pengguna Anda. Peristiwa pengguna diperlukan untuk aplikasi media. Untuk mengetahui informasi tentang peristiwa pengguna, lihat Merekam peristiwa pengguna real-time events.

Langkah berikutnya

Data tidak terstruktur

Penyimpanan data tidak terstruktur memungkinkan penelusuran semantik atas data seperti dokumen dan gambar.

Penyimpanan data tidak terstruktur mendukung dokumen dalam format TXT, PDF, HTML, DOCX, PPTX, XLSX, dan XLSM.

Penelusuran memberikan hasil dalam bentuk 10 URL dan jawaban yang diringkas untuk kueri bahasa alami. Dokumen harus diupload ke bucket Cloud Storage dengan izin akses yang sesuai. Misalnya, lembaga keuangan dapat mengaktifkan penelusuran atas korpus pribadi publikasi riset keuangan mereka, atau perusahaan bioteknologi dapat mengaktifkan penelusuran atau rekomendasi atas repositori pribadi riset medis mereka.

Langkah berikutnya

Untuk penelusuran:

Data FHIR layanan kesehatan

Aplikasi penelusuran layanan kesehatan menggunakan data FHIR R4 yang diimpor dari penyimpanan FHIR Cloud Healthcare API. Untuk mengetahui daftar resource FHIR R4 yang didukung Agent Search, lihat Referensi skema data FHIR R4 Layanan kesehatan. Penyimpanan data FHIR R4 harus memenuhi beberapa persyaratan sebelum dapat digunakan sebagai sumber data untuk penyimpanan data Agent Search. Untuk mengetahui informasi selengkapnya, lihat cara menyiapkan data FHIR layanan kesehatan untuk penyerapan.

Langkah berikutnya

Tentang penelusuran campuran

Anda dapat membuat aplikasi penelusuran campuran, tempat beberapa penyimpanan data dapat terhubung ke satu aplikasi penelusuran kustom. Fitur ini memungkinkan Anda menggunakan satu aplikasi untuk menelusuri beberapa sumber dan jenis data.

Untuk membuat aplikasi penelusuran campuran, pilih beberapa penyimpanan data saat membuat aplikasi penelusuran kustom baru. Jika Anda tidak memilih beberapa penyimpanan data selama pembuatan, Anda tidak dapat menambahkan penyimpanan data tambahan nanti.

Saat mendapatkan hasil penelusuran, Anda dapat menelusuri semua penyimpanan data, atau memfilter hasil dari satu penyimpanan data.

Batasan berikut berlaku:

  • Menambahkan dan menghapus penyimpanan data:
    • Untuk mengaktifkan penelusuran campuran untuk aplikasi, Anda harus menghubungkan setidaknya dua penyimpanan data ke aplikasi tersebut selama pembuatan aplikasi.
    • Anda dapat menambahkan atau menghapus penyimpanan data dari aplikasi penelusuran campuran, tetapi aplikasi tidak boleh memiliki kurang dari dua penyimpanan data yang terhubung ke aplikasi tersebut kapan saja.
    • Jika Anda menghubungkan satu penyimpanan data ke aplikasi penelusuran selama pembuatan aplikasi, Anda tidak dapat menambahkan atau menghapus penyimpanan data tersebut.
  • Penyimpanan data situs harus mengaktifkan pengindeksan situs lanjutan agar dapat digunakan untuk penelusuran campuran. Untuk mengetahui informasi selengkapnya, lihat Pengindeksan situs lanjutan.
  • Penyimpanan data yang berisi data tidak terstruktur yang diimpor menggunakan BigQuery tidak didukung.
  • Penelusuran campuran mengizinkan kolom berikut dalam permintaan penelusuran:
    • boostSpec
    • contentSearchSpec
    • dataStoreSpecs
    • facetSpecs
    • filter
    • languageCode
    • offset
    • oneBoxPageSize
    • orderBy
    • query
    • pageSize
    • pageToken
    • relevanceScoreSpec
    • relevanceThreshold
    • session
    • sessionSpec
    • spellCorrectionSpec
    • userInfo
    • userPseudoId
  • Penelusuran campuran mengizinkan kolom berikut di DataStoreSpec:
    • dataStore
    • boostSpec: Jika ada spesifikasi peningkatan yang ditentukan untuk SearchRequest dan dataStoreSpecs, kedua spesifikasi peningkatan akan diterapkan ke hasil penelusuran
    • filter: Jika ada filter yang ditentukan untuk SearchRequest dan dataStoreSpecs, kedua filter akan diterapkan ke hasil penelusuran
  • Operasi Buat, Baca, Perbarui, dan Hapus (CRUD) pada konfigurasi penayangan didukung untuk aplikasi campuran. Hanya kolom berikut yang dapat ditambahkan atau diperbarui dalam konfigurasi penayangan:
    • boostControlIds
    • displayName
    • filterControlIds
    • genericConfig:
      • contentSearchSpec
    • name
    • solutionType
    • synonymsControlIds
  • Operasi CRUD pada kontrol berikut didukung untuk aplikasi penelusuran campuran:
    • boostAction
    • synonymAction
    • filterAction
  • Ada batas 50 penyimpanan data per aplikasi penelusuran.
  • Jika satu penyimpanan data menggunakan konfigurasi CMEK, semua penyimpanan data lainnya juga harus menggunakan konfigurasi CMEK yang sama.