معالجة اللغة الطبيعية لمنصة Messenger

تتيح لك ميزة معالجة اللغة الطبيعية (NLP) فهم المعلومات المهمة (التواريخ والوقت وغير ذلك الكثير) واستخلاصها من الرسائل التي تتلقاها شركتك. يمكنك استخدام هذه المعلومات لتحديد الغرض من تنفيذ تجربة المراسلة المطلوبة للمحادثة.

يقلل استخدام معالجة اللغة الطبيعية المضمّنة (NLP) لدى Meta استدعاءات واجهة API التي تعتمد على حدود معدلات المراسلة.

طريقة العمل

قبل أن تصل رسالة ما إلى شركتك، تحلِّل أولاً ميزة معالجة اللغة الطبيعية المضمّنة (NLP) لدى Meta الرسائل للمساعدة في اكتشاف المعنى واستخلاص المعلومات باستخدام Wit.ai من Meta بالإضافة إلى مستوى الثقة الذي يشير إلى احتمالية صحة تحليل المحلل. ستصل الرسالة بعد ذلك إلى شركتك كالعادة، بالإضافة إلى أي معلومات ذات معنى، مثل الكيانات والسمات، التي تم اكتشافها في الرسالة. على سبيل المثال، إذا كانت الرسالة تحتوي على عبارة مثل "مرحبًا، غدًا الساعة 2 مساءً"، فستحصل على سمة تتضمن التحية وكيانًا يتضمن الطابع الزمني الفعلي.

يتم تمكين تحديد اللغة تلقائيًا باستخدام معالجة اللغة الطبيعية المضمّنة (NLP)، وتتم ترجمة التاريخ والوقت تلقائيًا بناءً على اللغة المحلية الواردة في الملف الشخصي.

Wit.ai

Wit.ai هو التطبيق الذي يحلل الرسالة وينشئ الكيانات من رسالة الشخص. يمكنك استخدام Wit.ai الافتراضي للغات المدعومة، أو إنشاء تطبيق Wit.ai الخاص بك لكل لغة تريد دعمها. عندما تتلقى منصة Messenger رسالة، ستحدد أولاً أبرز لغة تم اكتشافها، وتستخدم تطبيق Wit.ai المرتبط لاستخراج الكيانات. وإذا لم يكن هناك تطبيق Wit.ai مرتبط بأبرز لغة تم اكتشافها، فسيتم استخدام نموذج اللغة الافتراضي.

اطلع على وثائق تطبيق Wit.ai لمزيد من المعلومات عن تطبيقات Wit.ai وإنشاء تطبيق Wit.ai المخصص الخاص بك واختبارهبالإضافة إلى قائمة تضم اللغات المدعومة.

إضافة معالجة اللغة الطبيعية (NLP) إلى صفحتك

هناك طريقتان لإضافة معالجة اللغة الطبيعة (NLP) إلى صفحة شركتك، باستخدام لوحة معلومات تطبيق Meta أو برمجيًا.

لوحة معلومات التطبيق

لإضافة معالجة اللغة الطبيعية المضمّنة (NLP) باستخدام لوحة معلومات التطبيق، ضمن المنتجات انتقل إلى Messenger > الإعدادات ومَرّر لأسفل إلى قسم معالجة اللغة الطبيعية (NLP) المضمّنة. حدِّد صفحة Facebook من القائمة المنسدلة وقم بالتبديل إلى تشغيل. ثم حدِّد نموذج اللغة الذي يتضمن خيارًا لإضافة عدة لغات. تسمح لك الإعدادات المتقدمة بتحديد إصدار معالجة اللغة الطبيعية (NLP)، والعلامة المفصلة للحصول على مزيد من المعلومات حول الكيانات، وأفضل القيم n لكل غرض وسمة تريد تلقيها. يحدد هذا الإعداد أيضًا عدد اللغات المحلية التي تم اكتشافها وإرجاعها.

سيتم تجميع نماذج عشوائية من محادثاتك السابقة الموجودة في البريد الوارد للصفحة، وسيتم عرضها في تطبيق Wit الذي تم إنشاؤه مؤخرًا. ستتوفر النماذج لتضمين الإشارات بها في تطبيق Wit.ai لديك على الفور.

برمجيًا

لإضافة معالجة اللغة الطبيعية (NLP) برمجيًا، فإنك ستحتاج إلى ما يلي:

  • رمز وصول الصفحة المطلوب من الشخص الذي يمكنه تنفيذ مهمة MESSAGING بالصفحة
  • مُعرّف الصفحة
  • الإذنان pages_messaging وpages_manage_metadata

