إنشاء تطبيق شامل لمكتب مساعدة الموظفين بدون رموز برمجية باستخدام Vertex AI Search

1. مقدمة

في هذا الدرس التطبيقي حول الترميز، ستنشئ تطبيقًا عالميًا لمكتب مساعدة الموظفين بدون كتابة أي رمز برمجي باستخدام Vertex AI Search.

لنفترض أنّك تعمل في شركة Cymbal، وهي شركة عالمية للبيع بالتجزئة. غالبًا ما يطرح الموظفون أسئلة مثل "ما هي سياسة حجز رحلات العمل؟" أو "كم عدد أحذية السنيكرز المتوفرة لدينا في المستودع؟".

عادةً، يجب تسجيل الدخول إلى أنظمة مختلفة تمامًا للعثور على هذه الإجابات. بالإضافة إلى التعامل مع أنظمة مختلفة، عليك أيضًا قراءة عدد كبير من بيانات الموارد البشرية غير المنظَّمة أو تنفيذ طلبات SQL معقّدة على البيانات المالية المنظَّمة للحصول على إجابات لأسئلتك.

في هذا الدرس التطبيقي حول الترميز، ستنشئ تطبيقًا واحدًا موحّدًا يتصل بمجموعات البيانات هذه، ما يتيح للموظفين الحصول على إجابات حوارية مستندة إلى الحقائق لأسئلتهم باستخدام إمكانات "التوليد المعزّز بالاسترجاع" (RAG) في Vertex AI.

الإجراءات التي ستنفذّها

في هذا الدرس العملي، ستكمل الخطوات التالية:

  • إعداد مصادر البيانات: أنشئ حزمة Cloud Storage لمستندات الموارد البشرية غير المنظَّمة ومجموعة بيانات BigQuery للبيانات المالية المنظَّمة.
  • ضبط مخازن البيانات إنشاء مخازن بيانات Vertex AI Search مرتبطة بمصادر بيانات Cloud Storage وBigQuery
  • ربط التطبيق: أنشئ تطبيق Vertex AI Search واربط كلا مخزنَي البيانات به.
  • اختبار التطبيق: تفاعَل مع واجهة البحث الموحّدة للتحقّق من صحة الأجوبة المستندة إلى معلومات من كلا مستودعَي البيانات.
  • التعرّف على الخطوات التالية راجِع خيارات ضبط نموذج الذكاء الاصطناعي التوليدي ونشر تطبيق البحث.

مخطّط بنية التطبيق الذي يعرض Vertex AI Search

المتطلبات

  • متصفّح ويب، مثل Chrome
  • مشروع Google Cloud تم تفعيل الفوترة فيه
  • يجب تثبيت Git على جهازك.

هذا الدرس التطبيقي حول الترميز مخصّص للمطوّرين من جميع المستويات.

2. قبل البدء

أنشئ مشروعًا على Google Cloud وفعِّل واجهات برمجة التطبيقات المطلوبة.

  1. في Google Cloud Console، في صفحة اختيار المشروع، اختَر مشروع Google Cloud أو أنشِئه.
  2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. تعرَّف على كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع.

أدوار "إدارة الهوية وإمكانية الوصول" المطلوبة

يفترض هذا الدرس العملي أنّ لديك دور مالك المشروع لمشروعك على Google Cloud.

تفعيل واجهات برمجة التطبيقات

  1. في "وحدة تحكّم Google Cloud"، انقر على تفعيل Cloud Shell: إذا لم يسبق لك استخدام Cloud Shell، سيظهر جزء يتيح لك اختيار بدء Cloud Shell في بيئة موثوقة مع أو بدون تعزيز. إذا طُلب منك تفويض Cloud Shell، انقر على تفويض.
  2. في Cloud Shell، فعِّل جميع واجهات برمجة التطبيقات المطلوبة:
    gcloud services enable \
  discoveryengine.googleapis.com \
  aiplatform.googleapis.com \
  bigquery.googleapis.com \
  storage.googleapis.com

3- استنساخ مستودع GitHub

