إنشاء تطبيق Dialogflow CX في Google Chat يفهم اللغة الطبيعية ويستجيب لها

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

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

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

  • حجز رحلات جوية
  • تحديد مواعيد مع الأطباء
  • طلب توصيل الطعام
  • الإجابة عن أسئلة حول كتالوج منتجات البيع بالتجزئة، مثل ما إذا كانت السلع متوفرة بألوان أخرى
  • صفحة اختيار موظّف دعم Dialogflow المُنشئ مسبقًا
    الشكل 1. اختيار وكيل مُنشئ مسبقًا لتطبيق Chat في Dialogflow
  • اختبار الوكيل في Dialogflow CX
    الشكل 2. اختبار موظّف الدعم في Dialogflow CX للتأكّد من أنّ منطق موظّف الدعم وإعداداته يعملان على النحو المطلوب يعرض الرسم البياني مجموعة متسلسلة من الصفحات المواضيعية التي تتناول خطوات معيّنة في المحادثة، مثل تحديد موقع استلام سيارة مستأجَرة وإعادتها، وضبط المنطق الذي يربط بينها. يتم اختبار المحادثة في محاكي.
  • ضبط تطبيق Dialogflow Chat
    الشكل 3. ضبط تطبيق Chat لمعالجة الردود باستخدام موظّف دعم عملاء Dialogflow في صفحة إعدادات Chat API في Google Cloud Console
  • اختبار تطبيق Dialogflow CX Chat
    الشكل 4 إجراء محادثة حول حجز سيارة مستأجَرة باستخدام تطبيق Dialogflow Chat في Google Chat

الأهداف

  • إعداد البيئة
  • أنشئ وكيل Dialogflow CX ونشره.
  • يمكنك إنشاء ونشر تطبيق في Chat مستند إلى وكيل Dialogflow CX.
  • اختبِر تطبيق Chat.

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

البنية

يوضّح الرسم البياني التالي بنية تطبيق Chat الذي تم إنشاؤه باستخدام Dialogflow:

بنية تطبيق Chat تم تنفيذها باستخدام Dialogflow

في المخطّط البياني السابق، يتلقّى المستخدم الذي يتفاعل مع تطبيق Dialogflow Chat تدفق المعلومات التالي:

  1. يرسل مستخدم رسالة في Chat إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
  2. يتلقّى وكيل Dialogflow الافتراضي المتوفّر في Google Cloud الرسالة ويعالجها لتقديم ردّ.
  3. اختياريًا، باستخدام مخطّط عمل Dialogflow، يمكن لموظّف دعم Dialogflow التفاعل مع خدمات خارجية تابعة لجهات خارجية، مثل نظام إدارة المشاريع أو أداة إصدار التذاكر.
  4. يرسل موظّف دعم Dialogflow استجابةً إلى خدمة تطبيق Chat في Chat.
  5. يتم تسليم الرد إلى مساحة Chat.

إعداد البيئة

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

  1. في Google Cloud Console، فعِّل واجهة برمجة التطبيقات Google Chat وواجهة برمجة تطبيقات Dialogflow.

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

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

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

إنشاء وكيل Dialogflow CX

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

يشبه موظّف الدعم في Dialogflow موظّف الدعم البشري في مركز الاتصال. أنت تدربهما معًا للتعامل مع سيناريوهات المحادثة المتوقعة، ولا يحتاج تدريبك إلى أن يكون صريحًا للغاية.