أرسِل طلب POST إلى نقطة نهاية /PAGE-ID/nlp_configs مع تعيين معلمة nlp_enabled إلى true لتمكين معالجة اللغة الطبيعية (NLP) للصفحة. يُمكنك أيضًا تضمين معلمة model لتعيين لغة أخرى غير اللغة الإنجليزية الافتراضية.

اعرض صفحة مرجع معالجة اللغة الطبيعية (NLP) لمزيد من المعلومات.

عينة من الطلب

تم التنسيق لإمكانية القراءة.
curl -i -X POST "https://graph.facebook.com/v21.0/me/nlp_configs
      ?nlp_enabled=true
      &model=PORTUGUESE 
      &access_token=PAGE-ACCESS-TOKEN"

يمكنك استخدام معلمة custom_token لاستخدام تطبيق Wit.ai المخصص الخاص بك وتحديث معلمات معالجة اللغة الطبيعية (NLP) بطلبات POST. لتعطيل معالجة اللغة الطبيعية (NLP)، أرسل طلب POST مع تعيين معلمة nlp_enabled إلى false.

إشعار Webhook

يحتوي حدث webhook الرسالة الآن على حقلين لمعالجة اللغة الطبيعية (NLP) عند تمكين معالجة اللغة الطبيعية (NLP) المدمجة: nlp وnlpv2. حقل nlp هو حقل قديم يستخدم مصطلح تسمية تم إيقاف استخدامه لأسماء الكيان والسمة. يستخدم الحقل nlpv2 أسماء مبسطة للكيانات والسمات، كما هو موضح أدناه.

ستتم إزالة الحقل nlp في 18 يونيو 2024.

في حالة تمكين معالجة اللغة الطبيعية (NLP) المضمّنة، سيتم تضمين سمات معالجة اللغة الطبيعية (NLP) ذات الصلة وكياناتها في إشعار أحداث webhook لـ message لكل كائن في الرسالة.

الكيانات والسمات

تُرجِع منصة Messenger الكيانات التالية افتراضيًا.

المعلوماتالكيان

المبلغ المالي

amount_of_money

التاريخ/الوقت

datetime

المسافة

distance

المدة

duration

عنوان البريد الإلكتروني

email

الموقع

location

رقم الهاتف

phone_number

العدد

quantity

الحرارة

temperature

عنوان URL

url

الحجم

volume

السمات المضمّنة

تُرجِع منصة Messenger السمات التالية افتراضيًا.

المعلوماتالسمة

رسائل الوداع (باللغة الإنجليزية فقط)

bye

رسائل الترحيب (باللغة الإنجليزية فقط)

greetings

التوجه

sentiment

رسائل الشكر (باللغة الإنجليزية فقط)

thanks

اطلع على وثائق Wit.ai لدينالمعرفة المزيد عن الكيانات والسمات المتوفرة وغير ذلك الكثير.

مثال على الإشعار

المثال التالي لرسالة تتضمن عبارة "أراك غدًا الساعة 4 مساءً" وقد تتضمن كيانَي datetime وsentiment بعد التحليل:

{...,
  "entities": {
    "datetime:datetime": [
      {
        "id": "340464963587159",
        "name": "datetime",
        "role": "datetime",
        "start": 8,
        "end": 23,
        "body": "tomorrow at 4pm",
        "confidence": 0.9704,
        "entities": [],
        "type": "value",
        "grain": "hour",
        "value": "2020-06-16T16:00:00.000-07:00",
        "values": [
          {
            "type": "value",
            "grain": "hour",
            "value": "2020-06-16T16:00:00.000-07:00"
          }
        ]
      }
    ]
  },
  "traits": {
    "sentiment": [
      {
        "id": "5ac2b50a-44e4-466e-9d49-bad6bd40092c",
        "value": "neutral",
        "confidence": 0.6162
      }
    ]
  }

تحليل رسالة معالجة اللغة الطبيعية (NLP)

في أحداث messages Webhook التي تستخدمها، يمكنك الرد على الرسائل من خلال الاستفادة من معالجة اللغة الطبيعية (NLP) الافتراضية. على سبيل المثال، إذا كانت لديك وظيفة handleMessage() للرد على كل رسالة من الرسائل الواردة، يمكنك استخدام الكيان greetings لإرسال رد مناسب:

function firstTrait(nlp, name) {
  return nlp && nlp.entities && nlp.traits[name] && nlp.traits[name][0];
}

function handleMessage(message) {
  // check greeting is here and is confident
  const greeting = firstTrait(message.nlp, 'greetings');
  if (greeting && greeting.confidence > 0.8) {
    sendResponse('Hi there!');
  } else { 
    // default logic
  }
}