Catatan: Vertex AI Search diganti namanya menjadi Agent Search. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Memfilter rekomendasi

Jika memiliki aplikasi rekomendasi, Anda dapat menggunakan kolom dokumen untuk memfilter hasil rekomendasi. Halaman ini menjelaskan cara menggunakan kolom dokumen untuk memfilter rekomendasi ke kumpulan dokumen tertentu. Meskipun contoh di halaman ini adalah untuk rekomendasi media, prinsip yang ditampilkan di sini sama untuk rekomendasi kustom. Untuk mengetahui informasi selengkapnya tentang rekomendasi media, lihat Pengantar Penelusuran Agen untuk media.

Memfilter rekomendasi dan update penyimpanan data

Setelah update penyimpanan data apa pun, Anda harus menunggu hingga 8 jam saat model dilatih ulang. Hal ini karena model perlu mengetahui nilai saat ini dalam metadata dokumen, serta kolom mana yang dikonfigurasi sebagai dapat difilter. Anda harus menunggu perubahan dokumen dan perubahan skema diterapkan. Untuk rekomendasi (tidak seperti untuk penelusuran), pemfilteran tidak dilakukan secara real time.

Setelan filter dan diversifikasi (Khusus rekomendasi media)

Selain filter, setelan diversifikasi aplikasi juga memengaruhi hasil yang ditampilkan dalam respons rekomendasi media. Efek filter dan diversifikasi digabungkan. Diversifikasi dilakukan terlebih dahulu dan pemfilteran dilakukan kedua.

Menggabungkan diversitas berbasis aturan yang tinggi dan pemfilteran atribut berbasis kategori sering kali menghasilkan output kosong. Hal ini karena diversitas tinggi membatasi aplikasi untuk menampilkan satu hasil untuk setiap kategori.

Misalnya, Anda ingin merekomendasikan film berdasarkan Toy Story. Anda menetapkan tingkat diversitas berbasis aturan ke tinggi. Karena tingkat diversitasnya tinggi, meskipun banyak film yang mungkin direkomendasikan, hanya satu film (misalnya, WALL·E) dalam kategori film anak-anak yang ditampilkan. Saat filter untuk film anak-anak diterapkan, hanya WALL·E yang ditampilkan sebagai rekomendasi.

Untuk mengetahui informasi umum tentang diversitas, lihat Mendiversifikasi rekomendasi media.

Sebelum memulai

Pastikan Anda telah membuat aplikasi rekomendasi dan penyimpanan data. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi media atau Membuat penyimpanan data rekomendasi kustom.

Contoh dokumen

Tinjau contoh dokumen media ini. Anda dapat merujuk kembali ke contoh dokumen ini saat membaca halaman ini.