في ما يلي كيفية إنشاء وكيل Dialogflow CX:

  1. في وحدة تحكّم Dialogflow CX، افتح وحدة التحكّم Dialogflow CX. انقر على القائمة > Dialogflow CX.

    الانتقال إلى وحدة تحكّم تجربة المستخدم في Dialogflow

  2. اختَر مشروعًا على Google Cloud. للعثور على مشروعك، قد تحتاج إلى النقر على الكل ثم البحث عنه.

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

    لاختيار وكيل مُعدّ مسبقًا، اتّبِع الخطوات التالية:

    1. انقر على استخدام برامج وكيلة مُعَدة مسبقًا.

    2. اختَر وكيلاً تم إنشاؤه مسبقًا. في هذا الدليل، اختَر السفر: استئجار السيارات.

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

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

    لإنشاء وكيل خاص بك، اتّبِع الخطوات التالية:

    1. انقر على إنشاء وكيل.
    2. اختَر إنشاء تلقائي لإنشاء وكيل تخزين بيانات أو اختَر إنشاء وكيلك الخاص لإنشاء أنواع أخرى من الوكلاء.

    للحصول على دليل تفصيلي حول عملية إنشاء موظّف الدعم، يُرجى الاطّلاع على مقالة إنشاء موظّف دعم عملاء على Dialogflow.

  4. ضبط الإعدادات الأساسية للموظف:

    1. في الاسم المعروض، أدخِل اسمًا معروضًا.
    2. اختَر موقعك الجغرافي المفضّل. إذا كنت تريد تغيير إعدادات الموقع الجغرافي المتقدّمة، انقر على تعديل.
    3. اختَر المنطقة الزمنية المفضّلة لديك.
    4. اختَر اللغة التلقائية لموظّف الدعم. لا يمكنك تغيير اللغة التلقائية لأحد موظّفي الدعم بعد إنشائه.

  5. انقر على إنشاء. تبدأ منصة Dialogflow CX بإنشاء الوكيل، ثم تعرض مسار البدء التلقائي للوكيل.

  6. يمكنك اختياريًا تخصيص الوكيل. للحصول على إرشادات تفصيلية حول عملية تخصيص الوكيل، يُرجى الاطّلاع على إنشاء وكيل Dialogflow CX.

  7. من أفضل الممارسات اختبار الوكيل:

    1. انقر على وكيل الاختبار.
    2. اختَر اختبار موظّف الدّعم في البيئة.
    3. في "البيئة"، اختَر مسودّة.
    4. في مسار الإحالة الناجحة، اختَر مسار الإحالة الناجحة التلقائي للبدء.
    5. في "الصفحة"، اختَر الصفحة الرئيسية.
    6. في شريط كتابة الرسائل التحدّث إلى موظّف دعم، اكتب Hello واضغط على Enter. يردّ موظّف الدعم من خلال تقديم نفسه.
    7. أكمِل الاختبار من خلال إجراء نموذج المحادثة الاختبارية.

  8. يتم إنشاء وكيل Dialogflow CX. ارجع إلى وحدة تحكّم Dialogflow CX. انقر على القائمة > Dialogflow CX.

    الانتقال إلى وحدة تحكّم تجربة المستخدم في Dialogflow

  9. ضمن الموظّفون، انقر على > نسخ الاسم. احفِظ هذا الاسم، لأنّك ستستخدمه عند ضبط إعدادات تطبيق Chat.

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

بعد إنشاء وكيل Dialogflow CX، يمكنك اتّباع الخطوات التالية لتحويله إلى تطبيق Chat:

  1. في Google Cloud Console، انتقِل إلى Google Chat API. ابحث عن "Google Chat API" وانقر على Google Chat API، ثم انقر على إدارة.

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

  2. انقر على الإعدادات واضبط تطبيق Chat:

    1. في حقل اسم التطبيق، أدخِل Dialogflow App.
    2. في عنوان URL للصورة الرمزية، أدخِل https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    3. في الوصف، أدخِل Responds to real human conversation.
    4. ضمن الوظيفة، اختَر تلقّي رسائل بين شخصَين و الانضمام إلى المساحات والمحادثات الجماعية.
    5. ضمن إعدادات الاتصال، اختَر Dialogflow.
    6. ضمن إعدادات Dialogflow، اختَر Dialogflow CX.
    7. في اسم مورد موظّف الدعم أو البيئة، الصِق اسم موظّف الدعم في Dialogflow CX الذي نسخته في نهاية مقالة إنشاء موظّف دعم في Dialogflow CX.
    8. أوفِّر تطبيق Chat هذا لأشخاص ومجموعات معيّنة في نطاقك وأدخِل عنوان بريدك الإلكتروني.
    9. ضمن السجلّات، اختَر تسجيل الأخطاء في السجلّ.

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

تطبيق Chat جاهز لتلقّي الرسائل والردّ عليها في Chat.

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

