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

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

يستخدم تطبيق Chat جميع الرسائل المُرسَلة في المساحة كـ مصدر بيانات وقاعدة معرفية: عندما يطرح شخص ما سؤالاً، فإن يتحقّق تطبيق Chat من الإجابات التي تمت مشاركتها سابقًا، ثم على مشاركة واحدة. إذا لم يتم العثور على أي إجابة، هذا يعني أنّه لا يمكن الإجابة. في كل إجابة، يمكن للمستخدمين النقر على زر إجراء في الملحق للإشارة باستخدام @إلى مدير مساحة وتوجيه طلب. للعثور على إجابة. من خلال استخدام Gemini AI، يتكيّف تطبيق 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

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

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

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

مراجعة المنتجات التي يستخدمها تطبيق Chat لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي

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

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

تحضير البيئة

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

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

وحدة التحكّم في Google Cloud

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

    الانتقال إلى صفحة "إنشاء مشروع"

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

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

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

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

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

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

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

وحدة التحكّم في Google Cloud

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

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

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

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

  1. لسرد حسابات الفوترة المتاحة، شغِّل: 
    gcloud billing accounts list
  2. ربط حساب فوترة بمشروع على Google Cloud: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    استبدِل ما يلي:

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

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

وحدة التحكّم في Google Cloud

  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. تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.

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

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

  1. إذا لزم الأمر، اضبط المشروع الحالي على السحابة الإلكترونية على المشروع تاريخ الإنشاء:

    gcloud config set project PROJECT_ID

    استبدِل PROJECT_ID برقم تعريف المشروع المشروع الذي أنشأته على السحابة الإلكترونية

  2. تفعيل Google Chat API وVertex AI API وCloud Functions API واجهة برمجة تطبيقات Firestore وCloud Build API وPub/Sub API واجهة برمجة تطبيقات أحداث Google Workspace وEventarc API ومشرف Cloud Run واجهة برمجة التطبيقات:

    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. انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تحتوي على قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعَّلتها في مشروعك على Google 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. في معرّفات الموارد المنتظمة (URI) 1، اكتب ما يلي:

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

    استبدِل ما يلي:

    • REGION: منطقة دالّة السحابة الإلكترونية، مثل us-central1. لاحقًا، عند إنشاء دالتَي السحابة الإلكترونية، يجب تحديد المنطقة بهذه القيمة.
    • PROJECT_ID: رقم تعريف المشروع للمشروع على Google Cloud قمت بإنشائه.

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

  8. من النافذة التي تم إنشاؤها باستخدام عميل OAuth، انقر على تنزيل JSON.

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

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

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

يعمل موضوع النشر/الاشتراك مع واجهة Google Workspace Events API للاشتراك في الأحداث في Chat المساحة مثل الرسائل وإشعار تطبيق Chat مباشرةً الوقت.

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

وحدة التحكّم في Google Cloud

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

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

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

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

  4. ألغِ اختيار إضافة اشتراك تلقائي.

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

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

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

    1. في لوحة events-api، ضمن events-api، انقر على إضافة مدير

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

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

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

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

  1. إنشاء موضوع نشر/اشتراك باستخدام رقم تعريف الموضوع events-api:

    gcloud pubsub topics create events-api

  2. منح مستخدم "إدارة الهوية وإمكانية الوصول" في Chat الإذن بالنشر على موضوع النشر/الاشتراك:

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

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

قاعدة بيانات Firestore للاحتفاظ بها واستردادها البيانات من مساحات Chat، مثل الرسائل أنت لا تحدد البيانات الذي يتم تعيينه ضمنيًا في نموذج الرمز بواسطة model/message.js services/firestore-service.js ملفًا.

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

يقدّم المخطّط التالي نظرة عامة على مساعد المعرفة المستنِد إلى الذكاء الاصطناعي نموذج بيانات تطبيق 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 لمساعد المعرفة المستند إلى الذكاء الاصطناعي إلى مساحة Chat

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

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

وحدة التحكّم في Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

أصبحت الآن جاهزًا لإنشاء مشروعك على Google Cloud وإعداده. ونشر تطبيق Chat في هذا القسم، يمكنك إجراء التالي:

  1. إنشاء دالتَين في السحابة الإلكترونية ونشرها مفتاح واحد للردّ على Chat أحداث التفاعل والآخر للرد على أحداث النشر/الاشتراك.
  2. إنشاء تطبيق في Chat ونشره على Google Chat API صفحة التكوين.

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

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

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

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

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

عرض على GitHub

إنشاء ونشر app

وحدة التحكّم في Google Cloud

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

    يجب أن يحتوي الدليل الجذري للملف المضغوط على ما يلي: الملفات والمجلدات:

    • .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، انتقِل إلى قائمة الطعام > وظائف السحابة الإلكترونية.

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

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

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

  8. في صفحة إنشاء دالة، عليك إعداد الدالة:

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

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

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

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

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

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

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

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

    1. انقر على تصفّح.
    2. انتقل إلى الملف المضغوط وحدده.
    3. انقر على فتح.

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

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

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

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

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

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

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

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

  2. يُرجى التبديل إلى الدليل الذي يحتوي على رمز هذه المعرفة المستنِدة إلى الذكاء الاصطناعي. تطبيق مساعد Google 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 على مشروعك على Google Cloud رقم التعريف
    2. اضبط قيمة location على قيمة المنطقة، مثل 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

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

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

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

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

  3. في صفحة إنشاء دالة، عليك إعداد الدالة:

    1. في البيئة، اختَر الجيل الثاني.
    2. في اسم الدالة، اكتب eventsApp.
    3. في المنطقة، اختَر منطقة، مثل us-central1. هذه المنطقة مع المنطقة التي تحدّدها في معرّف الموارد المنتظم (URI) المعتمَد لإعادة التوجيه عند CANNOT TRANSLATE تم إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والترخيص.
    4. في نوع المشغِّل، اختَر Cloud Pub/Sub.
    5. في موضوع Cloud Pub/Sub، اختَر اسم الموضوع الذي تريده. تم إنشاؤه، والتي تحتوي على التنسيق مكان projects/PROJECT/topics/events-api PROJECT هو رقم تعريف مشروعك على Google 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.

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

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

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

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

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

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

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

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

  1. في gcloud CLI، إذا لم تكن موجودًا فيه، يُرجى الانتقال إلى الدليل يحمل رمز هذه المعرفة بالذكاء الاصطناعي لتطبيق Google 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 على قيمة المنطقة، مثل 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

وحدة التحكّم في Google Cloud

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

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

  2. في العمود Name (الاسم) ضمن قائمة Cloud Functions، انقر على app

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

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

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

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

    gcloud functions describe app

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

ضبط تطبيق Chat في وحدة تحكّم Google Cloud

يوضّح هذا القسم كيفية ضبط Chat API في وحدة تحكُّم Google Cloud التي تتضمن معلومات عن تطبيق Chat بما في ذلك اسم تطبيق Chat وعنوان URL لمشغِّل شبكة Cloud في تطبيق 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 للتطبيق.

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

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

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

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

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

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

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

    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 في كل مرة تطبيق Chat يجيب عن سؤال علاوة على ذلك، فإن الاتصال list messages بشكل متكرر يمكن أن يتسبب في وصول تطبيق Chat إلى الحدّ الأقصى لحصة واجهة برمجة التطبيقات

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

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

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

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

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

تَنظيم

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

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

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

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