{"id":"1","schemaId":"default_schema","structData":{"title":"Toy Story (1995)","categories":["Adventure","Animation","Children","Comedy","Fantasy"],"uri":"http://mytestdomain.movie/content/1","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"88125","schemaId":"default_schema","structData":{"title":"Harry Potter and the Deathly Hallows: Part 2 (2011)","categories":["Action","Adventure","Drama","Fantasy","Mystery","IMAX"],"uri":"http://mytestdomain.movie/content/88125","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"2857","schemaId":"default_schema","structData":{"title":"Yellow Submarine (1968)","categories":["Adventure","Animation","Comedy","Fantasy","Musical"],"uri":"http://mytestdomain.movie/content/2857","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"60069","schemaId":"default_schema","structData":{"title":"WALL·E (2008)","categories":["Adventure","Animation","Children","Romance","Sci-Fi"],"uri":"http://mytestdomain.movie/content/60069","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}

Ekspresi filter

Gunakan ekspresi filter untuk menentukan filter rekomendasi Anda.

Sintaksis ekspresi filter

Extended Backus–Naur form berikut merangkum sintaksis ekspresi filter yang dapat Anda gunakan untuk menentukan filter rekomendasi.

  # A single expression or multiple expressions that are joined by "AND" or "OR".
  filter = expression, { " AND " | "OR", expression };
  # An expression can be prefixed with "-" or "NOT" to express a negation.
  expression = [ "-" | "NOT " ],
    # A parenthesized expression
    | "(", expression, ")"
    # A simple expression applying to a textual field.
    # Function "ANY" returns true if the field contains any of the literals.
    textual_field, ":", "ANY", "(", literal, { ",", literal }, ")"
    # OR filter by "available"
    available, ":", "true",
  # A literal is any double-quoted string. You must escape backslash (\) and
  # quote (") characters.
  literal = double-quoted string;
  textual_field = see the tables below;

Batasan ekspresi filter

Batasan berikut berlaku untuk ekspresi filter untuk rekomendasi:

Kedalaman penyematan operator AND dan OR dalam tanda kurung dibatasi. Ekspresi logis dalam filter harus dalam bentuk normal konjungtif (CNF). Ekspresi logis yang paling kompleks yang didukung dapat berupa daftar klausa yang terhubung AND yang hanya berisi OR seperti: (... OR ... OR ...) AND (... OR ...) AND (... OR ...)
Ekspresi dapat dinegasikan dengan kata kunci NOT atau dengan -. Hal ini hanya berfungsi dengan ekspresi ANY() dengan satu argumen.
Batasan available harus berada di tingkat teratas. Batasan ini tidak dapat digunakan sebagai bagian dari klausa OR atau negasi (NOT). Anda hanya dapat menggunakan available: true. Jika Anda menghapus filter ini, dokumen yang sudah tidak berlaku dan dokumen yang belum tersedia mungkin akan ditampilkan sebagai rekomendasi.

Kolom available dipetakan ke logika berikut:

datetime.now >= available_time AND datetime.now <= expire_time

Jika expire_time tidak ditetapkan, datetime.now <= expire_time akan diselesaikan ke true.
Jumlah maksimum istilah dalam klausa AND tingkat teratas adalah 20.
Klausa OR dapat memiliki hingga 100 argumen yang disertakan dalam ekspresi ANY(). Jika klausa OR memiliki beberapa ekspresi ANY(), semua argumennya akan dihitung terhadap batas ini. Misalnya, categories: ANY("drama", "comedy") OR categories: ANY("adventure") memiliki tiga argumen.

Contoh ekspresi filter

Tabel berikut menunjukkan contoh ekspresi filter yang valid dan tidak valid. Tabel ini juga memberikan alasan mengapa contoh yang tidak valid tidak valid.

Ekspresi	Valid	Catatan
`language_code: ANY("en", "fr")`	Ya
`NOT language_code: ANY("en")`	Ya
`NOT language_code: ANY("en", "fr")`	Tidak	Menegasikan `ANY()` dengan lebih dari satu argumen.
`language_code: ANY("en", "fr") OR categories: ANY("drama")`	Ya
`(language_code: ANY("en") OR language_code: ANY("fr")) AND categories: ANY("drama")`	Ya
`(language_code: ANY("en") AND language_code: ANY("fr")) OR categories: ANY("drama")`	Tidak	Tidak dalam bentuk normal konjungtif.
`(language_code: ANY("en")) AND (available: true)`	Ya
`(language_code: ANY("en")) OR (available: true)`	Tidak	Menggabungkan `available` dalam ekspresi `OR` dengan kondisi lain.

Ekspresi filter berikut memfilter dokumen yang berada dalam kategori drama atau aksi, yang tidak dalam bahasa Inggris, dan yang tersedia:

categories: ANY("drama", "action") AND NOT language_code: ANY("en") AND available: true

Batas pemfilteran

Setiap kolom dokumen yang dapat difilter menggunakan sejumlah memori di setiap model Anda. Batas berikut membantu mencegah efek buruk pada performa penayangan:

Maksimal 10 kolom kustom dapat ditetapkan sebagai dapat difilter dalam skema Anda.

Jika lebih dari 10 kolom kustom ditemukan selama pelatihan aplikasi, hanya 10 yang digunakan.
Maksimal 100.000.000 nilai kolom yang dapat difilter dapat ada dalam skema Anda.

Anda dapat memperkirakan jumlah total nilai kolom yang dapat difilter dalam skema dengan mengalikan jumlah dokumen dalam skema dengan jumlah kolom yang dapat difilter. Jika Anda melebihi batas ini, hal berikut akan terjadi:
- Anda tidak dapat menetapkan kolom tambahan sebagai dapat difilter.
- Pelatihan aplikasi gagal.