تنفيذ الإكمال التلقائي

تساعد ميزة الإكمال التلقائي في Google Cloud Search المستخدمين من خلال اقتراح كلمات أثناء كتابة طلب البحث. على سبيل المثال، قد تتضمّن الاقتراحات كلمات من عناوين المستندات أو عوامل تشغيل البحث أو أسماء من مؤسستك على Google Workspace.

تستخرج ميزة "الإكمال التلقائي" عبارات من عناوين المستندات المفهرسة وتستخدم نموذج n-gram لتحديد الاقتراحات باستخدام Suggest API. تعرض ميزة "الإكمال التلقائي" تلقائيًا عبارات من عناوين المستندات. يمكنك أيضًا وضع علامة is_suggestable على خصائص نصية وعددية في مخططات البيانات لتفعيل ميزة الإكمال التلقائي لأسماء الخصائص وقيمها.

تفحص واجهة برمجة التطبيقات Suggest API طلبات البحث بحثًا عن تلميحات حول اللغة، مثل الإنجليزية أو الإسبانية، وتمنح الأولوية للنتائج. يؤدي الحقل languageCode في الطلب أيضًا إلى تحسين الاقتراحات الخاصة بلغة معيّنة.

مثال على السيناريو

لنفترض أنّ لديك مصدر بيانات يحتوي على بيانات أفلام:

  • يحتوي مصدر البيانات على مستندَين.
  • يحتوي كل مستند على عنوان (ItemMetadata.title) وخاصيتَين: genre وcharacters.
  • عنوان المستند 1: "Avengers Infinity War"؛ genre=science fiction؛ characters=Iron Man, Hulk.
  • عنوان المستند 2: "هاري بوتر"؛ genre=Adventure, Fantasy؛ characters=Hermione, Harry Potter.

يوضّح الشكل 1 كيف تستخرج ميزة "الإكمال التلقائي" الاقتراحات.

مستندَين وn-gram الناتج
الشكل 1. مستندَين وn-gram الناتج المستخدَم في الإكمال التلقائي

من المستند 1، يستخرج النموذج وحدات n-gram (تصل إلى ثلاثية) مثل "المنتقمون" و"الحرب" و"اللانهاية" و"المنتقمون: الحرب اللانهائية" و"الحرب اللانهائية" و "المنتقمون: الحرب اللانهائية". من المستند 2، يتم إنشاء "هاري" و"بوتر" و "هاري بوتر".

إذا كتب المستخدم الحرف "h" عند طلب البحث في مصدر البيانات هذا، قد تظهر له الاقتراحات التالية:

  • CANNOT TRANSLATE
  • هيرميون
  • Hulk
  • هاري بوتر

إذا اختار المستخدم "هرميون" ثم كتب "أ"، قد تعرض ميزة "الإكمال التلقائي" ما يلي:

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

تحاول ميزة "الإكمال التلقائي" إكمال الكلمة الأخيرة أو n-gram التي تمّت كتابتها. في هذا المثال، يتم توسيع نطاق البحث ليشمل "مغامرة" و"أكشن" و"المنتقمون" لأنّه لا يتوفّر أي نص مفهرس يبدأ بـ "هيرميون أ.". هذا اقتراح ذيل.

تعرض ميزة الإكمال التلقائي في Cloud Search خمسة اقتراحات بحدّ أقصى من محتوى المستند واقتراحَين للأشخاص.

تعرض ميزة "الإكمال التلقائي" تلقائيًا عبارات من عناوين المستندات. يجب وضع علامة is_suggestable بشكل صريح على خصائص المخطط لكي تتمكّن واجهة برمجة التطبيقات Suggest API من إكمال أسماء الخصائص وقيمها تلقائيًا.

التكامل مع Suggest API

إذا كنت تستخدم تطبيق البحث التلقائي أو أداة البحث القابلة للتضمين، ستتيح لك خدمة Cloud Search ميزة الإكمال التلقائي بشكلٍ مدمج. تذكَّر وضع علامة is_suggestable على خصائص المخطط إذا أردت إكمالها تلقائيًا.

إذا كنت بصدد إنشاء تطبيق بحث مخصّص، تتوفّر ميزة الإكمال التلقائي من خلال استخدام نقاط نهاية واجهة برمجة التطبيقات /query/suggest.

القيود

تنطبق القيود التالية على ميزة "الإكمال التلقائي":

  • لا تتوفّر إمكانية حظر عبارات الإكمال التلقائي باستخدام FilterOptions، باستثناء الفلاتر المضمّنة، مثل objecttype وmimetype.
  • لا تتوفّر اقتراحات تستند إلى سجلّ طلبات البحث للمستخدم.
  • يمكنك وضع علامة is_suggestable على 20 موقعًا كحدّ أقصى. يُرجى التواصل مع فريق دعم Cloud Search لزيادة هذا الحدّ.
  • لا تتوفّر ميزة الإكمال التلقائي لعوامل تشغيل البحث في المواقع التي تتضمّن exact_match_with_operator.
  • تعرض ميزة "الإكمال التلقائي" خمسة اقتراحات بحد أقصى لمحتوى المستندات واقتراحَين للأشخاص.
  • لا تقترح ميزة "الإكمال التلقائي" سوى عبارات من المستندات التي يمكن للمستخدم الوصول إليها.