لعرض طريقة عمل البحث في تطبيق مكتب المساعدة الخاص بموظفي Cymbal، تحتاج إلى بعض الملفات التجريبية. في هذا القسم، ستستنسخ مستودع GitHub إلى جهازك المحلي للحصول على هذه الملفات. ستحمّل هذه الملفات إلى Google Cloud في خطوات لاحقة باستخدام واجهة Cloud Console.

  1. في وحدة طرفية على جهازك، استنسِخ مستودع next-26-sessions:
    git clone https://github.com/GoogleCloudPlatform/next-26-sessions.git
  2. انتقِل إلى دليل المستودع الذي تم تنزيله:
    cd next-26-sessions/BRK1-063-the-knowledge-source/cymbal-employee-helpdesk
  3. استكشِف الملفات التي تم تنزيلها في هذا الدليل. ستلاحظ وجود مجلدَين: HR وFinance.
    • HR يحتوي هذا المجلد على عدد من الملفات غير المنظَّمة، مثل ملفات .doc و.txt و.html. عليك تحميل ملفات الموارد البشرية إلى حزمة Cloud Storage.
    • الشؤون المالية يحتوي هذا المجلد على ملفَي .jsonl. ستحمّل هذه الملفات إلى مجموعة بيانات BigQuery.

4. إنشاء حزمة Cloud Storage للملفات غير المنظَّمة

في هذا القسم، يمكنك إنشاء حزمة Cloud Storage وتحميل المستندات في المجلد HR الذي نزّلته في قسم استنساخ مستودع GitHub. البيانات غير المنظَّمة، مثل مستندات الموارد البشرية في هذا المثال، لا تتبع تنسيقًا محدَّدًا مسبقًا ويمكن أن تتضمّن ملفات نصية أو مستندات أو محتوى وسائط متعدّدة.

  1. في Cloud Console، انتقِل إلى صفحة الحِزم.
  2. انقر على إنشاء.
  3. في صفحة إنشاء حزمة، أدخِل اسم حزمة. يجب أن يكون الاسم فريدًا على مستوى العالم. على سبيل المثال: cymbal-app-hr-12.
  4. احتفِظ بالخيارات التلقائية.
  5. انقر على إنشاء.سيتم إنشاء الحزمة وستظهر صفحة تفاصيل الحزمة. إذا لم تظهر لك صفحة تفاصيل الحزمة، انقر على الحزمة التي أنشأتها للتو.
  6. في صفحة تفاصيل الحزمة، انقر على تحميل > تحميل مجلد، ثم اختَر المجلد HR الذي نزّلته في قسم استنساخ مستودع GitHub.
  7. أكِّد عملية التحميل.إنشاء مجموعة
  8. في صفحة تفاصيل الحزمة، انقر على المجلد HR لعرض قائمة الملفات.الملفات في الحزمة

5- إنشاء مجموعة بيانات BigQuery للملفات المنظَّمة

في هذا القسم، ستنشئ مجموعة بيانات BigQuery وتحمّل المستندات في المجلد Finance الذي نزّلته في قسم استنساخ مستودع GitHub إلى جدول جديد. تتّبع البيانات المنظَّمة، مثل المستندات المالية في هذا المثال، تنسيقًا محدَّدًا مسبقًا، مثل السجلات في قاعدة بيانات.

  1. في Cloud Console، انتقِل إلى صفحة BigQuery.
  2. في جزء المستكشف، انقر على اسم مشروعك، ثم انقر على عرض الإجراءات (النقاط الرأسية الثلاث) > إنشاء مجموعة بيانات.إنشاء مجموعة بيانات
  3. في لوحة إنشاء مجموعة بيانات، أدخِل معرّف مجموعة البيانات على النحو التالي: cymbal_finance.
  4. بالنسبة إلى الموقع الجغرافي للبيانات، اختَر US (multiple regions in United States).
  5. احتفِظ بالخيارات التلقائية وانقر على إنشاء مجموعة بيانات.
  6. في جزء المستكشف، وسِّع مشروعك، وانقر على مجموعة بيانات cymbal_finance.
  7. في لوحة تفاصيل مجموعة البيانات، انقر على إنشاء جدول.
  8. في صفحة إنشاء جدول، ضِمن قسم المصدر، اتّبِع الخطوات التالية:
    1. بالنسبة إلى إنشاء جدول من، اختَر تحميل.
    2. بالنسبة إلى اختيار ملف، انقر على تصفّح، وانتقِل إلى مجلد Finance الذي نزّلته، ثم اختَر cymbal_employee_finance.jsonl.
    3. بالنسبة إلى تنسيق الملف، اختَر JSONL (تنسيق JSON المحدَّد بفواصل).
  9. في قسم الوجهة، أدخِل اسم الجدول على النحو التالي: employee_finance.
  10. في قسم المخطط، ضَع علامة في مربّع الاختيار الاكتشاف التلقائي.
  11. احتفِظ بالإعدادات التلقائية الأخرى وانقر على إنشاء جدول.
  12. كرِّر الخطوات من 7 إلى 11 لتحميل البيانات إلى جدول جديد. في الخطوة 8ب، انقر على product_inventory.jsonl، وفي الخطوة 9، أدخِل product_inventory كاسم الجدول.إذا لم تظهر لك الجداول في جزء تفاصيل مجموعة البيانات، انقر على إعادة تحميل.
  13. إذا تم إنشاء مجموعة البيانات والجدولَين بنجاح، يجب أن تبدو كما في الصورة التالية:مجموعة البيانات المالية في Cymbal