اختبِر تطبيق Dialogflow CX Chat من خلال مراسلته في Google Chat.

  1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق.

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

  2. انقر على رمز محادثة جديدة.
  3. في الحقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

  4. اختَر تطبيقك في Chat من النتائج. ستظهر رسالة مباشرة.

  5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter.

    يقدّم تطبيق Dialogflow تطبيق الإجابة عن نفسه.

  6. أكمِل الاختبار من خلال إجراء نموذج المحادثة الاختبارية.

نموذج لمحادثة تجريبية

لاختبار تطبيق Dialogflow CX Chat في وحدة تحكّم Dialogflow CX أو في Google Chat، يُرجى إجراء المحادثة التالية. يساعدك التفسير في فهم كيفية تفسير موظّف دعم العملاء في Dialogflow لعبارة العميل باللغة الطبيعية وتقديم ردّ باللغة الطبيعية في كل خطوة من خطوات المحادثة. يستند نموذج المحادثة هذا إلى وكيل مُعدّ مسبقًا يُسمّى السفر: تأجير السيارات.

مربّع حوار الشرح
المستخدِم النهائي: مرحبًا
موظّف الدعم: مرحبًا. أنا موظّف الدعم الافتراضي لتأجير السيارات. يمكنني مساعدتك في بدء حجز جديد لاستئجار السيارة. كيف يمكنني مساعدتك اليوم؟
  1. يتمّ استدعاء مسار Intent الترحيب التلقائي في مسار البدء التلقائي.
  2. الإجراء الذي يتّخذه معالِج الحالة هذا ("مرحبًا، أنا...") تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  3. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدِم النهائي: أريد استئجار سيارة.
موظّف الدعم: أين تريد استلام المركبة؟
  1. تمّت مطابقة مسار الهدف car_rental.reservation_create في الصفحة الرئيسية.
  2. ستنتقل الجلسة إلى صفحة موقع الاستلام.
  3. لم يتم إكمال نموذج صفحة الموقع الجغرافي لاستلام الطلب، لذا يستخدم العميل المَعلمة pickup_location لطلب معلومات من المستخدم ("أين تريد استلام الطلب؟"). تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  4. يرسل الوكيل قائمة انتظار الردود إلى المستخدم النهائي.
المستخدِم النهائي: لاس فيغاس
موظّف الدّعم: حسنًا، سيتم استلام الطلب في لاس فيغاس.
موظّف الدعم: هل موقع الإرجاع مختلف عن موقع الاستلام؟
  1. تملأ إدخالات المستخدم النهائي مَعلمة pickup_location التي طلبها موظّف الدّعم في الخطوة السابقة من المحادثة.
  2. تتم مطابقة مسار car_rental.return_different_location في مسار البدء التلقائي.
  3. يتم تقييم مسار إكمال النموذج في صفحة الموقع الجغرافي لمكان الاستلام والاتّصال به. يحتوي على استجابة ("حسنًا، سيتم استلام طلبك...")، والتي تتم إضافتها إلى قائمة الانتظار للردّ مع تحويل مراجع المَعلمات إلى القيم الفعلية التي يقدّمها المستخدم النهائي.
  4. تنتقل الجلسة إلى صفحة تأكيد الموقع.
  5. تحتوي صفحة تأكيد الموقع الجغرافي على طريقة توفّر للحجز ("هل موقع التسليم الخاص بك مختلف...")، تتم إضافته إلى قائمة الانتظار للردّ.
  6. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدم النهائي: نعم. سأسلّم السيارة في لوس أنجلوس.
