Otomatik tamamlamayı uygulama

Cloud Search'in otomatik tamamlama özelliği, kullanıcı arama sorgusu yazarken kelimeler önererek kullanıcıya 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 eklenen dokümanların başlıklarından kelime öbekleri çıkarır ve n-gram modeli kullanarak Suggest API'yi kullanarak sunulacak önerileri belirler. Varsayılan olarak, doküman başlıklarındaki ifadeler otomatik tamamlamada gösterilir. Metin ve enum şeması özelliklerini is_suggestable olarak işaretleyerek ilgili mülk adını ve değerlerini otomatik olarak tamamlayabilirsiniz.

Suggest API, arama sorgusunu inceleyerek sorgunun dili (ör. İngilizce veya İspanyolca) hakkında ipuçları alır 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 doküman içeriyor.
  • Her belgenin bir başlığı (ItemMetadata.title) ve iki özelliği vardır: genre ve characters.
  • İlk belgenin başlığı "Avengers Infinity War", genre=science fiction ve characters=Iron Man, Hulk
  • İkinci belgenin başlığı "Harry Potter", genre=Adventure, Fantasy andcharacters=Hermione, Harry Potter".

Şekil 1'de, otomatik tamamlama önerilerinin doküman başlıklarından, mülklerden ve mülk değerlerinden nasıl ayıklandığı gösterilmektedir.

İki doküman ve elde edilen n-gram
Şekil 1. Otomatik tamamlama için kullanılan iki doküman ve elde edilen n-gram

1. dokümandan "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", "Avengers Infinity War" n-gramlarını (üçlü n-gramlara kadar) ayıklıyoruz. Benzer şekilde 2. dokümandan "Harry", "Potter", "Harry Potter" n-gramlarını oluşturuyoruz.

Bu veri kaynağını sorgularken kullanıcının "h" ile 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 şunlardır:

  • Hermione Adventure
  • Hermione Action
  • 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 "a" yalnızca "adventure", "action" ve "avengers" olarak genişletilir. Bu öneriye son ek öneri denir. Yalnızca yazılan son kelime/n-gram otomatik olarak tamamlanır.

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

Varsayılan olarak, belge başlıklarındaki ifadeler otomatik tamamlamada gösterilir. Öner API'nin ilgili mülk adını ve değerlerini otomatik olarak tamamlaması için şema mülkleri açıkça is_suggestable olarak işaretlenmelidir.

Otomatik Tamamlama API'si ile entegrasyon

Varsayılan arama uygulamasını veya yerleştirilebilir arama widget'ını kullanıyorsanız Cloud Search'in otomatik tamamlama özelliği, ek işlem gerektirmeden doğal olarak desteklenir. Otomatik tamamlamada varsayılan olarak doküman başlıklarındaki kelime öbeklerinin gösterildiğini unutmayın. Öner API'nin ilgili mülk adını ve değerlerini otomatik olarak tamamlaması için şema mülkleri açıkça is_suggestable olarak işaretlenmelidir.

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

Sınırlamalar

Otomatik tamamlama özelliğinin sınırlamaları şunlardır:

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

  • 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 Ekibi ile iletişime geçerek artırılabilir.

  • Arama operatörü otomatik tamamlama özelliği, exact_match_with_operator içeren mülkler için kullanılamaz.

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

  • Cloud Search'ın otomatik tamamlama özelliği yalnızca kullanıcının erişebildiği dokümanlar arasındaki ifadelerden öneriler sunar.