الإجابة عن الأسئلة استنادًا إلى محادثات 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 الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى مساحة Chat:

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

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

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

    4. ينشر تطبيق Chat رسالة تمهيدية إلى المساحة.

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

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

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

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

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

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

Google Cloud Console

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

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

  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

  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، يمكنك تضمين ملف client_secrets.json في كل عملية نشر.

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

إنشاء موضوع النشر/الاشتراك

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

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

Google Cloud Console

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

    الانتقال إلى نشر/اشتراك

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

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

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

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

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

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

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

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

    3. ضِمن تعيين الأدوار، في اختيار دور، انقر على نشر/اشتراك > ناشر/اشتراك.

    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. في المنطقة، حدِّد منطقة لقاعدة بياناتك، مثل 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 ونشرهما. وأحدهما للرد على أحداث التفاعل عبر الدردشة والآخر للرد على أحداث النشر/الاشتراك.
  2. يمكنك إنشاء تطبيق Chat ونشره في صفحة إعداد Google Chat API.

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

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

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

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

قبل إنشاء دوال السحابة، يمكنك تخصيص بعض الوقت لمراجعة نموذج التعليمات البرمجية المستضافة على 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.

    الانتقال إلى وظائف السحابة الإلكترونية

    تأكَّد من اختيار مشروع 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. انقر على نشر.

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

  15. تحرير نموذج التعليمة البرمجية لتعيين الثوابت:

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

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

واجهة سطر الأوامر gcloud

  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 لمطابقة المنطقة المحدّدة في ملف env.js، مثل us-central1.

إنشاء eventsApp ونشرها

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > 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 from 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، مثل us-central1.

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

واجهة سطر الأوامر gcloud

  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 على رقم تعريف مشروعك على Google 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 لمطابقة المنطقة المحدّدة في ملف env.js، مثل us-central1.

انسخ عنوان URL لمشغِّل app Cloud Function.

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

Google Cloud Console

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

    الانتقال إلى وظائف السحابة الإلكترونية

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

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

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

واجهة سطر الأوامر gcloud

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

    gcloud functions describe app

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

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

يعرض هذا القسم كيفية ضبط واجهة Chat API في Google Cloud Console باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat وعنوان URL المشغّل الخاص بوظيفة السحابة الإلكترونية في تطبيق Chat التي يرسل إليها أحداث التفاعل في 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 الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى مساحة 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.. أغلق نافذة المتصفح أو علامة التبويب وارجع إلى مساحة Chat.

  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 مكلفًا.

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

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

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

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

تَنظيم

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

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

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

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