الإجابة عن الأسئلة استنادًا إلى محادثات Chat باستخدام تطبيق Gemini AI Chat

يوضّح هذا الدليل التعليمي كيفية إنشاء تطبيق Google Chat يجيب عن الأسئلة استنادًا إلى المحادثات في مساحات Chat باستخدام الذكاء الاصطناعي العميق (Gemini) من Vertex AI. يستخدم تطبيق Chat واجهة برمجة التطبيقات Google Workspace Events API بالإضافة إلى Pub/Sub للتعرّف على الأسئلة المُنشرة في مساحات Chat والإجابة عنها في الوقت الفعلي، حتى إذا لم يتم ذكرها.

يستخدم تطبيق Chat جميع الرسائل المُرسَلة في المساحة كمصدر بيانات وقاعدة معلومات: عندما يطرح أحد المستخدمين سؤالاً، يبحث تطبيق Chat عن الإجابات التي تمت مشاركتها سابقًا ثم يشارك أحدها. إذا لم يتم العثور على إجابة، سيُعلمك بأنّه لا يمكنه الإجابة. في كل إجابة، يمكن للمستخدمين النقر على زر إجراء إضافي للإشارة إلى مدير مساحة والسؤال عن إجابة. باستخدام تكنولوجيات الذكاء الاصطناعي في Gemini، يتكيّف تطبيق Google Chat مع قاعدة المعلومات ويطورها أثناء تدريبه المستمر على المحادثات في المساحات التي تتم إضافته إليها.

في ما يلي آلية عمل تطبيق Chat في مساحة الإعداد والدعم للموظفين:

  • يؤدي ذكر تطبيق "مساعد المعلومات" المستنِد إلى الذكاء الاصطناعي إلى إضافته إلى مساحة.
    الشكل 1. يضيف "شارلي" تطبيق Chat المزوّد بخدمة دعم ذكاء اصطناعي إلى مساحة Chat.
  • تطرح "دانا" سؤالاً.
    الشكل 2. تسأل "دانا" ما إذا كانت الشركة تقدّم تدريبًا على التحدث أمام الجمهور.
  • يجيب تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي عن السؤال.
    الشكل 3. يطلب تطبيق Chat من مساعِد الذكاء الاصطناعي Vertex AI مع Gemini الإجابة عن سؤال "دانا" استنادًا إلى سجلّ المحادثات في مساحة Chat، ثم يشارك الإجابة.

المتطلبات الأساسية

الأهداف

  • أنشئ تطبيق Chat يستخدم الذكاء الاصطناعي التوليدي لمحاولة الإجابة عن الأسئلة استنادًا إلى المعرفة التي تتم مشاركتها في محادثات "مساحات Chat".
  • باستخدام الذكاء الاصطناعي التوليدي:
    • رصد أسئلة الموظفين والإجابة عنها
    • الاطّلاع باستمرار على المعلومات من المحادثات الجارية في "مساحة Chat"
  • الاستماع إلى الرسائل في مساحة Chat والرد عليها في الوقت الفعلي حتى إذا لم يتم إرسال رسائل إلى تطبيق Chat مباشرةً
  • الاحتفاظ بالرسائل من خلال الكتابة إلى قاعدة بيانات Firestore والقراءة منها
  • يمكنك تسهيل التعاون في مساحة Chat من خلال الإشارة إلى مديري المساحة عند عدم العثور على إجابة عن سؤال.

الهندسة المعمارية

يوضّح الرسم البياني التالي بنية Google Workspace و موارد Google Cloud التي يستخدمها "مساعِد المعلومات" المستنِد إلى الذكاء الاصطناعي في تطبيق Chat.

مخطّط معماري لتطبيق Chat المزوّد بخدمة مساعدة مستندة إلى الذكاء الاصطناعي

