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

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

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

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

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

الأهداف

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

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

الهندسة المعمارية

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

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

في المخطّط البياني السابق، يتضمّن تفاعل المستخدم مع تطبيق محادثات من Dialogflow تدفّق المعلومات التالي:

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

إعداد البيئة

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

  1. في Google Cloud Console، فعِّل Google Chat API وDialogflow API.

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

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

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

إنشاء وكيل Dialogflow CX

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

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

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

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

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

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

  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. في Flow، اختَر مسار البدء التلقائي.
    5. في "الصفحة"، اختَر صفحة البدء.
    6. في خانة إدخال المحتوى التحدّث مع وكيل، اكتب Hello واضغط على مفتاح Enter. يردّ الوكيل بتقديم نفسه.
    7. أكمِل الاختبار من خلال إجراء محادثة الاختبار النموذجية.

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

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

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

إنشاء تطبيق محادثات وربطه بوكيل Dialogflow

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

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

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

  2. انقر على الإعداد وأعِدّ تطبيق محادثات على النحو التالي:

    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. إتاحة تطبيق محادثات لمستخدمين ومجموعات محدّدة في نطاقك وأدخِل عنوان بريدك الإلكتروني.
    9. ضمن السجلات، اختَر تسجيل الأخطاء في خدمة تسجيل البيانات.

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

تطبيق محادثات جاهز لتلقّي الرسائل والردّ عليها.

اختبار تطبيق محادثات

اختبِر تطبيق محادثات Dialogflow CX من خلال المراسلة في Google Chat.

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

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

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

  4. اختَر تطبيق محادثات من النتائج. سيتم فتح رسالة مباشرة.

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

    سيردّ تطبيق Dialogflow Chat بتعريف نفسه.

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

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

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

مربّع حوار الشرح
المستخدم النهائي: مرحبًا
الوكيل: مرحبًا. أنا وكيل تأجير السيارات الافتراضي. يمكنني مساعدتك في بدء حجز جديد لاستئجار سيارة. كيف يمكنني مساعدتك اليوم؟
  1. يتم استدعاء مسار نية الترحيب التلقائية في مسار بدء المحادثة التلقائي.
  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 مارس في منتصف النهار
الموظف: للتأكيد:

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

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

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

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

json

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": { "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"
        }}
      }]}}]}]
    }
  }]}
}}}}

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

  • عند استخدام إضافات Google Workspace مع Dialogflow، تنطبق القيود والاعتبارات التالية على عناصر أحداث المحادثة:
    • أحداث صفحة "التطبيق" الرئيسية: لا تتوفّر بعد إمكانية استخدام أحداث APP_HOME.
    • إدخال طلب البحث في Dialogflow: يعتمد النص الذي يتم إرساله كإدخال لطلب البحث إلى موظف دعم Dialogflow على نوع الحدث:
      • MESSAGE: قيمة الحقل argumentText من رسالة المحادثة.
      • APP_COMMAND: السلسلة "APP_COMMAND_PAYLOAD"
      • ADDED_TO_SPACE: السلسلة "ADDED_TO_SPACE_PAYLOAD"
      • REMOVED_FROM_SPACE: السلسلة "REMOVED_FROM_SPACE_PAYLOAD"
      • CARD_CLICKED: السلسلة "BUTTON_CLICKED_PAYLOAD"
      • WIDGET_UPDATED: السلسلة "WIDGET_UPDATED_PAYLOAD" (المستخدَمة في الإكمال التلقائي)
    • حِمل الحدث الكامل: يتم إرسال حِمل JSON الكامل لحدث التفاعل مع المحادثة إلى Dialogflow ضمن الحقل WebhookRequest.payload. يمكنك الوصول إلى هذه البيانات في رمز ربط Dialogflow. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات طلب Webhook في Dialogflow CX.
  • اعتبارات الاستجابة للأوامر وتلقّي البيانات من البطاقات أو مربّعات الحوار:
  • لا تتوفّر معاينات الروابط.
  • إذا ردّ وكيل Dialogflow برسالة واحدة فقط، يتم إرسال الرسالة إلى Google Chat بشكل متزامن. إذا ردّ وكيل Dialogflow بعدة رسائل، يتم إرسال جميع الرسائل إلى Chat بشكل غير متزامن من خلال استدعاء الطريقة create في المورد spaces.messages ضمن Chat API مرة واحدة لكل رسالة.
  • عند استخدام ميزة دمج Dialogflow CX مع Chat، يجب إعداد وكيل Dialogflow وتطبيق محادثات Chat في مشروع على السحابة الإلكترونية نفسه على Google Cloud. إذا كنت بحاجة إلى إعداد Dialogflow وChat في مشاريع مختلفة على Cloud، يمكنك إعداد خادم وسيط لتسهيل عملية الربط. لمعرفة كيفية إجراء ذلك، اطّلِع على مثال على دمج Chat مع Dialogflow CX على GitHub.

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

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

  • سجلّات إضافات Google Workspace: يمكنك البحث في السجلّات للحصول على معلومات تفصيلية حول سلوك الإضافة، بما في ذلك تفاعلاتها مع Chat. اطّلِع على سجلّات طلب البحث عن إضافات Google Workspace.

  • أخطاء تطبيق Google Chat: للاطّلاع على رسائل الخطأ العامة في تطبيق Google Chat وحلولها، يُرجى الرجوع إلى تحديد مشاكل تطبيق Google Chat وحلّها.

  • تسجيل الدخول إلى Dialogflow CX Cloud: تأكَّد من تفعيل Cloud Logging في إعدادات وكيل Dialogflow لتسجيل سجلّات التنفيذ التفصيلية، بما في ذلك الأخطاء من الوكيل وتفاعلات الويب هوك. تعرَّف على كيفية تفعيل هذه الميزة وإعدادها في مستندات إعدادات وكيل Dialogflow CX. يمكن الاطّلاع على هذه السجلّات في "مستكشف السجلّات" في Google Cloud Console.

  • سجلّ المحادثات في Dialogflow CX: راجِع التفاعلات السابقة لفهم سير المحادثة وتحديد مواضع حدوث المشاكل. اطّلِع على سجلّ المحادثات.

  • تحديد المشاكل العامة في Dialogflow وحلّها: لمعالجة المشاكل الأوسع نطاقًا في Dialogflow، يُرجى الرجوع إلى دليل تحديد المشاكل وحلّها في Dialogflow CX.

تَنظيم

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

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

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

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