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

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

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

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

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

• حجز رحلات جوية
• تحديد مواعيد الأطباء
• طلب توصيل الطعام
• الإجابة عن أسئلة حول كتالوج منتجات البيع بالتجزئة، مثل ما إذا كانت العناصر متوفرة بألوان أخرى

• 

  الشكل 1. اختيار وكيل مُنشأ مسبقًا لتطبيق Dialogflow Chat.

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

الأهداف

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

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

• حساب على Google Workspace يمكنه الوصول إلى Google Chat
• مشروع على Google Cloud:
• تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.

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

يوضّح المخطّط التالي بنية تطبيق 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، فعِّل 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. اختَر مشروعًا على 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 من النتائج. وسيتم فتح رسالة مباشرة.

   ملاحظة: إذا لم يظهر لك تطبيق Chat في قائمة النتائج، تأكَّد من تضمين حسابك على Google Workspace في إعدادات إذن الوصول في صفحة إعداد Chat API في Google Cloud Console.

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

   يستجيب تطبيق Dialogflow Chat بتقديم نفسه.

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

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

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

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

إرسال رسائل بطاقة من 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
  • يتوافق إدخال طلب البحث المُرسَل إلى وكيل Dialogflow مع قيمة حقل argumentText في رسالة Chat. إذا كانت الرسالة تتضمن أمرًا بشرطة مائلة، سيتم استخدام قيمة الحقل text بدلاً من ذلك.
  • ويتم إرسال حمولة JSON الكاملة لكل حدث تفاعل في Chat إلى Dialogflow كحمولة بيانات مخصَّصة في مَعلمة طلب البحث، ويمكن الوصول إليها باستخدام Dialogflow للردّ التلقائي على الويب من خلال طلب البحث عن قيمة الحقل WebhookRequest.payload.
• يُسمح باستخدام الأوامر التي تبدأ بشرطة مائلة بشكل محدود:
  • إن أوامر Slash التي تفتح مربعات الحوار لا تتوافق مع تطبيقات Dialogflow Chat.
  • عندما تتلقّى تطبيقات Chat من Dialogflow رسالة تتضمّن طلبًا بشرطة مائلة، لا يتضمّن إدخال طلب البحث سوى قيمة الحقل text. يبدأ الحقل text باسم الأمر الذي يستخدم الشرطة المائلة (على سبيل المثال، /command)، والذي يمكنك استخدامه لضبط الغرض من وكيل Dialogflow لرصد الأمر الذي يبدأ بشرطة مائلة.
  • إذا كان وكيل Dialogflow يحتاج إلى معالجة حمولة JSON لحدث التفاعل مع الأمر slash، يمكنه إجراء ذلك باستخدام ردّ تلقائي على Dialogflow لفحص الحمولة المخصّصة في مَعلمة طلب البحث.
• معاينات الروابط غير متاحة.
• في حال استجابة وكيل Dialogflow برسالة واحدة فقط، سيتم إرسال الرسالة إلى Google Chat بشكل متزامن. في حال كان وكيل Dialogflow يستجيب برسائل متعددة، سيتم إرسال جميع الرسائل إلى Chat بشكل غير متزامن من خلال طلب الإجراء create على مورد spaces.messages في Chat API مرة واحدة لكل رسالة.

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

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

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

تَنظيم

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

تحذير: يؤدي حذف المشروع إلى ما يلي:

• يتم حذف كل بيانات المشروع. إذا استخدمت مشروعًا حاليًا لهذا البرنامج التعليمي، سيتم حذف أي عمل آخر قمت به في المشروع عند حذفه.
• يتم فقدان أرقام تعريف المشاريع المخصّصة. عند إنشاء هذا المشروع، ربما تكون قد أنشأت رقم تعريف مشروع مخصّصًا تريد استخدامه في المستقبل. للحفاظ على عناوين URL التي تستخدم رقم تعريف المشروع، مثل عنوان URL على appspot.com، احذف الموارد المحدَّدة داخل المشروع بدلاً من حذف المشروع بالكامل.

إذا كنت تخطط لاستكشاف العديد من البرامج التعليمية للبدء السريع، فيمكن أن تساعدك إعادة استخدام المشروعات في تجنب تجاوز حدود حصة المشروع.

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

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

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

مواضيع ذات صلة

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