يعمل تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي على النحو التالي:

  • يضيف مستخدم تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) لطلب المعلومات إلى مساحة Chat:

    1. يطلب تطبيق Chat من العميل الذي أضافه إلى مساحة Chat ضبط مصادقة العميل وتفويضه.

    2. يُجلب تطبيق Chat رسائل المساحة من خلال استدعاء طريقة spaces.messages.list في Chat API، ثم يخزِّن الرسائل التي تم جلبها في قاعدة بيانات Firestore.

    3. يستدعي تطبيق Chat الأسلوب subscriptions.create في Google Workspace Events API لبدء الاستماع إلى الأحداث، مثل الرسائل في المساحة. نقطة نهاية إشعار الاشتراك هي موضوع Pub/Sub يستخدم Eventarc لإعادة توجيه الحدث إلى تطبيق Chat.

    4. ينشر تطبيق Chat رسالة تعريفية في المساحة.

  • ينشر مستخدم في "مساحة Chat" رسالة:

    1. يتلقّى تطبيق Chat الرسالة في الوقت الفعلي من موضوع Pub/Sub.

    2. يضيف تطبيق Chat الرسالة إلى قاعدة بيانات Firestore.

      إذا عدّل المستخدم الرسالة أو حذفها لاحقًا، يتلقّى تطبيق Chat الحدث المعدَّل أو المحذوَف في الوقت الفعلي، ثم يعدّل الرسالة أو يحذفها في قاعدة بيانات Firestore.

    3. يُرسِل تطبيق Chat الرسالة إلى Vertex AI باستخدام Gemini:

      1. يوجّه الطلب منصة Vertex AI باستخدام Gemini للتحقّق مما إذا كانت الرسالة تتضمّن سؤالاً. إذا كان الأمر كذلك، يجيب Gemini عن السؤال استنادًا إلى سجلّ رسائل مساحة Chat المحفوظ في Firestore، ثم يرسل تطبيق Google Chat الرسالة إلى مساحة Chat. إذا لم يكن الأمر كذلك، لا تردّ.

      2. إذا كانت Vertex AI مع Gemini تجيب عن السؤال، ينشر تطبيق Chat الجواب عن طريق استدعاء الأسلوب spaces.messages.create في Chat API باستخدام مصادقة التطبيق.

        إذا تعذّر على Vertex AI مع Gemini الإجابة عن السؤال، ينشر تطبيق Chat رسالة تفيد بأنّه لا يمكنه العثور على إجابة عن هذا السؤال في سجلّ مساحة Chat.

        تتضمّن الرسائل دائمًا زرّ إجراء إضافيًا يمكن للمستخدمين النقر عليه، ما يؤدي إلى إرسال تطبيق Chat إشارة @ إلى مدير المساحة لطلب الإجابة.

  • يتلقّى تطبيق Chat إشعارًا بشأن دورة الحياة من واجهة برمجة تطبيقات Google Workspace Events API يفيد بأنّ اشتراك مساحة Chat على وشك الانتهاء:

    1. يُرسِل تطبيق Chat طلبًا لتجديد الاشتراك من خلال استدعاء طريقة subscriptions.patch في Google Workspace Events API.

  • تتم إزالة تطبيق Chat من مساحة Chat:

    1. يحذف تطبيق Chat الاشتراك من خلال استدعاء الأسلوب subscriptions.delete في Google Workspace Events API.

    2. يحذف تطبيق Chat بيانات Chat المساحة من Firestore.

مراجعة المنتجات التي يستخدمها تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي لتوفير المعلومات

يستخدم تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي لطلب المساعدة منتجات Google Workspace وGoogle Cloud التالية:

  • واجهة برمجة التطبيقات Vertex AI API مع Gemini: هي منصة للذكاء الاصطناعي التوليدي تستند إلى Gemini. يستخدم تطبيق Chat واجهة برمجة التطبيقات Vertex AI API مع Gemini لتحديد أسئلة الموظفين وفهمها والإجابة عنها.
  • Chat API: هي واجهة برمجة تطبيقات لتطوير تطبيقات Google Chat التي تتلقّى أحداث التفاعل في Chat وتستجيب لها، مثل الرسائل. يستخدم تطبيق Chat المزوّد بخدمة مساعدة ذكية في الذكاء الاصطناعي واجهة برمجة التطبيقات Chat API لتنفيذ ما يلي:
    • تلقّي أحداث التفاعل المُرسَلة من خلال Chat والردّ عليها
    • عرض قائمة بالرسائل المُرسَلة في مساحة
    • نشر ردود على أسئلة المستخدمين في مساحة
    • ضبط السمات التي تحدّد كيفية ظهورها في Chat، مثل الاسم والصورة الرمزية
  • Google Workspace Events API: تتيح لك واجهة برمجة التطبيقات هذه الاشتراك في الأحداث وإدارة إشعارات التغييرات على مستوى تطبيقات Google Workspace. يستخدم تطبيق Chat المساعد المزوّد بذكاء اصطناعي واجهة برمجة التطبيقات Google Workspace Events API للاستماع إلى الرسائل المنشورة في مساحة Chat حتى يتمكّن من رصد الأسئلة والإجابة عنها حتى إذا لم تتم الإشارة إليه.
  • Firestore: قاعدة بيانات مستندات لا تستخدِم خادمًا يستخدم تطبيق Chat مساحات Chat لخدمة الذكاء الاصطناعي (AI) لحفظ بيانات الرسائل المُرسَلة في مساحة Chat.
  • Pub/Sub: Pub/Sub هي خدمة رسائل غير متزامنة وقابلة للتطوير تفصل الخدمات التي تُنشئ الرسائل عن الخدمات التي تعالج هذه الرسائل. يستخدم تطبيق Chat المساعد المزوّد بذكاء اصطناعي Pub/Sub لتلقّي أحداث الاشتراك من مساحات Chat.
  • Eventarc: تسمح لك Eventarc بإنشاء تصاميم مستندة إلى الأحداث بدون الحاجة إلى تنفيذ البنية الأساسية أو تخصيصها أو صيانتها. يستخدم تطبيق Chat المزوّد بذكاء اصطناعي مساعد المعلومات، Eventarc لتوجيه الأحداث من Pub/Sub إلى مساحة Chat و Cloud Function التي تتلقّى أحداث الاشتراك وتعالجها.
  • Cloud Functions: خدمة حوسبة بدون خادم خفيفة الوزن تتيح لك إنشاء دوال مستقلة ذات غرض واحد يمكنها الاستجابة لأحداث تفاعل Chat والاشتراك بدون الحاجة إلى إدارة بيئة خادم أو وقت تشغيل يستخدم تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) لطلب المساعدة وظيفتَي Cloud Functions باسمَي:
    • app: استضافة نقطة نهاية HTTP التي تُرسِل Chat إليها أحداث التفاعل، واستخدامها كنظام أساسي لمعالجة المنطق الذي يعالج هذه الأحداث ويستجيب لها
    • ‫eventsApp: لتلقّي أحداث مساحة Chat ومعالجتها، مثل الرسائل الواردة من اشتراك Pub/Sub
    تستخدِم Cloud Functions منتجات Google Cloud التالية لإنشاء موارد الحوسبة واستضافتها:
    • Cloud Build: منصّة تكامل وتسليم ونشر مستمر مُدارة بالكامل تعمل على إنشاء إصدارات مبرمَجة.
    • Cloud Run: بيئة مُدارة بالكامل لتشغيل التطبيقات المُضمَّنة في حاويات