موظّف الدعم: حسنًا، سيتم تسليم الطلب في القاهرة.
موظّف الدعم: ما هو التاريخ والوقت اللذان تريد استلام المركبة فيهما؟
  1. تتم مطابقة مسار car_rental.return_different_location في مسار البدء التلقائي.
  2. تنتقل الجلسة إلى صفحة موقع التسليم.
  3. يملأ المستخدم النهائي المَعلمة drop_off_location التي طلبها الوكيل خلال المحادثة السابقة.
  4. يتم تقييم مسار إكمال النموذج في صفحة موقع التسليم واستدعاؤه. وتتضمّن رسالة تأكيد ("حسنًا، سيتم تسليم الطلب...")، والتي تتم إضافتها إلى قائمة الانتظار الخاصة بالردّ.
  5. تنتقل الجلسة إلى صفحة مدة الاستئجار.
  6. تحتوي صفحة مدة الاستئجار على قيم غير مكتملة في النموذج، لذا يطلب من المستخدم إدخال المَعلمة pickup_date_time ("ما هو التاريخ والوقت المطلوبان لاستلام السيارة؟"). والذي تتم إضافته إلى قائمة انتظار الردود.
  7. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدِم النهائي: أريد استلام السيارة في 5 آذار (مارس) عند الظهر.
موظّف الدعم: ما هو التاريخ والوقت المناسبان لتسليم المركبة؟
  1. تملأ إدخالات المستخدم النهائي المَعلمة pickup_date_time التي طلبها موظّف الدّعم في الردّ السابق على المحادثة.
  2. تحتوي صفحة مدة الاستئجار على قيمة نموذج أخرى غير متوفّرة، لذلك تطلب من المستخدم إدخال مَعلمة drop_off_date_time ("ما هو التاريخ والوقت المطلوبان لإرجاع السيارة؟"). تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  3. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدم النهائي: 15 آذار (مارس) ظهرًا.
موظّف الدعم: للتأكّد:

ستستلم المركبة في لاس فيغاس 05‏/03‏/2024 12:00:00 وستعيد تسليمها في لوس أنجلوس 15‏/03‏/2024 12:00:00

هل هذا صحيح؟
  1. يملأ المستخدم النهائي المَعلمة drop_off_date_time التي طلبها الوكيل خلال المحادثة السابقة.
  2. تنتقل الجلسة إلى صفحة تأكيد مدة الاستئجار.
  3. تحتوي صفحة تأكيد مدة الاستئجار على نموذج لإكمال الإدخال ("لتأكيد..."). تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  4. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدم النهائي: نعم، شكرًا.
موظّف الدعم: رائع. لنختار الآن مركبة.
موظّف الدعم: هل تريد مركبة من الفئة الاقتصادية أم الفارهة؟
  1. تتم مطابقة مسار النية small_talk.confirmation.yes في صفحة تأكيد مدة الاستئجار.
  2. يؤكّد موظّف الدّعم اختيار المستخدم من خلال رسالة ("رائع. لنختار الآن...")، تتم إضافته إلى قائمة الانتظار للردّ.
  3. ستنتقل الجلسة إلى صفحة توضيح المركبة.
  4. لم يكتمل نموذج صفحة إزالة الغموض عن المركبة، لذا يستخدم العميل المَعلمة vehicle_type لطلب معلومات من المستخدِم ("هل تريد سيارة من الفئة الاقتصادية أم الفاخرة؟"). والذي تتم إضافته إلى قائمة انتظار الردود.
  5. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدم النهائي: إذا كان سعره اقتصاديًا،
موظّف الدعم: هل تريد الحصول على سيارة Cymbal أم شاحنة Cymbal؟
  1. يتطابق مسار الرحلة$session.params.vehicle_type="economy_vehicle"
  2. تنتقل الجلسة إلى صفحة الخيارات الاقتصادية.
  3. تحتوي صفحة خيارات التكلفة الاقتصادية على إدخال مرتبط ("هل تريد...") تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  4. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
