Mendapatkan hasil penelusuran untuk aplikasi media

Halaman ini menunjukkan cara melihat pratinjau hasil penelusuran untuk aplikasi media menggunakan konsol dan cara mendapatkan hasil penelusuran menggunakan API.Google Cloud

Untuk menerapkan aplikasi penelusuran, Anda dapat membuat widget penelusuran untuk ditambahkan ke halaman web atau melakukan panggilan API dan mengintegrasikan panggilan tersebut ke halaman web atau aplikasi Anda.

Tentang mode penelusuran

Ada beberapa mode kueri penelusuran untuk aplikasi media:

  • Kueri lengkap: Saat pengguna akhir ingin seluruh istilah atau frasa penelusuran mereka ditelusuri. Misalnya, di aplikasi streaming musik, pengguna mengetik seluruh judul lagu dan menelusurinya sekaligus. Ini adalah cara penelusuran yang lebih disukai saat menggunakan antarmuka input yang memungkinkan pengguna menelusuri sekaligus, seperti input audio atau input keyboard.

    Dalam kueri lengkap, jika entri menyertakan kesalahan ejaan, pengguna berharap kesalahan tersebut diperbaiki.

    Perilaku ini sama dengan penelusuran aplikasi non-media (kustom). Lihat Mendapatkan hasil penelusuran untuk aplikasi dengan data terstruktur atau tidak terstruktur.

  • Kueri parsial (atau penelusuran saat Anda mengetik): Saat pengguna akhir menerima serangkaian hasil penelusuran baru secara dinamis saat mereka mengetik setiap huruf. Misalnya, di aplikasi streaming musik, pengguna mulai memasukkan nama lagu yang mereka cari dan dengan setiap huruf yang mereka ketik, hasil penelusuran akan diperbarui dan dipersempit secara dinamis.

  • Mode otomatis: Mode otomatis adalah campuran mode penuh dan sebagian. Dengan mode otomatis, Anda membiarkan penelusuran media memutuskan apakah akan menampilkan hasil kueri sebagai sebagian atau penuh.

    Untuk menentukan kemungkinan niat pengguna akhir, penelusuran media menganalisis dan menimbang berbagai sinyal, seperti jumlah huruf yang dimasukkan, kecepatan entri, dan apakah entri tersebut adalah entitas yang dikenali—misalnya, nama aktor atau film.

Mode yang akan digunakan

Mode default untuk kueri penelusuran media adalah mode otomatis. Namun, ada skenario di mana Anda dapat memilih untuk mengganti mode default dan menentukan mode kueri penuh atau sebagian. Berikut beberapa contoh kasus penggunaan:

Skenario Mode
Anda sangat yakin bahwa kueri pengguna akhir Anda adalah kueri lengkap. Misalnya, Anda memiliki kotak penelusuran yang menyertakan fungsi Enter untuk menandai kueri selesai dan pengguna menekan Enter. Kueri lengkap
Anda sangat yakin bahwa kueri pengguna akhir Anda dimaksudkan sebagai kueri parsial—yaitu, mereka mengharapkan daftar hasil diperbarui setelah setiap huruf dimasukkan. Kueri parsial
Tidak ada skenario di atas yang berlaku. Biarkan penelusuran media memutuskan apakah akan menampilkan hasil kueri sebagai sebagian atau penuh. Otomatis

Anda dapat melihat pratinjau hasil penelusuran dari Google Cloud konsol atau mendapatkan hasil penelusuran menggunakan API. Untuk mendapatkan hasil penelusuran aplikasi media:

Konsol

Untuk menggunakan Google Cloud konsol guna melihat pratinjau penelusuran media dan mengonfigurasi widget:

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

    Aplikasi AI

  2. Klik nama aplikasi penelusuran media.

  3. Klik Configurations.

  4. Klik tab UI.

  5. Di tab UI, tetapkan opsi Konfigurasi umum dan Tampilan data.

  6. Di panel Pratinjau, mulai ketik kueri.

  7. Untuk menyimpan konfigurasi dan menyediakannya di tab Integrasi, klik Simpan dan publikasikan.

REST