إعداد البيئة

يوضّح هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده لتطبيق Chat.

إنشاء مشروع على Google Cloud

Google Cloud Console

  1. في Google Cloud Console، انتقِل إلى القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.

    الانتقال إلى "إنشاء مشروع"

  2. في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.

    اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير معرّف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدّة المشروع.

  3. في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتملة لمشروعك. بعد ذلك، انقر على اختيار.
  4. انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك خلال بضع دقائق.

gcloud CLI

في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud CLI (gcloud):

  • Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد واجهة سطر أوامر gcloud CLI عليها، فعِّل Cloud Shell.
    تفعيل Cloud Shell
  • Shell المحلي: لاستخدام بيئة تطوير محلية، ثبِّت افتح أداة gcloud CLI.
    لإنشاء مشروع على Cloud، استخدِم الأمر gcloud projects create: 
    gcloud projects create PROJECT_ID
     استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.

تفعيل الفوترة لمشروع Cloud

Google Cloud Console

  1. في Google Cloud Console، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.

    الانتقال إلى "الفوترة لمشاريعي"

  2. في اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
  3. في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، واختَر حساب "الفوترة في السحابة الإلكترونية".
  4. انقر على ضبط الحساب.

gcloud CLI

  1. لعرض حسابات الفوترة المتاحة، يمكنك تنفيذ ما يلي: 
    gcloud billing accounts list
  2. ربط حساب فوترة بمشروع على Google Cloud: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    غيِّر القيم في السلسلة على الشكل التالي:

    • PROJECT_ID هو رقم تعريف المشروع لمشروع Cloud الذي تريد تفعيل الفوترة له.
    • BILLING_ACCOUNT_ID هو معرّف حساب الفوترة المطلوب ربطه بمشروع Google Cloud.

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

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، فعِّل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub API وGoogle Workspace Events API وEventarc API وCloud Run Admin API.

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

  2. تأكَّد من أنّك تفعّل واجهات برمجة التطبيقات في مشروع Cloud الصحيح، ثم انقر على التالي.

  3. تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.

gcloud CLI

  1. إذا لزم الأمر، اضبط مشروع Cloud الحالي على المشروع الذي أنشأته:

    gcloud config set project PROJECT_ID

    استبدِل PROJECT_ID بـ رقم تعريف المشروع لمشروع Cloud الذي أنشأته.

  2. فعِّل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub API وGoogle Workspace Events API وEventarc API وCloud Run Admin API:

    gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
workspaceevents.googleapis.com \
eventarc.googleapis.com \
run.googleapis.com

إعداد المصادقة والتفويض

تتيح المصادقة والتفويض لتطبيق Chat الوصول إلى الموارد في Google Workspace و Google Cloud.

في هذا البرنامج التعليمي، ستنشر تطبيق Google Chat داخليًا، لذا يُسمح باستخدام معلومات العنصر النائب. قبل نشر تطبيق Google Chat خارجيًا، استبدِل معلومات العنصر النائب باطلاعات حقيقية لشاشة طلب الموافقة.

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > > العلامة التجارية.

    الانتقال إلى "الهوية البصرية للعلامة التجارية"

  2. إذا سبق لك ضبط ، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في العلامة التجارية، شريحة الجمهور، والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّه لم يتم ضبطه بعد، انقر على البدء:

    1. ضمن معلومات التطبيق، في اسم التطبيق، اكتب AI knowledge assistant.
    2. في عنوان البريد الإلكتروني لفريق دعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة مناسبة في Google.
    3. انقر على التالي.
    4. ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
    5. انقر على التالي.
    6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكن إعلامك من خلاله بأي تغييرات تطرأ على مشروعك.
    7. انقر على التالي.
    8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا كنت توافق عليها، انقر على أوافق على سياسة بيانات المستخدمين في خدمات Google API.
    9. انقر على متابعة.
    10. انقر على إنشاء.
    11. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
      1. انقر على الجمهور.
      2. ضمن مستخدمو الاختبار، انقر على إضافة مستخدمين.
      3. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين آخرين معتمَدين للاختبار، ثم انقر على حفظ.

  3. انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. تظهر لوحة تتضمّن قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.

    1. ضمن إضافة النطاقات يدويًا، الصِق النطاق التالي:

      • https://www.googleapis.com/auth/chat.messages

    2. انقر على الإضافة إلى الجدول.

    3. انقر على تعديل.

    4. بعد اختيار النطاقات المطلوبة لتطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

