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

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

تُستخرج ميزة "الإكمال التلقائي" عبارات من عناوين المستندات المفهرَسة، وباستخدام نموذج الوحدات المتعددة، تحدّد الاقتراحات التي سيتم عرضها باستخدام Suggest API. تظهر العبارات من عناوين المستندات تلقائيًا في ميزة الإكمال التلقائي. يمكنك أيضًا وضع علامة is_suggestable على سمات schema.org الخاصة بالنص والعناصر المحدَّدة مسبقًا لإكمال اسم السمة وقيمتها تلقائيًا.

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

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

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

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

يوضّح الشكل 1 كيفية استخراج اقتراحات الإكمال التلقائي من عنوان المستندات ومواقعها الجغرافية وقيم المواقع الجغرافية.

مستندان ووحدة n-gram الناتجة
الشكل 1. مستندان ووحدة تحليل ثنائية أو ثلاثية أو رباعية أو أكثر الناتجة عنهما المستخدَمة في ميزة الإكمال التلقائي

من المستند 1، نُخرج نصوصًا تتكوّن من n كلمة (ما يصل إلى ثلاث كلمات) مثل "Avengers" و"Infinity" و"War"، "Avengers Infinity" و"Infinity War" و"Avengers Infinity War". وبالمثل، من المستند 2، نُخرج "Harry" و"Potter" و"Harry Potter".

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

  • CANNOT TRANSLATE
  • هبة
  • هالك
  • هاري بوتر

لنفترض أنّ المستخدم اختار اقتراح الملء التلقائي "Hermione" وكانت ناتج ضغطة المفاتيح التالية من المستخدم هو الحرف "a". اقتراحات الإكمال التلقائي التي يتم عرضها للمستخدم هي:

  • مغامرة هيرميون
  • Hermione Action
  • Hermione Avengers

تحاول ميزة "الإكمال التلقائي" إكمال الكلمة الأخيرة (أو السلسلة النصية) التي يتم كتابتها. في المثال السابق، يتم توسيع "أ" إلى "مغامرة" و"حركة" و "أبطال خارقين" فقط لأنّه لا يتوفّر نص يبدأ بـ "هيرميون أ" معًا. يُعرف هذا الاقتراح باسم "اقتراح الكلمات الأخيرة"، وهو يكمل تلقائيًا الكلمة الأخيرة/الوحدة التحليلية التي يتم كتابتها فقط.

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

تظهر العبارات من عناوين المستندات تلقائيًا في ميزة الإكمال التلقائي. يجب وضع علامة is_suggestable بشكل صريح على سمات Schema لكي تتمكّن واجهة برمجة التطبيقات suggest API من إكمال اسم السمة والقيم ذات الصلة تلقائيًا.

الدمج مع Autocomplete API

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

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

القيود

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

  • لا يمكن فرض قيود على عبارات الإكمال التلقائي في "بحث Google في السحابة الإلكترونية" باستخدام FilterOptions المحدّد في المخطّط، باستثناء ملفّات الترشيح المضمّنة التالية: objectype وmimetype وفلاتر الأنواع.

  • لا تتوفّر الاقتراحات المستندة إلى سجلّ طلبات البحث (عمليات البحث التي أجراها المستخدم سابقًا في أحد تطبيقات البحث).

  • يمكن وضع علامة is_suggestable على 20 موقعًا بحدّ أقصى. يمكن زيادة هذا الحدّ من خلال التواصل مع فريق دعم Cloud Search.

  • لا تتوفّر ميزة الإكمال التلقائي لعوامل تشغيل البحث للمواقع التي تحتوي على exact_match_with_operator.

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

  • تقترح ميزة الإكمال التلقائي في "بحث Google" عبارات من ال مستندات التي يمكن للمستخدم الوصول إليها فقط.