6. إنشاء تطبيق Vertex AI Search

  1. في Cloud Console، انتقِل إلى صفحة Vertex AI Search.
  2. في مربّع البحث المخصّص (عام)، انقر على إنشاء.
  3. في صفحة إعدادات تطبيق "بحث Google"، تأكَّد من تحديد الخيارَين ميزات إصدار Enterprise والردود المستنِدة إلى الذكاء الاصطناعي التوليدي.
  4. أدخِل اسمًا لتطبيقك cymbal-employee-portal.
  5. أدخِل اسم الشركة على النحو التالي: Cymbal Corp.
  6. احتفِظ بموقع تطبيقك الجغرافي على النحو global.
  7. انقر على متابعة.

7. إنشاء مخازن بيانات وربطها

في صفحة مخازن البيانات، يمكنك إنشاء مخازن بيانات ستتصل بتطبيقك. يجب إنشاء ثلاثة مخازن بيانات: مخزن واحد لبيانات الموارد البشرية غير المنظَّمة، ومخزنان للبيانات المالية المنظَّمة.

إنشاء مستودع بيانات للبيانات غير المنظَّمة

  1. في صفحة مخازن البيانات، انقر على إنشاء مخزن بيانات.
  2. بالنسبة إلى اختيار مصدر بيانات، اختَر التخزين في السحابة الإلكترونية.
  3. في لوحة استيراد البيانات من Cloud Storage، انتقِل إلى استيراد البيانات غير المنظَّمة (البحث عن المستندات وRAG)، ثم اختَر المستندات.
  4. احتفِظ بخيار معدّل تكرار المزامنة على مرة واحدة.
  5. في اختيار مجلد أو ملف تريد استيراده، انقر على مجلد.
  6. في الحقل gs://...، أدخِل اسم الحزمة التي أنشأتها في القسم إنشاء حزمة Cloud Storage للملفات غير المنظَّمة. على سبيل المثال، إذا كان اسم الحزمة هو cymbal-app-hr-12، أدخِل الاسم على النحو التالي: cymbal-app-hr-12/HR.يضمن الاستيعاب من المجلد HR تضمين مستندات الموارد البشرية فقط في مخزن البيانات هذا.
  7. انقر على متابعة.
  8. أدخِل اسم مستودع البيانات على النحو التالي: cymbal-hr.
  9. انقر على متابعة.
  10. الاحتفاظ بخيار الأسعار العامة
  11. انقر على إنشاء.

بعد النقر على إنشاء، ستتم إعادتك إلى صفحة مخازن البيانات.

إنشاء مخازن بيانات للبيانات المنظَّمة

ستنشئ مستودعَي بيانات للبيانات المنظَّمة من BigQuery: أحدهما لمعلومات الموظفين المالية والآخر لمستودع المنتجات.