إنشاء بيانات اعتماد معرِّف عميل OAuth

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.

    الانتقال إلى "بيانات الاعتماد"

  2. انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.

  3. انقر على نوع التطبيق > تطبيق الويب.

  4. في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في "وحدة تحكّم Google Cloud".

  5. ضمن معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على إضافة معرّف الموارد المنتظم (URI).

  6. في معرّفات الموارد المنتظمة 1، اكتب ما يلي:

    https://REGION-PROJECT_ID.cloudfunctions.net/app/oauth2

    غيِّر القيم في السلسلة على الشكل التالي:

    • ‫REGION: منطقة Cloud Function، مثل us-central1. لاحقًا، عند إنشاء وظيفتَي Cloud Functions، عليك ضبط region على هذه القيمة.
    • PROJECT_ID: رقم تعريف المشروع لمشروع Cloud الذي أنشأته.

  7. انقر على إنشاء.

  8. من نافذة تم إنشاء عميل OAuth، انقر على تنزيل ملف JSON.

  9. احفظ الملف الذي تم تنزيله باسم client_secrets.json. لاحقًا، عند إنشاء وظيفتَي Cloud Functions، يمكنك تضمين ملف client_secrets.json في كل عملية نشر.

  10. انقر على موافق.

إنشاء موضوع Pub/Sub

يعمل موضوع Pub/Sub مع Google Workspace Events API للاشتراك في الأحداث في مساحة Chat، مثل الرسائل وإرسال إشعارات إلى تطبيق Chat في الوقت الفعلي.

في ما يلي كيفية إنشاء موضوع Pub/Sub:

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Pub/Sub.

    الانتقال إلى Pub/Sub

  2. انقر على إنشاء موضوع.

  3. في رقم تعريف الموضوع، اكتب events-api.

  4. أزِل العلامة من المربّع بجانب إضافة اشتراك تلقائي.

  5. ضمن التشفير، اختَر مفتاح التشفير الذي تديره Google.

  6. انقر على إنشاء. يظهر موضوع Pub/Sub.

  7. لكي يعمل موضوع Pub/Sub وGoogle Workspace Events API معًا، منح مستخدم Chat IAM إذنًا بالنشر في موضوع Pub/Sub:

    1. في لوحة events-api، ضِمن الأذونات، انقر على إضافة عنصر رئيسي.

    2. ضمن إضافة عناصر أساسية، في عناصر أساسية جديدة، اكتب chat-api-push@system.gserviceaccount.com.

    3. ضمن إسناد الأدوار، في اختيار دور، اختَر Pub/Sub > ناشر Pub/Sub.

    4. انقر على حفظ.

gcloud CLI

  1. أنشئ موضوعًا على Pub/Sub باستخدام معرّف الموضوع events-api:

    gcloud pubsub topics create events-api

  2. امنح مستخدم Chat IAM إذن النشر فيموضوع Pub/Sub:

    gcloud pubsub topics add-iam-policy-binding events-api \
--member='serviceAccount:chat-api-push@system.gserviceaccount.com' \
--role='roles/pubsub.publisher'

إنشاء قاعدة بيانات Firestore

تُخزِّن قاعدة بيانات Firestore البيانات من مساحات Chat، مثل الرسائل، وتسترجعها. لا يتم تحديد ملف data model، والذي يتم ضبطه بشكل ضمني في نموذج الرمز البرمجي من خلال الملفَين model/message.js و services/firestore-service.js.

تستخدِم قاعدة بيانات تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) لطلب المعلومات نموذج بيانات NoSQL استنادًا إلى المستندات المُنظَّمة في المجموعات. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج بيانات Firestore.

يقدّم المخطّط البياني التالي نظرة عامة على نموذج بيانات "مساعد المعلومات بالذكاء الاصطناعي" في تطبيق Chat:

نموذج بيانات قاعدة بيانات Firestore

يحتوي الجذر على مجموعتَين:

  1. spaces، حيث يمثّل كل مستند مساحة Chat التي تتم إضافة تطبيق Chat إليها. يتم تمثيل كل رسالة بمستند في المجموعة الفرعية messages.

  2. users، حيث يمثّل كل مستند مستخدمًا أضاف تطبيق Chat إلى مساحة Chat.

عرض تعريفات المجموعات والمستندات والحقول

spaces

مساحة Chat تتضمّن تطبيق Chat المساعد المزوّد بذكاء اصطناعي

الحقول
Document IDString
المعرّف الفريد لمساحة معيّنة. جزء من اسم مورد المساحة في Chat API
messagesSubcollection of Documents (messages)
الرسائل المُرسَلة في مساحة Chat تتوافق مع Document ID message في Firebase.
spaceNameString
الاسم الفريد للمساحة في Chat API تتوافق مع اسم مورد المساحة في Chat API.

messages

الرسائل المُرسَلة في مساحة Chat

الحقول
Document IDString
المعرّف الفريد لرسالة معيّنة.
nameString
الاسم الفريد لرسالة في Chat API تتوافق مع اسم مورد الرسالة في Chat API.
textString
نص الرسالة.
timeString (Timestamp format)
الوقت الذي تم إنشاء الرسالة فيه

users

المستخدمون الذين أضافوا تطبيق Chat الذي يستند إلى الذكاء الاصطناعي (AI) إلى مساحة Chat

