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

يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق من Google Chat يجيب عن الأسئلة استنادًا إلى المحادثات في مساحات Chat باستخدام الذكاء الاصطناعي التوليدي المستند إلى Vertex AI مع Gemini. يستخدم تطبيق 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 مساعِد المعلومات المستند إلى الذكاء الاصطناعي قاعدة بيانات Firestore لتخزين بيانات الرسائل المُرسَلة في مساحة Chat.
  • Pub/Sub: Pub/Sub هي خدمة رسائل غير متزامنة وقابلة للتطوير تفصل الخدمات التي تُنشئ الرسائل عن الخدمات التي تعالج هذه الرسائل. يستخدم تطبيق Chat كمساعد ذكاء اصطناعي (AI) لتلقّي أحداث الاشتراكات من مساحات 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 التالية لإنشاء موارد الحوسبة واستضافتها:

إعداد البيئة

يعرض هذا القسم كيفية إنشاء مشروع على 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: لاستخدام وحدة طرفية على الإنترنت مع إعداد واجهة CLI على gcloud، يمكنك تفعيل 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. في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، واختر حساب فوترة Cloud.
  4. انقر على ضبط الحساب.

gcloud CLI

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

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

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

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

Google Cloud Console

  1. في Google Cloud Console، يمكنك تفعيل 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، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.

    الانتقال إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

  2. ضمن نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.

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

  4. في عنوان البريد الإلكتروني لفريق دعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة مناسبة في Google.

  5. ضمن معلومات الاتصال بالمطوّر، أدخِل عنوان بريدك الإلكتروني.

  6. انقر على حفظ ومتابعة.

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

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

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

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

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

  11. انقر على حفظ ومتابعة.

  12. راجِع ملخّص تسجيل التطبيق، ثم انقر على الرجوع إلى لوحة البيانات.

إنشاء بيانات اعتماد معرِّف عميل 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

  1. إنشاء موضوع نشر/اشتراك باستخدام رقم تعريف الموضوع 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. في Region، حدِّد منطقة لقاعدة بياناتك، مثل us-central1. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو الموقع الجغرافي المجاور نفسه لوظائف السحابة الإلكترونية في تطبيق 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 ونشرها

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

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

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

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

العرض على GitHub

إنشاء ونشر app

Google Cloud Console

  1. قم بتنزيل الرمز من GitHub كملف ZIP.

    تنزيل ملف 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. في حزمة الوجهة، create أو اختَر حزمة:

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

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

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

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

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

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

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

    1. في صفحة تفاصيل دالة Cloud، انقر على تعديل.
    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. في صفحة تفاصيل دالة Cloud، انقر على تعديل.
    2. انقر على التالي.
    3. في الرمز المصدر، اختَر المحرِّر المضمّن.
    4. في المحرِّر المضمّن، افتح ملف env.js وعدِّله:
      1. اضبط قيمة project على رقم تعريف مشروعك على Google Cloud.
      2. اضبط قيمة location على منطقة دالة Cloud، مثل 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

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

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

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

gcloud CLI

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

    gcloud functions describe app

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

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

يوضّح هذا القسم كيفية ضبط Chat API فيconsole‏ (وحدة تحكّم) Google Cloud باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat وعنوان URL المشغِّل لوظيفة Chat Function في 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 لمساعد المعرفة الخاص بالذكاء الاصطناعي في "مساحة Chat" تتضمّن رسائل من خلال طرح أسئلة يمكن لتطبيق Chat المساعد أن يجيب عنها.

في ما يلي بعض الطرق لاختبار ميزة "مساعد المعلومات" المستند إلى الذكاء الاصطناعي في تطبيق 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 لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي:

    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. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.