إنشاء مستودع بيانات لبيانات الشؤون المالية للموظفين

  1. في صفحة مخازن البيانات، انقر على إنشاء مخزن بيانات مرة أخرى.
  2. بالنسبة إلى اختيار مصدر بيانات، اختَر BigQuery.
  3. بالنسبة إلى استيراد البيانات المنظَّمة، اختَر جدول BigQuery باستخدام المخطط الخاص بك.
  4. احتفِظ بخيار معدّل تكرار المزامنة على مرة واحدة.
  5. بالنسبة إلى اختيار جدول تريد استيراده، انقر على تصفّح. في مربّع الحوار اختيار المسار الذي يظهر، اختَر جدول employee_finance من مجموعة بيانات cymbal_finance في مشروعك. قد تظهر لك جداول بأسماء مشابهة من مشاريع أخرى، لذا تأكَّد من اختيار الجدول من مشروعك.
  6. انقر على متابعة.
  7. راجِع صفحة مخطط المراجعة وتعيين السمات الرئيسية.
  8. انقر على متابعة.
  9. أدخِل اسم مستودع البيانات على النحو التالي: cymbal-finance.
  10. انقر على متابعة.
  11. الاحتفاظ بخيار الأسعار العامة
  12. انقر على إنشاء.

بعد النقر على إنشاء، ستتم إعادتك إلى صفحة مخازن البيانات.

إنشاء مستودع بيانات لبيانات مستودع المنتجات

  1. في صفحة مخازن البيانات، انقر على إنشاء مخزن بيانات مرة أخرى.
  2. بالنسبة إلى اختيار مصدر بيانات، اختَر BigQuery.
  3. بالنسبة إلى استيراد البيانات المنظَّمة، اختَر جدول BigQuery باستخدام المخطط الخاص بك.
  4. احتفِظ بخيار معدّل تكرار المزامنة على مرة واحدة.
  5. بالنسبة إلى اختيار جدول تريد استيراده، انقر على تصفّح. في مربّع الحوار اختيار المسار الذي يظهر، اختَر جدول product_inventory من مجموعة بيانات cymbal_finance في مشروعك.
  6. انقر على متابعة.
  7. راجِع صفحة مخطط المراجعة وتعيين السمات الرئيسية.
  8. انقر على متابعة.
  9. أدخِل اسم مستودع البيانات على النحو التالي: cymbal-inventory.
  10. انقر على متابعة.
  11. الاحتفاظ بخيار الأسعار العامة
  12. انقر على إنشاء.

بعد النقر على إنشاء، ستتم إعادتك إلى صفحة مخازن البيانات.

8. ربط مخازن البيانات بتطبيقك

من المفترض أن تظهر لك الآن ثلاثة مخازن بيانات في القائمة على صفحة مخازن البيانات: cymbal-hr (غير منظَّمة) وcymbal-finance (منظَّمة) وcymbal-inventory (منظَّمة). لربط مخزنَي البيانات هذين بتطبيقك، اتّبِع الخطوات التالية:

  1. في صفحة مخازن البيانات، اختَر جميع مخازن البيانات الثلاثة التي أنشأتها للتو: cymbal-hr وcymbal-finance وcymbal-inventory. تأكَّد من اختيار جميع مستودعات البيانات الثلاثة قبل المتابعة.
  2. انقر على متابعة.
  3. الاحتفاظ بخيار الأسعار العامة
  4. انقر على إنشاء.

9- اختبار تطبيق بوابة الموظفين Cymbal

  1. في تطبيق cymbal-employee-portal، انقر على معاينة.
  2. في مربّع البحث هنا، أدخِل السؤال التالي:
    What are the stipends that I get as an employee of Cymbal located in London?
  3. أدخِل سؤالاً ذا صلة بمستودع المنتجات:
    How many units of sneakers do we have in stock?
  4. أدخِل سؤالاً آخر:
    What is the stipend for an executive in Cymbal?

لاحظ كيف استردّ تطبيق البحث المعلومات من مصادر متعددة لصياغة رده. للإجابة عن هذه الأسئلة، بحث التطبيق في البيانات المالية المنظَّمة المخزَّنة في BigQuery ومستندات الموارد البشرية غير المنظَّمة في Cloud Storage.

يوضّح ذلك فعالية Vertex AI Search في تلخيص الإجابات من مختلف أشكال البيانات ومخازن البيانات المختلفة في تجربة واحدة متماسكة.

يمكنك أيضًا ضبط نموذج الذكاء الاصطناعي لتقديم إجابات أكثر دقةً وملاءمةً للمجال. لمزيد من المعلومات حول تخصيص التجربة التوليدية، يُرجى الرجوع إلى مستند الحصول على إجابات ومتابعات.

10. خيارات نشر تطبيقك