الحقول
Document IDString
المعرّف الفريد لمستخدم معيّن.
accessTokenString
رمز الوصول الذي تم منحه أثناء تفويض مستخدم OAuth 2.0 المستخدَم للاتصال بـ Google Workspace APIs
refreshTokenString
الرمز المميّز لإعادة التحميل الذي تم منحه أثناء تفويض مستخدم OAuth 2.0.

في ما يلي كيفية إنشاء قاعدة بيانات Firestore:

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Firestore.

    الانتقال إلى Firestore

  2. انقر على إنشاء قاعدة بيانات.

  3. من اختيار وضع Firestore، انقر على الوضع المضمّن.

  4. انقر على متابعة.

  5. ضبط قاعدة البيانات:

    1. في قسم تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات على (default).

    2. ضمن نوع الموقع الجغرافي، اختَر المنطقة.

    3. في المنطقة، حدِّد منطقة لقاعدة بياناتك، مثل us-central1. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو موقعًا قريبًا مماثلاً لـ Cloud Functions في تطبيق Chat.

  6. انقر على إنشاء قاعدة بيانات.

gcloud CLI

  • أنشئ قاعدة بيانات Firestore في الوضع الأصلي:

    gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native

    استبدِل LOCATION باسم منطقة Firestore، مثل us-central1. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو موقعًا قريبًا من موقع Cloud Functions في تطبيق Chat.

إنشاء تطبيق Chat ونشره

بعد إنشاء مشروعك على Google Cloud وضبطه، تكون مستعدًا لإنشاء ونشر تطبيق Chat. في هذا القسم، عليك تنفيذ الخطوات التالية:

  1. أنشئ وظيفتَي Cloud Functions ونشرهما. أحدهما للردّ على أحداث تفاعل Chat ، والآخر للردّ على أحداث Pub/Sub.
  2. أنشئ تطبيق Chat ونشره في صفحة إعدادات Google Chat API.

إنشاء دوال Cloud ونشرها

في هذا القسم، يمكنك إنشاء ونشر دالتَي Cloud Functions باسمَي:

  • ‫app: يستضيف ويشغّل رمز تطبيق Chat الذي يستجيب للأحداث التي يتم تلقّيها من Chat كطلبات HTTP.
  • ‫eventsApp: لتلقّي أحداث مساحة Chat ومعالجتها، مثل الرسائل الواردة من Pub/Sub

تشكل وظائف Cloud هذه معًا قاعدة تطبيق "مساعد المعلومات بالذكاء الاصطناعي" لتطبيق Chat.

يمكنك اختياريًا قبل إنشاء وظائف Cloud، تخصيص بعض الوقت لمراجعة ملف نموذج الرمز البرمجي المستضاف على GitHub والتعرّف عليه.

العرض على GitHub

إنشاء app ونشره

Google Cloud Console

  1. نزِّل الرمز البرمجي من GitHub كملف مضغوط.

    تنزيل ملف zip

  2. استخرِج ملف ZIP الذي تم تنزيله.

    يحتوي المجلد الذي تم استخراجه على مستودع نماذج Google Workspace بالكامل.

  3. في المجلد الذي تم استخراجه، انتقِل إلى الدليل google-chat-samples-main/node/ai-knowledge-assistant.

  4. في الدليل google-chat-samples/node/ai-knowledge-assistant، أضِف ملف client_secrets.json الذي نزّلته عند إنشاء بيانات اعتماد معرّف عميل OAuth للمصادقة والتفويض.

  5. اضغط محتويات مجلد ai-knowledge-assistant في ملف zip.

    يجب أن يحتوي الدليل الجذر لملف zip على الملفات والمجلدات التالية:

    • .gcloudignore
    • .gitignore
    • README.md
    • deploy.sh
    • env.js
    • events_index.js
    • http_index.js
    • index.js
    • client_secrets.json
    • package-lock.json
    • package.json
    • controllers/
    • model/
    • services/
    • test/

  6. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Cloud Functions.

    الانتقال إلى Cloud Functions

    تأكَّد من اختيار مشروع Google Cloud لتطبيق Chat.

  7. انقر على إنشاء دالة.

  8. في صفحة إنشاء دالة، اضبط إعدادات الدالة:

    1. في البيئة، اختَر وظيفة Cloud Run.
    2. في اسم الدالة، اكتب app.
    3. في المنطقة، اختَر منطقة، مثل us-central1. يجب أن تتطابق هذه المنطقة مع المنطقة التي ضبطتها في معرّف الموارد المنتظم (URI) المُصرَّح به لإعادة التوجيه عند إنشاء بيانات اعتماد معرّف عميل OAuth للمصادقة والتفويض.
    4. في نوع العامل المشغِّل، اختَر HTTPS.
    5. ضمن المصادقة، اختَر السماح بطلبات التنفيذ غير المعتمَدة.
    6. انقر على التالي.

  9. في وقت التشغيل، اختَر Node.js 20.

  10. في نقطة الدخول، احذف النص التلقائي وأدخِل app.

  11. في رمز المصدر، اختَر تحميل ملفات بتنسيق ZIP.

  12. في حزمة الوجهة، أنشئ أو اختَر حزمة:

    1. انقر على تصفّح.
    2. اختَر حزمة.
    3. انقر على اختيار.

    تحمِّل Google Cloud ملف ZIP إلى حزمة التخزين هذه وتستخرج منه الملفات المكوّنة. بعد ذلك، تنسخ Cloud Functions ملفات المكوّنات إلى دالة Cloud.

  13. في ملف ZIP، حمِّل ملف ZIP الذي نزّلته من GitHub واستخرجته وأعدته للضغط:

    1. انقر على تصفّح.
    2. انتقِل إلى ملف zip واختَره.
    3. انقر على فتح.

  14. انقر على نشر.

    يتم فتح صفحة تفاصيل دوال Cloud، وتظهر دالة مع اثنين من مؤشرات التقدّم: أحدهما للإنشاء والآخر للخدمة. عندما يختفي مؤشّرَا التقدّم ويتم استبدالهما بعلامة تمييز، يعني ذلك أنّه تم نشر وظيفتك وأنّها جاهزة.

  15. عدِّل الرمز البرمجي النموذجي لضبط الثوابت:

    1. في صفحة تفاصيل دالة السحابة الإلكترونية، انقر على تعديل.
    2. انقر على التالي.
    3. في الرمز المصدر، اختَر المحرِّر المضمّن.
    4. في المحرِّر المضمّن، افتح ملف env.js وعدِّله:
      1. اضبط قيمة project على رقم تعريف مشروعك على Cloud.
      2. اضبط قيمة location على منطقة دالة Cloud Function، مثل us-central1.

  16. انقر على نشر.

