Otomatik tamamlamayı uygulama

Cloud Search'ün otomatik tamamlama özelliği, kullanıcı bir arama sorgusu yazarken kelimeler önererek yardımcı olur. Örneğin, öneriler; doküman başlıklarındaki kelimeler, arama operatörleri, arama operatörü değerleri veya Google Workspace kuruluşundaki adlar ve e-posta adresleri olabilir.

Otomatik tamamlama, dizine eklenmiş dokümanların başlıklarından ifadeler çıkarır ve n-gram modeli kullanarak Suggest API ile sunulacak önerileri belirler. Varsayılan olarak, doküman başlıklarındaki ifadeler otomatik tamamlama özelliğinde gösterilir. Ayrıca, ilgili özellik adını ve değerlerini otomatik olarak tamamlamak için metin ve enum şema özelliklerini is_suggestable olarak işaretleyebilirsiniz.

Suggest API, arama sorgusunu sorgunun diliyle (ör. İngilizce veya İspanyolca) ilgili ipuçları açısından inceler ve sonuçlara buna göre öncelik verir. Bir isteğin languageCode alanı, dile özgü önerileri iyileştirmek için de kullanılır.

Örnek senaryo

Örneğin, filmlerle ilgili veriler içeren aşağıdaki veri kaynağınız olduğunu varsayalım:

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

Şekil 1'de, otomatik tamamlama önerilerinin doküman başlıklarından, özelliklerden ve özellik değerlerinden nasıl çıkarıldığı gösterilmektedir.

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

1. belgeden "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", "Avengers Infinity War" gibi üçlü gramlara kadar olan n-gramları çıkarıyoruz. Benzer şekilde, 2. belgeden "Harry", "Potter", "Harry Potter"ı oluşturuyoruz.

Bu veri kaynağı sorgulanırken kullanıcının "h" yazarak başladığını varsayalım. Kullanıcıya gösterilen öneriler:

  • Ders
  • Hermione
  • Hulk
  • Harry Potter

Kullanıcının "Hermione" otomatik tamamlama önerisini seçtiğini ve ardından "a" karakterini girdiğini varsayalım. Kullanıcıya gösterilen otomatik tamamlama önerileri şunlar olur:

  • Hermione Adventure
  • Hermione İşlemi
  • Hermione Avengers

Otomatik tamamlama, yazılan son kelimeyi (veya n-gramı) tamamlamaya çalışır. Önceki örnekte, "hermione a" ile başlayan bir metin olmadığı için yalnızca "a"yı "adventure" (macera), "action" (aksiyon) ve "avengers" (yenilmezler) olarak genişletir. Bu öneriye son kelime önerisi denir. Yalnızca yazılan son kelime/n-gram otomatik olarak tamamlanır.

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

Varsayılan olarak, doküman başlıklarındaki ifadeler otomatik tamamlama özelliğinde gösterilir. Şema özelliklerinin, öneri API'sinin ilgili özellik adını ve değerlerini otomatik olarak tamamlaması için açıkça is_suggestable olarak işaretlenmesi gerekir.

Otomatik Tamamlama API'si ile entegrasyon

Varsayılan arama uygulamasını veya yerleştirilebilir arama widget'ını kullanıyorsanız Cloud Search'ün otomatik tamamlama özelliği, herhangi bir ek işlem yapmadan yerel olarak desteklenir. Doküman başlıklarındaki ifadelerin varsayılan olarak otomatik tamamlamada gösterildiğini unutmayın. Öneri API'sinin ilgili özellik adını ve değerlerini otomatik olarak tamamlaması için şema özellikleri açıkça is_suggestable olarak işaretlenmelidir.

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

Sınırlamalar

Otomatik Tamamlama'nın aşağıdaki sınırlamaları vardır:

  • Şemada tanımlanan FilterOptions kullanılarak Cloud Search'ün otomatik tamamlama ifadelerinin kısıtlanması, aşağıdaki yerleşik filtreler dışında desteklenmez: objectype, mimetype ve tür filtreleri.

  • Sorgu geçmişine dayalı öneriler (kullanıcının daha önce bir arama uygulamasında yaptığı aramalar) desteklenmez.

  • En fazla 20 mülk is_suggestable olarak işaretlenebilir. Bu sınır, Cloud Search Destek Ekibi ile iletişime geçilerek artırılabilir.

  • Arama operatörü otomatik tamamlama, exact_match_with_operator içeren mülklerde kullanılamaz.

  • Cloud Search'ün otomatik tamamlama özelliği, doküman içeriğinden en fazla 5 öneri ve 2 kişi önerisi döndürür.

  • Cloud Search'ün otomatik tamamlama özelliği, yalnızca kullanıcının erişebildiği dokümanlardaki ifadeleri önerir.