على الرغم من أنّ نشر التطبيق للمستخدمين النهائيين لا يندرج ضمن نطاق هذا الدرس التطبيقي حول الترميز، من المفيد معرفة كيفية ترجمة ذلك إلى سيناريو واقعي. تتوفّر لك عدة خيارات لدمج تطبيق Vertex AI Search في مهام مؤسستك:

  • تطبيق مصغّر للويب مُنشأ مسبقًا يمكنك تضمين واجهة بحث أو دردشة جاهزة للاستخدام مباشرةً في شبكة الإنترانت أو صفحات الويب الحالية لشركتك باستخدام علامة HTML script. هذه هي أسرع طريقة لعرض تطبيقك أمام المستخدمين.
  • دمج واجهة برمجة تطبيقات مخصّصة: للحصول على تحكّم كامل في تجربة المستخدم، يمكنك استخدام واجهات REST API أو مكتبات البرامج (مثل Python أو Node.js أو Java) في Vertex AI Search لإنشاء واجهة أمامية مخصّصة من البداية.

11. تَنظيم

لتجنُّب الرسوم المستمرة على حسابك على Google Cloud، احذف الموارد التي تم إنشاؤها أثناء استخدام هذا الدرس العملي:

  1. في Cloud Console، انتقِل إلى صفحة Vertex AI Search.
  2. انقر على عرض التطبيقات الحالية.
  3. بالنسبة إلى تطبيق cymbal-employee-portal، انقر على النقاط الثلاث العمودية المزيد، ثم انقر على حذف.
  4. اتّبِع التعليمات الظاهرة على الشاشة لتأكيد الحذف.
  5. لحذف مخازن البيانات، انقر على مخازن البيانات في لوحة التنقّل اليمنى من وحدة التحكّم.
  6. احذف مخازن بيانات cymbal-hr وcymbal-finance وcymbal-inventory باتّباع الخطوات التالية:
    1. بالنسبة إلى مستودع بيانات cymbal-hr، انقر على النقاط الثلاث العمودية المزيد، ثم انقر على حذف.
    2. اتّبِع التعليمات الظاهرة على الشاشة لتأكيد الحذف.
    3. بالنسبة إلى مستودع بيانات cymbal-finance، انقر على النقاط الثلاث العمودية المزيد، ثم انقر على حذف.
    4. اتّبِع التعليمات الظاهرة على الشاشة لتأكيد الحذف.
    5. بالنسبة إلى مستودع بيانات cymbal-inventory، انقر على النقاط الثلاث العمودية المزيد، ثم انقر على حذف.
    6. اتّبِع التعليمات الظاهرة على الشاشة لتأكيد الحذف.
  7. انتقِل إلى صفحة الحِزم واحذف الحزمة التي أنشأتها (على سبيل المثال، cymbal-app-hr-12).
  8. انتقِل إلى صفحة BigQuery واحذف مجموعة البيانات cymbal_finance.

12. تهانينا

اكتملت المهمة! لقد نجحت في إنشاء تجربة بحث موحّدة في المؤسسة باستخدام Vertex AI Search.

من خلال سدّ الفجوة بين بيانات مؤسستك غير المنظَّمة في Cloud Storage والسجلات المنظَّمة من BigQuery، تكون قد أنشأت أداة فعالة قادرة على إجراء عمليات استنتاج معقّدة خاصة بالنشاط التجاري، وكل ذلك بدون كتابة سطر واحد من رمز تعلُّم الآلة.

ما تعلّمته

  • نقل البيانات: كيفية نقل المستندات غير المنظَّمة من Cloud Storage والبيانات المنظَّمة من BigQuery إلى Vertex AI Search
  • الاستعلام عن مخازن بيانات متعددة: كيفية طلب البحث من تطبيق بحث متعدد مستودعات البيانات لتجميع إجابات موحّدة من البيانات المنظَّمة وغير المنظَّمة
  • الضبط والتخصيص كيفية ضبط نماذج الذكاء الاصطناعي التوليدي لتقديم إجابات أكثر دقةً وملاءمةً لمجال معيّن
  • خيارات النشر الطرق المختلفة لدمج إمكانية الاستدلال هذه في التطبيقات الواقعية باستخدام أدوات مسبقة الإنشاء أو واجهات برمجة تطبيقات مخصّصة

المستندات المرجعية