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

    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 Chat يردّ على المستخدمين من خلال تقديم نفسها.

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

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

لاختبار تطبيق Dialogflow CX Chat في يُرجى إجراء المحادثة التالية في وحدة تحكّم 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. تحتوي صفحة Rental Duration على قيمة نموذج أخرى ناقصة، لذا، فإنه يطالب المستخدم بالمعلمة 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.
موظّف الدعم: تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم. وتتّسع هذه الميزة لأربعة أشخاص وتضم راديو AM/FM. هل تريد المتابعة للدفع؟
المستخدم النهائي: نعم، من فضلك.
  1. الغرض من $session.params.vehicle_type="Cymbal الشاحن" مطابقة المسار وملء مَعلمة vehicle_model.
  2. ستنتقل الجلسة إلى صفحة تأكيد شاحنة Cymbal.
  3. تحتوي صفحة تأكيد شاحنة Cymbal على توفّر طلب الانضمام. ("تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم...")، والذي تتم إضافته إلى قائمة انتظار الردود.
  4. يرسل الوكيل قائمة انتظار الردود إلى المستخدم النهائي.
  5. يتطابق ردّ المستخدم مع small_talk.confirmation.yes المسار الصحيح.
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟
المستخدم النهائي: Altostrat
موظّف الدعم: يُرجى إدخال رقم البطاقة.
المستخدم النهائي: 1234 1234 1234 1234
موظّف الدعم: ما هو الاسم الظاهر على البطاقة؟
المستخدم النهائي: تشارلي
موظّف الدعم: ما هو عنوان شارع إرسال الفواتير؟
المستخدم النهائي: 1800 شارع برمائي ماونتن فيو، كاليفورنيا
موظّف الدعم: ما هو الرمز البريدي للفوترة؟
المستخدم النهائي: 94045
موظّف الدعم: ستختار سيارة Cymbal. في لاس فيغاس، 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 الرد باستخدام text أو رسائل البطاقات. للرد باستخدام بطاقة على أنها رسالة، فقم بتحديدها حمولة مخصّصة بوصة توصيل الطلبات:

يعرض ملف 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. إذا كانت الرسالة تتضمن أمر slash، وهي قيمة فسيتم استخدام الحقل text بدلاً من ذلك.
    • بالنسبة إلى أحداث CARD_CLICKED، تم إرسال إدخال طلب البحث إلى وكيل Dialogflow يتم تنسيقها على الشكل CARD_CLICKED.functionName، حيث functionName مع قيمة الحقل function عنصر الإجراء مرفقة بعنصر البطاقة التفاعلية (مثل زر).
    • حمولة JSON الكاملة لكل حدث تفاعل في Chat يتم إرساله إلى Dialogflow كحمولة مخصّصة في معلَمة طلب البحث، يمكن الوصول إليه من خلال الردّ التلقائي على الويب من Dialogflow عن طريق الاستعلام عن قيمة الحقل 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 والدردشة في مشاريع مختلفة على Google Cloud، وبالتالي إعداد خادم وسيط لتسهيل الاتصال. للتعرّف على كيفية إجراء ذلك، عرض هذا مثال على دمج الدردشة مع Dialogflow CX على GitHub.

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

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

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

تَنظيم

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

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

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

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