Otomatik tamamlamayı uygulama

Google Cloud Search otomatik tamamlama, kullanıcılar arama sorgusu yazarken kelime önererek onlara yardımcı olur. Örneğin, önerilerde doküman başlıklarındaki kelimeler, arama operatörleri veya Google Workspace kuruluşunuzdaki adlar yer alabilir.

Autocomplete, dizine eklenmiş doküman başlıklarından ifadeler çıkarır ve Suggest API'yi kullanarak önerileri belirlemek için n-gram modeli kullanır. Otomatik tamamlama özelliği varsayılan olarak doküman başlıklarındaki ifadeleri gösterir. Ayrıca, özellik adlarını ve değerlerini otomatik olarak tamamlamak için metin ve enum şema özelliklerini is_suggestable olarak işaretleyebilirsiniz.

Öneri API'si, arama sorgularını İngilizce veya İspanyolca gibi dil ipuçları açısından inceler ve sonuçlara öncelik verir. İsteklerdeki languageCode alanı da dile özgü önerileri iyileştirir.

Örnek senaryo

Film verileri içeren bir veri kaynağı düşünün:

  • Veri kaynağı iki doküman içeriyor.
  • Her belgenin bir başlığı (ItemMetadata.title) ve iki özelliği vardır: genre ve characters.
  • 1. dokümanın başlığı: "Avengers Infinity War"; genre=science fiction; characters=Iron Man, Hulk.
  • 2. dokümanın başlığı: "Harry Potter"; genre=Adventure, Fantasy; characters=Hermione, Harry Potter.

Şekil 1'de, otomatik tamamlama özelliğinin önerileri nasıl çıkardığı gösterilmektedir.

İki belge ve sonuçtaki n-gram
Şekil 1. Otomatik tamamlama için kullanılan iki belge ve sonuçtaki n-gram

Model, 1. belgeden "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War" ve "Avengers Infinity War" gibi n-gramlar (üç grama kadar) çıkarır. 2. belgeden "Harry", "Potter" ve "Harry Potter"ı oluşturur.

Bir kullanıcı bu veri kaynağını sorgularken "h" yazarsa şu önerileri görebilir:

  • Ders
  • Hermione
  • Hulk
  • Harry Potter

Kullanıcı "Hermione"u seçip "a" yazdığında otomatik tamamlama şu sonuçları gösterebilir:

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

Otomatik tamamlama, yazılan son kelimeyi veya n-gramı tamamlamaya çalışır. Bu örnekte, "hermione a." ile başlayan dizine eklenmiş metin olmadığı için "a" ifadesi "adventure" (macera), "action" (aksiyon) ve "avengers" (yenilmezler) olarak genişletiliyor. Bu, son ekleme önerisidir.

Cloud Search'teki otomatik tamamlama özelliği, doküman içeriğinden en fazla beş öneri ve iki kişi önerisi döndürür.

Otomatik tamamlama özelliği, varsayılan olarak doküman başlıklarındaki ifadeleri gösterir. Özellik adlarının ve değerlerinin otomatik olarak tamamlanması için schema özelliklerini Suggest API'de açıkça is_suggestable olarak işaretlemeniz gerekir.

Suggest API ile entegrasyon

Varsayılan arama uygulamasını veya yerleştirilebilir arama widget'ını kullanıyorsanız Cloud Search, otomatik tamamlama özelliğini doğal olarak destekler. Şema özelliklerinin otomatik olarak tamamlanmasını istiyorsanız bunları is_suggestable olarak işaretlemeyi unutmayın.

Özel bir arama uygulaması oluşturuyorsanız otomatik tamamlama özelliği, /query/suggest API uç noktaları kullanılarak kullanılabilir.

Sınırlamalar

Otomatik Tamamlama'nın sınırlamaları şunlardır:

  • objecttype ve mimetype gibi yerleşik filtreler hariç olmak üzere, FilterOptions kullanılarak otomatik tamamlama ifadelerinin kısıtlanması desteklenmez.
  • Kullanıcının sorgu geçmişine dayalı öneriler desteklenmez.
  • En fazla 20 mülkü is_suggestable olarak işaretleyebilirsiniz. Bu sınırı artırmak için Cloud Search Destek Ekibi ile iletişime geçin.
  • Arama operatörü otomatik tamamlama özelliği, exact_match_with_operator olan mülklerde kullanılamaz.
  • Otomatik tamamlama, en fazla beş belge içeriği önerisi ve iki kişi önerisi döndürür.
  • Otomatik tamamlama özelliği yalnızca kullanıcının erişebildiği dokümanlardaki ifadeleri önerir.