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

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

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

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

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

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

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

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

    الانتقال إلى وحدة التحكّم في Dialogflow CX

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

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

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

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

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

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

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

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

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

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

  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 CX

  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 CX للغة المستخدم الطبيعية وتقديم إجاباته باللغة الطبيعية في كل خطوة من المحادثة. يستند نموذج المحادثة هذا إلى وكيل مُعدّ مسبقًا يُسمّى السفر: تأجير السيارات.

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

سيتم استلام المركبة في لاس فيغاس 2024-03-05 الساعة 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.
موظّف الدعم: تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم. وتتّسع هذه الميزة لأربعة أشخاص وتضم راديو AM/FM. هل تريد المتابعة للدفع؟
المستخدم النهائي: نعم، يُرجى.
  1. تمّت مطابقة المسار المقصود $session.params.vehicle_type="Cymbal Track" مع ملء المَعلمة vehicle_model.
  2. ستنتقل الجلسة إلى صفحة تأكيد شاحنة Cymbal.
  3. تحتوي صفحة تأكيد شاحنة Cymbal على متطلبات الدخول ("تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم...")، والذي تتم إضافته إلى قائمة انتظار الردود.
  4. يرسل الوكيل قائمة انتظار الردود إلى المستخدم النهائي.
  5. يتطابق ردّ المستخدم مع مسار small_talk.confirmation.yes.
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟
المستخدم النهائي: Altostrat
موظّف الدعم: يُرجى إدخال رقم البطاقة.
المستخدم النهائي: 1234 1234 1234 1234
موظّف الدعم: ما هو الاسم الوارد في البطاقة؟
المستخدم النهائي: تشارلي
موظّف الدعم: ما هو عنوان شارع إرسال الفواتير؟
المستخدم النهائي: 1800 Amphibious Blvd. Mountain View, CA
Agent: ما هو الرمز البريدي للفوترة؟
المستخدم النهائي: 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 webhook عن طريق الاستعلام عن قيمة الحقل WebhookRequest.payload.
  • يجب مراعاة الاستجابة للأوامر التي تبدأ بشرطة مائلة وتلقّي البيانات من البطاقات أو مربّعات الحوار:
    • عندما تتلقّى تطبيقات Dialogflow Chat رسالة تحتوي على أمر شرطة مائلة، يحتوي إدخال طلب البحث فقط على قيمة الحقل 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، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

    الانتقال إلى Resource Manager

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