gcloud CLI

  1. استنسِخ الرمز من GitHub:

    git clone https://github.com/googleworkspace/google-chat-samples.git

  2. انتقِل إلى الدليل الذي يحتوي على رمز تطبيق Chat المزوّد بخدمة مساعدة مستندة إلى الذكاء الاصطناعي:

    cd google-chat-samples/node/ai-knowledge-assistant

  3. في الدليل google-chat-samples/node/ai-knowledge-assistant، أضِف ملف client_secrets.json الذي نزّلته عند إنشاء بيانات اعتماد معرّف عميل OAuth للمصادقة والتفويض.

  4. عدِّل ملف env.js لضبط متغيّرات البيئة:

    1. اضبط قيمة project على معرّف مشروعك على Cloud.
    2. اضبط قيمة location على منطقة دالة Cloud Function، مثل us-central1.

  5. يمكنك نشر "وظيفة السحابة الإلكترونية" على Google Cloud باتّباع الخطوات التالية:

    gcloud functions deploy app \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=app \
--trigger-http \
--allow-unauthenticated

    استبدِل REGION بقيمة المنطقة لوظيفة Cloud Function لمطابقة القيمة التي تم ضبطها في ملف env.js، مثل us-central1.

إنشاء eventsApp ونشره

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Cloud Functions.

    الانتقال إلى Cloud Functions

    تأكَّد من اختيار مشروع Google Cloud لتطبيق Chat.

  2. انقر على إنشاء دالة.

  3. في صفحة إنشاء دالة، اضبط إعدادات الدالة:

    1. في البيئة، اختَر وظيفة Cloud Run.
    2. في اسم الدالة، اكتب eventsApp.
    3. في المنطقة، اختَر منطقة، مثل us-central1. يجب أن تتطابق هذه المنطقة مع المنطقة التي ضبطتها في معرّف الموارد المنتظم (URI) المُصرَّح به لإعادة التوجيه عند إنشاء بيانات اعتماد معرّف عميل OAuth للمصادقة والتفويض.
    4. في نوع المشغِّل، اختَر Cloud Pub/Sub.
    5. في موضوع Cloud Pub/Sub، اختَر اسم موضوع Pub/Sub الذي أنشأته، والذي يكون بالتنسيق projects/PROJECT/topics/events-api حيث PROJECT هو معرّف مشروعك على Cloud.
    6. إذا ظهرت رسالة تبدأ برمز Service account(s) might not have enough permissions to deploy the function with the selected trigger.، انقر على منح الكل.
    7. انقر على التالي.

  4. في وقت التشغيل، اختَر Node.js 20.

  5. في نقطة الدخول، احذف النص التلقائي وأدخِل eventsApp.

  6. في الرمز المصدر، اختَر Zip من Cloud Storage.

  7. في موقع Cloud Storage، انقر على تصفّح.

  8. اختَر الحزمة التي حمّلت ملف zip إليها عند إنشاء app Cloud Function.

  9. انقر على ملف ZIP الذي حمّلته.

  10. انقر على اختيار.

  11. انقر على نشر.

    يتم فتح صفحة تفاصيل دوال Cloud، وتظهر دالة مع ثلاثة مؤشرات للتقدّم: مؤشر للإنشاء، ومؤشر للخدمة، ومؤشر للعامل المشغِّل. عندما تختفي مؤشرات التقدّم الثلاثة ويحلّ محلّها علامة اختيار، يعني ذلك أنّه تم نشر الدالة وأنّها جاهزة.

  12. عدِّل الرمز البرمجي النموذجي لضبط الثوابت:

    1. في صفحة تفاصيل دالة السحابة الإلكترونية، انقر على تعديل.
    2. انقر على التالي.
    3. في الرمز المصدر، اختَر المحرِّر المضمّن.
    4. في المحرِّر المضمّن، افتح ملف env.js وعدِّله:
      1. اضبط قيمة project على رقم تعريف مشروعك على Cloud.
      2. اضبط قيمة location على منطقة دالة Cloud Function، مثل us-central1.

  13. انقر على نشر.

