Otomatik tamamlamayı uygulama

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

Otomatik tamamlama, dizine eklenen belgelerin başlıklarından kelime öbekleri çıkarır ve n-gram modeli kullanarak, Suggest API'si ile sunulacak önerileri belirler. Varsayılan olarak, doküman başlıklarındaki ifadeler otomatik tamamlamada gösterilir. İlgili özellik adını ve değerlerini otomatik olarak tamamlamak için metin ve enum şeması özelliklerini is_suggestable olarak da işaretleyebilirsiniz.

Suggest API'si, arama sorgusunu sorgunun diliyle ilgili ipuçları için (ör. İngilizce veya İspanyolca) inceler ve sonuçları buna göre önceliklendirir. İsteğin languageCode alanı, dile özgü önerileri iyileştirmek için de kullanılır.

Örnek senaryo

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

  • Veri kaynağı 2 doküman içeriyor.
  • Her dokümanın bir başlığı (ItemMetadata.title) ve iki özelliği vardır: genre ve characters.
  • İlk belgenin başlığı, genre=science fiction ve characters=Iron Man, Hulk öğelerinin yer aldığı "Avengers Infinity War" (Yenilmezler: Sonsuzluk Savaşı)
  • İ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, özelliklerinden ve özellik değerlerinden nasıl çıkarıldığı gösterilmektedir.

İki doküman ve sonuçta elde edilen ngram
Şekil 1. İki doküman ve otomatik tamamlama için kullanılan n-gram yöntemi

1. belgeden ngram (trigramlara kadar) "Yenilmezler", "Sonsuzluk", "Savaş", "Yenilmezler Sonsuzluk", "Sonsuzluk Savaşı", "Yenilmezler Sonsuzluk Savaşı", "Avengers Sonsuzluk Savaşı", "Harry", "Potter", "Harry Potter"ı oluşturuyoruz.

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

  • Ders
  • Hermione
  • Hulk
  • Harry Potter

Kullanıcının "Hermione" otomatik tamamlama önerisini seçtiğini ve kullanıcının bir sonraki tuş vuruşunun "a" karakteri olduğunu varsayalım. Kullanıcıya gösterilen otomatik tamamlama önerileri şöyle olur:

  • Hermione Macerası
  • Hermione Aksiyon
  • Hermione Yenilmezler

Otomatik tamamlama, yazılan son kelimeyi (veya ngram) tamamlamaya çalışır. Önceki örnekte, "hermione a" ile başlayan bir metin olmadığından "a" harfi yalnızca "macera", "action" ve "avengers" şeklinde genişletilmektedir. Bu öneriye kuyruk önerisi adı verilir ve yalnızca yazılan son kelimeyi/n-gramı otomatik olarak tamamlar.

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 tamamlamada gösterilir. Şema özellikleri, Öneri API'sinin karşılık gelen özellik adını ve değerlerini otomatik olarak tamamlaması için açık bir şekilde is_suggestable olarak işaretlenmelidir.

Autocomplete API 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ş gerekmeden yerel olarak desteklenir. Varsayılan olarak, doküman başlıklarındaki ifadelerin otomatik tamamlamada gösterildiğini unutmayın. Öneri API'sinin ilgili özellik adını ve değerlerini otomatik olarak tamamlaması için şema özelliklerinin açıkça is_suggestable olarak işaretlenmesi gerekir.

Özel bir arama uygulaması oluşturuyorsanız /query/suggest API uç noktalarını sorgulayarak otomatik tamamlama özelliğini kullanabilirsiniz.

Sınırlamalar

Otomatik tamamlamada aşağıdaki sınırlamalar geçerlidir:

  • Şemada tanımlanan FilterOptions öğesini kullanarak Cloud Search'ün otomatik tamamlama ifadelerini kısıtlama, şu yerleşik filtreler dışında desteklenmemektedir: objectype, mimetype ve tür filtreleri.

  • Sorgu geçmişine dayalı öneriler (kullanıcı tarafından daha önce bir arama uygulamasında yapılan aramalar) desteklenmez

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

  • Arama operatörü otomatik tamamlama özelliği 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.