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

تساعد ميزة "الإكمال التلقائي" في 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: "Harry Potter"؛ genre=Adventure, Fantasy؛ characters=Hermione, Harry Potter.

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

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

من المستند 1، يستخرج النموذج n-grams (ما يصل إلى ثلاثيات) مثل "Avengers" و"Infinity" و"War" و"Avengers Infinity" و"Infinity War" و"Avengers Infinity War". من المستند 2، ينشئ النموذج "Harry" و"Potter" و"Harry Potter".

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

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

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

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

تحاول ميزة "الإكمال التلقائي" إكمال الكلمة الأخيرة أو n-gram الذي تم إدخاله. في هذا المثال، توسّع الميزة الحرف "a" إلى "adventure" و"action" و"avengers" لأنّه لا يبدأ أي نص مفهرس بـ "hermione a". هذا اقتراح نهائي.

تعرض ميزة "الإكمال التلقائي" في 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.
  • تعرض ميزة "الإكمال التلقائي" خمسة اقتراحات كحد أقصى من محتوى المستند واقتراحَين للأشخاص.
  • لا تقترح ميزة "الإكمال التلقائي" إلا عبارات من المستندات التي يمكن للمستخدم الوصول إليها.