gcloud CLI

  1. في gcloud CLI، إذا لم تكن في هذا الدليل، انتقِل إليه، وهو يحتوي على رمز تطبيق Chat الذي يستند إلى الذكاء الاصطناعي والذي سبق أن صعّدته من GitHub:

    cd google-chat-samples/node/ai-knowledge-assistant

  2. في الدليل google-chat-samples/node/ai-knowledge-assistant، أضِف ملف client_secrets.json الذي نزّلته عند إنشاء بيانات اعتماد معرّف عميل OAuth للمصادقة والتفويض.

  3. عدِّل ملف env.js لضبط متغيّرات البيئة:

    1. اضبط قيمة project على معرّف مشروعك على Cloud.
    2. اضبط قيمة location على منطقة دالة Cloud Function، مثل us-central1.

  4. يمكنك نشر "وظيفة السحابة الإلكترونية" على Google Cloud باتّباع الخطوات التالية:

    gcloud functions deploy eventsApp \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=eventsApp \
--trigger-topic=events-api

    استبدِل REGION بقيمة المنطقة لوظيفة Cloud Function لمطابقة القيمة التي تم ضبطها في ملف env.js، مثل us-central1.

انسخ عنوان URL لعامل تشغيل app Cloud Function.

يمكنك لصق عنوان URL لبدء app Cloud Function في القسم التالي عند ضبط تطبيق Chat في Google Cloud Console.

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Cloud Functions.

    الانتقال إلى Cloud Functions

  2. في عمود الاسم ضمن قائمة "دوات Cloud"، انقر على رمز app.

  3. انقر على عبارة التشغيل.

  4. انسخ عنوان URL.

gcloud CLI

  1. وصف دالة app في السحابة الإلكترونية:

    gcloud functions describe app

  2. انسخ السمة url.

ضبط تطبيق Chat في Google Cloud Console

يوضّح هذا القسم كيفية ضبط Chat API في Google Cloud Console باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat وعنوان URL المشغِّل لوظيفة Chat في Cloud التي يُرسِل إليها أحداث التفاعل في Chat.

  1. في وحدة تحكّم Google Cloud، انقر على القائمة > المزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد.

    الانتقال إلى إعدادات Chat API

  2. في حقل اسم التطبيق، اكتب AI knowledge assistant.

  3. في عنوان URL للصورة الرمزية، اكتب https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/live_help/default/24px.svg.

  4. في حقل الوصف، اكتب Answers questions with AI.

  5. انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيل هذا الخيار.

  6. ضمن الوظيفة، اختَر الانضمام إلى المساحات والمحادثات الجماعية.

  7. ضمن إعدادات الاتصال، اختَر عنوان URL لنقطة نهاية HTTP.

  8. في عنوان URL لنقطة نهاية HTTP، الصِق عنوان URL للعامل المشغِّل من app Cloud Function بالتنسيق التالي: https://REGION-PROJECT_ID.cloudfunctions.net/app حيث يكون REGION هو منطقة Cloud Function، مثل us-central1 وPROJECT_ID هو معرّف المشروع لمشاريع Cloud التي أنشأتها.

  9. ضمن مستوى الرؤية، اختَر إتاحة تطبيق Chat هذا لأشخاص ومجموعات معيّنة في نطاق Workspace وأدخِل عنوان بريدك الإلكتروني.

  10. اختياريًا، ضمن السجلّات، اختَر تسجيل الأخطاء في السجلّ.

  11. انقر على حفظ. تظهر رسالة "تم حفظ الإعدادات"، ما يعني أنّ تطبيق Chat جاهز للاختبار.

اختبار تطبيق Chat

يمكنك اختبار تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) في مساحة Chat التي تتضمّن رسائل من خلال طرح أسئلة يمكن لتطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) الإجابة عنها.

في ما يلي بعض الطرق لاختبار ميزة "مساعد المعلومات" المستند إلى الذكاء الاصطناعي في تطبيق Chat:

  • أضِف تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) إلى مساحة Chat حالية واطرح أسئلة ذات صلة بتلك المساحة.
  • أنشئ مساحة Chat وانشر بعض الرسائل لاستخدامها كهي مصدر بيانات. يمكن الحصول على الرسائل من Gemini باستخدام طلب مثل Answer 20 common onboarding questions employees ask their teams. أو يمكنك لصق بضع فقرات من دليل نظرة عامة على تطوير المحتوى باستخدام Chat ثم طرح أسئلة حولها.