المستخدم النهائي: Cymbal Truck
موظّف الدعم: تكلفة شاحنة Cymbal هي 50.33 دولار أمريكي في اليوم. تتسع الغرفة لـ 4 أشخاص وتتضمّن راديو AM/FM. هل تريد المتابعة للدفع؟
المستخدم النهائي: نعم، يُرجى.
  1. تمّت مطابقة المسار المقصود $session.params.vehicle_type="Cymbal Track" مع ملء المَعلمة vehicle_model.
  2. تنتقل الجلسة إلى صفحة تأكيد شاحنة الصنج.
  3. تحتوي صفحة تأكيد شاحنة Cymbal على متطلبات الدخول ("تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم...")، تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  4. يرسل موظّف الدّعم قائمة الانتظار للردّ إلى المستخدم النهائي.
  5. يتطابق ردّ المستخدم مع المسار small_talk.confirmation.yes.
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟
المستخدم النهائي: Altostrat
موظّف الدعم: يُرجى إدخال رقم البطاقة.
المستخدم النهائي: 1234 1234 1234 1234
موظّف الدعم: ما هو الاسم الوارد في البطاقة؟
المستخدِم النهائي: شارلي
موظّف الدعم: ما هو عنوان الشارع الخاص بحساب الفوترة؟
المستخدِم النهائي: 1800 Amphibious Blvd. Mountain View, CA
موظّف الدعم: ما هو الرمز البريدي لعنوان إرسال الفواتير؟
المستخدم النهائي: 94045
موظّف الدعم: سيكون عليك استلام سيارة Cymbal في لاس فيغاس بتاريخ 05-03-2024 في الساعة 12:00:00 والتسليم، من الساعة 12:00 إلى الساعة 15-03-2024. سيبلغ إجمالي تكلفة هذه الرحلة 175.38 دولار أمريكي.
موظّف الدعم: نشكرك على استئجار السيارة معنا ونتمنى لك يومًا سعيدًا.
  1. تنتقل الجلسة إلى صفحة الدفع.
  2. نموذج الدفع غير مكتمل، لذا يطلب موظّف الدعم من المستخدم إدخال مَعلمات card_type وcard_number وbilling_name وbilling_street_address وbilling_zip_code ("ما هو نوع البطاقة التي سيتم..."). والتي تتم إضافتها بشكل تسلسلي إلى قائمة الانتظار للردّ ويتم إرسالها أثناء ردّ مستخدم. تحدّد ردود المستخدمين قيمة كل مَعلمة.
  3. تنتقل الجلسة إلى صفحة تأكيد الاستئجار.
  4. تحتوي صفحة تأكيد الاستئجار على نموذج لإكمال الإدخال ("حسنًا، سيتم استلام السيارة في..."). تتم إضافته إلى قائمة الانتظار الخاصة بالردّ.
  5. يرسل الوكيل قائمة انتظار الردود إلى المستخدم النهائي.
  6. تنتقل الجلسة إلى صفحة إنهاء الجلسة.

إرسال رسائل البطاقات من Dialogflow

يمكن أن يرد Dialogflow باستخدام الرسائل النصية أو البطاقات. للردّ باستخدام رسالة بطاقة، حدِّدها على أنّها بيانات أساسية مخصّصة في الاستجابة.

يوضّح ملف JSON التالي كيفية إرسال رسالة بطاقة كحمولة مخصّصة في مرحلة الاستيفاء:

json

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from Dialogflow',
        'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
        'imageType': 'CIRCLE'
      },
      'sections': [
        {
          'widgets': [
            {
              'buttonList': {
                'buttons': [
                  {
                    'text': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

الحدود والاعتبارات

  • أحداث التفاعل في المحادثة: تتوفّر هذه الأحداث بشكل محدود، ويجب مراعاة بعض النقاط التالية:
    • تتوفّر أنواع أحداث التفاعل التالية:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • بالنسبة إلى أحداث MESSAGE أو ADDED_TO_SPACE، تتوافق إدخالات طلبات البحث المُرسَلة إلى موظّف دعم Dialogflow مع قيمة حقل argumentText في رسالة Chat. إذا تضمّنت الرسالة أمرًا بشرطة مائلة، يتم استخدام قيمة الحقل text بدلاً من ذلك.
    • بالنسبة إلى أحداث CARD_CLICKED، يتم تنسيق إدخال الطلب الذي يتم إرساله إلى موظّف دعم Dialogflow على النحو التالي: CARD_CLICKED.functionName، حيث يتوافق functionName مع قيمة حقل function لعنصر الإجراء المرفق بعنصر البطاقة التفاعلي (مثل زر).
    • يتم إرسال الحمولة الكاملة بتنسيق JSON لكل حدث تفاعل في Chat إلى Dialogflow كحمولة مخصّصة في مَعلمة الطلب، ويمكن الوصول إليها باستخدام مخطّط عمل ويب في Dialogflow من خلال طلب قيمة حقل WebhookRequest.payload.
  • نقاط يجب مراعاتها عند الردّ على أوامر الشرطة المائلة و تلقّي البيانات من البطاقات أو مربّعات الحوار:
    • عندما تتلقّى تطبيقات Dialogflow Chat رسالة تتضمّن الأمر slash ، لا يحتوي إدخال طلب البحث إلا على قيمة الحقل text. يبدأ الحقل text باسم الأمر الذي يبدأ بشرطة مائلة (على سبيل المثال، /command)، والذي يمكنك استخدامه لضبط نية موظّف دعم Dialogflow لرصد أمر يبدأ بشرطة مائلة.
    • إذا كان موظّف الدعم في Dialogflow بحاجة إلى معالجة حمولة JSON لحدث التفاعل في Chat، يمكنه إجراء ذلك باستخدام الردّ التلقائي على الويب Dialogflow لفحص الحمولة المخصّصة في معلَمة طلب البحث.
    • لعرض محادثة من موظّف Dialogflow، يجب الردّ باستخدام بيانات أساسية مخصّصة واحدة بتنسيق JSON تشمل رسالة تحتوي على DIALOG استجابة إجراء.
    • لمعالجة البيانات التي يتم إدخالها من البطاقات، يمكن لوكيل Dialogflow رصد النوايا التي تبدأ بالنص CARD_CLICKED والردّ باستخدام ملف حمولة JSON مخصّص واحد يحتوي على الإجراء المناسب.
  • لا تتوفّر معاينات الروابط.
  • إذا ردّ موظّف دعم Dialogflow برسالة واحدة فقط، يتم إرسال الرسالة إلى Google Chat بشكل متزامن. إذا استجاب وكيل Dialogflow برسائل متعددة، سيتم إرسال جميع الرسائل إلى Chat بشكل غير متزامن من خلال استدعاء الطريقة create في مورد spaces.messages في Chat API مرة واحدة لكل رسالة.
  • عند استخدام عملية دمج Dialogflow CX مع Chat، يجب إعداد وكيل Dialogflow وتطبيق Chat في مشروع Google Cloud نفسه. إذا كنت بحاجة إلى إعداد Dialogflow وChat في مشاريع مختلفة على Cloud، يمكنك إعداد خادم وسيط لتسهيل عملية الربط. للتعرّف على كيفية إجراء ذلك، اطّلِع على مثال على دمج Chat مع Dialogflow CX على GitHub.

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

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

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

تَنظيم

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

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

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

  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.
  • تعتمد CX في Dialogflow أسلوبًا مستندًا إلى آلة حالات لتصميم موظّفي دعم Dialogflow، ما يمنحك التحكّم الواضح والصريح في المحادثة، وتجربة أفضل للمستخدم النهائي، ودورة عمل تطوير أفضل. عند إنشاء تطبيق Dialogflow Chat، ننصحك باستخدام Dialogflow CX.
    • للاطّلاع على مزيد من المعلومات عن إنشاء موظّفي الدعم وضبطهم، اطّلِع على مقالة موظّفو دعم عملاء Dialogflow.
    • للحصول على جولة تفصيلية تشرح كيفية إنشاء الوكلاء وضبطهم، يمكنك الاطّلاع على إنشاء وكيل Dialogflow CX.
    • درس تطبيقي حول الترميز: للاطّلاع على مثال حول كيفية إنشاء وكيل تخزين بيانات Dialogflow CX، يمكنك الانتقال إلى تطبيق Chat للمعلومات من خلال الدرس التطبيقي حول الترميز إنشاء تطبيقات لـ Google Chat باستخدام Gemini.
    • الدرس التطبيقي: للحصول على مثال على كيفية إنشاء وكيل محادثات CX في Dialogflow، يمكنك الاطّلاع على تطبيق Chat المخصّص لتلقّي الملاحظات من الدرس التطبيقي إنشاء تطبيقات لخدمة Google Chat باستخدام Gemini.
  • Dialogflow ES هي طريقة أخرى لاستخدام Dialogflow مع تطبيق Chat.