نظرة عامة على حزمة تطوير البرامج (SDK) للإجراءات (Dialogflow)

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

وحزمة تطوير البرامج (SDK) الخاصة بالإجراءات هي طريقة لتطوير تنفيذ المحادثات بدون باستخدام Dialogflow. عند استخدام حزمة "SDK للإجراءات"، يمكنك استخدام "حزمة إجراءات" من أجل الأهداف على تحقيقها. يجب أيضًا تقديم أنماط طلبات البحث في حزمة الإجراءات من أجل تحديد أمثلة عبارات قد يقولها المستخدمون.

واجهة سطر الأوامر

عند تطوير البرامج باستخدام حزمة تطوير برامج المهام، يمكنك استخدام سطر الأوامر gactions. (CLI) لاختبار مشروع "المهام" وتحديثه. واجهة سطر الأوامر gactions يساعدك أيضًا في إنشاء وإدارة حزمة الإجراءات الخاصة بـ "المهام القائمة على المحادثة".

إنشاء إجراءات في حزمة الإجراءات

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

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

  • "Ok Google، أريد التحدّث إلى ExampleAction".
  • "Ok Google، يُرجى التحدّث إلى ExampleAction لشراء بعض الأحذية".
  • "Ok Google، يُرجى التحدّث إلى ExampleAction للتحقّق من طلبي".
  • "Ok Google، أريد التحدّث إلى ExampleAction للاطّلاع على عروض اليوم".

قد يبدو ملف JSON لحزمة الإجراءات على النحو التالي:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

إنشاء ردّ تلقائي على الويب لتنفيذ الطلبات ونشره

عند استدعاء إجراء في مشروعك، تستدعي "المهام على Google" التنفيذ لبدء محادثة مع المستخدمين لتنفيذ الإجراء.

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

تحميل حزمة الإجراءات

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

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

إرسال مشروعك للموافقة عليه وجعله متاحًا للمستخدمين

نماذج

لاستكشاف المشاريع المكتملة، اطّلِع على نماذج حزمة تطوير البرامج (SDK) الخاصة بـ Node.js وJava.