في هذا الدليل التعليمي، لننشئ مساحة Chat ونلصق بعض الفقرات من دليل نظرة عامة على التطوير باستخدام Chat.

  1. افتح Google Chat.

    الانتقال إلى Google Chat

  2. لإنشاء مساحة Chat:

    1. انقر على محادثة جديدة > إنشاء مساحة.

    2. في اسم المساحة، اكتب Testing AI knowledge assistant app.

    3. ضمن ما الغرض من هذه المساحة؟، اختَر التعاون.

    4. ضمن إعدادات الوصول، اختَر المستخدمين الذين يمكنهم الوصول إلى المساحة.

    5. انقر على إنشاء.

  3. أضِف الرسائل لاستخدامها كمصدر بيانات:

    1. في متصفّح ويب، انتقِل إلى دليل نظرة عامة على التطوير باستخدام Chat.

    2. انسخ محتوى الدليل والصقه في مساحة Chat التي أنشأتها.

  4. أضِف تطبيق Chat المزوّد بخدمة الذكاء الاصطناعي (AI) لمساعدتك في الحصول على المعلومات:

    1. في شريط إنشاء الرسائل، اكتب @AI knowledge assistant وفي قائمة الاقتراحات التي تظهر، اختَر ميزة "مساعد المعلومات بالذكاء الاصطناعي" تطبيق Chat، ثم اضغط على enter.

    2. تظهر رسالة تطلب منك تحديد ما إذا كنت تريد إضافة تطبيق Chat المزوّد بخدمة المساعد الذكي المعنيّ بالمعرفة إلى المساحة. انقر على الإضافة إلى المساحة.

    3. إذا كانت هذه هي المرة الأولى التي تضيف فيها تطبيق Chat إلى مساحة، عليك ضبط إعدادات المصادقة والتفويض لتطبيق Chat:

      1. انقر على ضبط.
      2. ستفتح نافذة أو علامة تبويب متصفّح جديدة تطلب منك اختيار حساب Google. اختَر الحساب الذي تختبِر معه.
      3. راجِع الأذونات التي يطلبها تطبيق Chat المزوّد بخدمة "مساعد المعلومات الذكي". لمنح الإذن، انقر على السماح.
      4. ستظهر رسالة You may close this page now.. أغلِق نافذة المتصفّح أو علامتها التبويب وانتقِل إلى مساحة المحادثة.

  5. طرح سؤال:

    1. في شريط كتابة الرسائل، اكتب سؤالاً مثل: What are Google Chat apps?

    2. يقدّم تطبيق Chat إجابات من خلال ميزة "مساعد المعلومات" المستند إلى الذكاء الاصطناعي.

    3. إذا لم تكن الإجابة دقيقة أو كافية، يمكنك اختياريًا النقر على الحصول على مساعدة لتحسين سجلّ المحادثات في الذكاء الاصطناعي. يُشير تطبيق Chat إلى مدير مساحة ويطلب منه الإجابة عن السؤال. في المرة القادمة، ستعرف إجابة السؤال بمساعدة تطبيق Chat المزوّد بخدمة مساعدة ذكاء اصطناعي.

الاعتبارات وخيارات البنية البديلة والخطوات التالية

يراجع هذا القسم طرقًا أخرى يمكن من خلالها إنشاء تطبيق Chat المزوّد بخدمة مساعدة ذكاء اصطناعي.

Firestore أو Cloud Storage أو طلب عرض الرسائل في Chat API

ينصح هذا الدليل التعليمي بتخزين بيانات مساحة Chat، مثل الرسائل في قاعدة بيانات Firestore لأنّ ذلك يُحسِّن الأداء مقارنةً باستدعاء طريقة list في مورد Message باستخدام Chat API في كل مرة يجيب فيها تطبيق Chat عن سؤال. بالإضافة إلى ذلك، يمكن أن يؤدي الاتصال بواجهة برمجة التطبيقات list messages بشكل متكرر إلى وصول تطبيق Chat إلى حدود حصة واجهة برمجة التطبيقات.

ومع ذلك، إذا أصبح سجلّ المحادثات في مساحة Chat طويلاً جدًا، يمكن أن يصبح استخدام Firestore مكلفًا.

خدمة التخزين في السحابة الإلكترونية هي بديل لـ Firestore. تحصل كل مساحة يكون فيها تطبيق Chat مفعّلاً على عنصر خاص بها، وكل عنصر هو ملف نصي يحتوي على كل الرسائل في المساحة. تتمثل ميزة هذا النهج في أنّه يمكن إرسال المحتوى الكامل للملف النصي إلى Vertex AI باستخدام Gemini في آنٍ واحد، ولكنّ العيب هو أنّه يتطلّب المزيد من العمل لتعديل سجلّ المحادثات لأنّه لا يمكنك إلحاق عنصر بعنصر آخر في Cloud Storage، بل يمكنك استبداله فقط. لا يكون هذا النهج منطقيًا إذا كنت تعدِّل ملف سجلّ الرسائل بانتظام، ولكنّه سيكون خيارًا جيدًا إذا كنت تعدِّل ملف سجلّ الرسائل بشكل مجمّع بشكل دوري، مثلاً مرة واحدة في الأسبوع.

تحديد المشاكل وحلّها

عندما يعرض تطبيق Google Chat أو بطاقة خطأ، تظهر في واجهة Chat رسالة تفيد بأنّ "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا يعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج عن تطبيق Chat أو البطاقة نتيجة غير متوقّعة. على سبيل المثال، قد لا تظهر رسالة البطاقة .

على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتصحيح الأخطاء، يُرجى الاطّلاع على تحديد مشاكل Google Chat وحلّها.

تَنظيم

لتجنُّب تحمُّل رسوم على حسابك على Google Cloud مقابل موارد المستخدَمة في هذا الدليل التعليمي، ننصحك بحذف مشروع Cloud.

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

    انتقِل إلى "مدير الموارد"

  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.