Gunakan metode engines.servingConfigs.search untuk mendapatkan hasil penelusuran untuk aplikasi media:

  1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

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

      Buka Aplikasi

    2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

  2. Jalankan perintah curl berikut untuk mendapatkan hasil penelusuran saat Anda mengetik.

    Semua kolom, kecuali contentSearchSpec, dapat digunakan bersama dengan kolom searchAsYouTypeSpec. Agar lebih jelas, kolom opsional telah dihapus dari perintah curl. Untuk mengetahui kolom opsional, lihat Mendapatkan hasil penelusuran untuk aplikasi dengan data terstruktur atau tidak terstruktur.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"query": "QUERY",
"searchAsYouTypeSpec": {"condition": "SPEC_CONDITION"}
}'

    Ganti kode berikut:

    • PROJECT_ID: ID Google Cloud project Anda.
    • PROJECT_ID: ID Google Cloud project Anda.
    • APP_ID: ID aplikasi Vertex AI Search yang ingin Anda kueri.
    • QUERY: teks kueri yang akan ditelusuri.

    • SPEC_CONDITION: spesifikasi penelusuran saat Anda mengetik dapat memiliki salah satu nilai berikut:

      • ENABLED: untuk kueri parsial
      • DISABLED: untuk kueri lengkap
      • AUTO: untuk sebagian atau seluruhnya sebagaimana dianggap sesuai. Jika Anda mengosongkan kolom SPEC_CONDITION atau tidak menentukannya, mode penelusuran default adalah AUTO.

    Contoh perintah dan hasil sebagian

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/default_search:search" \
-d '{
"query": "Mission Impossible",
"searchAsYouTypeSpec": {"condition": "DISABLED"}
}'

    
{
  "results": [
    {
      "id": "189333",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/189333",
        "id": "189333",
        "structData": {
          "uri": "http://mytestdomain.movie/content/189333",
          "title": "Mission: Impossible - Fallout (2018)",
          "categories": [
            "Action",
            "Adventure",
            "Thriller"
          ],
          "available_time": "2023-01-01T00:00:00Z",
          "media_type": "movie",
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    },
    {
      "id": "111781",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/111781",
        "id": "111781",
        "structData": {
          "media_type": "movie",
          "available_time": "2023-01-01T00:00:00Z",
          "uri": "http://mytestdomain.movie/content/111781",
          "title": "Mission: Impossible - Rogue Nation (2015)",
          "categories": [
            "Action",
            "Adventure",
            "Thriller"
          ],
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    },
    ...
    {
      "id": "116507",
      "document": {
      "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/116507",
        "id": "116507",
        "structData": {
          "uri": "http://mytestdomain.movie/content/116507",
          "categories": [
            "Comedy"
          ],
          "media_type": "movie",
          "available_time": "2023-01-01T00:00:00Z",
          "title": "Mission London (2010)",
          "expire_time": "2033-01-01T00:00:00Z"
        }
      }
    }
  ],
  "totalSize": 5628,
  "attributionToken": "vgL0PQEKDAiZxMbCBhD2koiqAxIkNjg1MWM3OTUtMDAwMC0yOWVmLThhNzUtZDQzYTJjYzdiYmNmIgVNRURJQSpUtreMLa_WoTGs1qExwvCeFaOAlyKrtZwxxcvzF-7r6TGotZwxkPeyMI6RyTDPv-Iw1L_iMJvWty2Ovp0V1LKdFfHr6THs4K8tkvGsMJXxrDCY1rctMAFKEjB4OTYzYjdjNGE0ZGYwN2FhZlKUAXByb2plY3RzLzc1NjIwNjYwODQ3OS9sb2NhdGlvbnMvZ2xvYmFsL2NvbGxlY3Rpb25zL2RlZmF1bHRfY29sbGVjdGlvbi9lbmdpbmVzL3F1aWNrc3RhcnQtbWVkaWEtcmVjb21tZW5kXzE3NDUwMjUyMjYwNDMvc2VydmluZ0NvbmZpZ3MvZGVmYXVsdF9zZWFyY2g",
  "nextPageToken": "Y2YiJ2NjNmMhNDNk1SN3EGOtYWZ5ITLwADMw0CN5czYxUDO2QiGDI9kgzIEGIs1tmJCMIBM1IgC",
  "summary": {},
  "queryExpansionInfo": {}
}

Langkah berikutnya