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.

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

Örnek senaryo

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

  • Veri kaynağı iki belge 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 (üçlü gramlara kadar) çıkarır. 2. belgeden "Harry", "Potter" ve "Harry Potter" kelimelerini 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 seçenekleri 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 Suggest API'nin şema özelliklerini 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:

  • FilterOptions kullanarak otomatik tamamlama ifadelerini kısıtlama, objecttype ve mimetype gibi yerleşik filtreler dışında desteklenmez.
  • Kullanıcının sorgu geçmişine dayalı öneriler desteklenmez.
  • En fazla 20 mülkü is_suggestable olarak işaretleyebilirsiniz. Bu limiti 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.