إنشاء تطبيق 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 CX ونشره.
• إنشاء تطبيق Chat ونشره باستخدام وكيل CX في Dialogflow
• اختبِر تطبيق Chat.

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

• حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى 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".

إعداد البيئة

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

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

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

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

إنشاء موظّف دعم في Dialogflow CX

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

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

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

1. في وحدة تحكّم Dialogflow CX، افتح وحدة تحكّم Dialogflow CX. انقر على القائمة menu > 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.

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

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

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

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

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

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

بعد إنشاء موظّف دعم عملاء في Dialogflow، اتّبِع الخطوات التالية لتحويله إلى تطبيق 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. انقر على add محادثة جديدة.
3. في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

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

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

   يردّ تطبيق Dialogflow Chat من خلال تقديم نفسه.

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

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

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

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

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

يوضّح ملف 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 لحدث التفاعل في المحادثة، يمكنه إجراء ذلك باستخدام مخطّط عمل Dialogflow لفحص الحمولة المخصّصة في مَعلمة الطلب.
  • لعرض محادثة من موظّف Dialogflow، يجب الردّ باستخدام بيانات أساسية مخصّصة واحدة بتنسيق JSON تشمل رسالة تحتوي على DIALOG استجابة إجراء.
  • لمعالجة البيانات التي يتم إدخالها من البطاقات، يمكن لوكيل Dialogflow رصد النوايا التي تبدأ بالنص CARD_CLICKED والردّ باستخدام ملف حمولة JSON مخصّص واحد يحتوي على الإجراء المناسب.
• لا تتوفّر ميزة معاينات الروابط.
• إذا ردّ موظّف دعم Dialogflow برسالة واحدة فقط، يتم إرسال الرسالة إلى Google Chat بشكل متزامن. إذا ردّ موظّف دعم Dialogflow برسائل متعدّدة، يتم إرسال جميع الرسائل إلى Chat بشكل غير متزامن من خلال استدعاء الأسلوب create في مورد spaces.messages في Chat API مرة واحدة لكل رسالة.
• عند استخدام عملية دمج تجربة المستخدم في Dialogflow مع Chat، يجب إعداد وكيل Dialogflow وتطبيق Chat في مشروع Google Cloud نفسه. إذا كنت بحاجة إلى إعداد Dialogflow وChat في مشاريع مختلفة على Cloud، يمكنك إعداد خادم وسيط لتسهيل عملية الربط. للتعرّف على كيفية إجراء ذلك، اطّلِع على مثال على دمج Chat مع Dialogflow CX على GitHub.

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

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

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

تَنظيم

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

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

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

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

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

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