סקירה כללית על Actions SDK (Dialogflow)

בעזרת Actions on Google תוכלו להרחיב את הפונקציונליות של Google Assistant באמצעות פעולות. הפעולות מאפשרות למשתמשים לבצע משימות באמצעות ממשק שיחה יכול לנוע בין פקודה מהירה להדלקת נורות מסוימות שיחה, למשל משחק במשחק טריוויה.

Actions SDK הוא שיטה לפיתוח מילוי שיחות ללא באמצעות Dialogflow. כשמשתמשים ב-Actions SDK, משתמשים בחבילת פעולות כדי למפות כוונות להגשמה שלהם. צריך גם לספק דפוסי שאילתות חבילת פעולות כדי להגדיר ביטויים לדוגמה שהמשתמשים שלך עשויים לומר.

CLI של gactions

כשמפתחים עם Actions SDK, צריך להשתמש בשורת הפקודה gactions (CLI) כדי לבדוק ולעדכן את פרויקט הפעולות שלכם. CLI של gactions עוזר גם ליצור ולנהל את חבילת 'פעולה' עבור הפעולה בשיחה.

יצירת פעולות בחבילת הפעולות

כדי ליצור פעולות בחבילת הפעולות, ממפים את הכוונות למילוי ההזמנות. פעולה מגדירה נקודת כניסה להתחלת שיחות עם שנקרא intent. אובייקטים מסוג Intent ממופים לאספקה, שמעבדות את בכוונה טובה.

לדוגמה, נניח שרצית ליצור פרויקט שמכיל פעולות כדי לרכוש מוצרים מסוימים, לבדוק את סטטוס ההזמנות ולהציג כמה מבצעים יומיים. אתם יכולים להגדיר כוונות שמופעלות על ידי אמירת:

• "Ok Google, talk to ExampleAction".
• "Ok Google, talk to ExampleAction to buy some shoes"
• "Ok Google, talk to ExampleAction כדי לבדוק את ההזמנה שלי".
• "Ok Google, talk to ExampleAction to show me today's deals".

קובץ ה-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"
    }
  }
}

יצירה ופריסה של תגובה לפעולה מאתר אחר (webhook)

כשמופעלת פעולה בפרויקט, Actions on Google שולח קריאה אל של אינטראקציה עם המשתמשים לצורך ביצוע הפעולה.

בכל בקשה ל-webhook של מילוי הבקשה, אתם מקבלים את הקלט של המשתמש מחרוזת טקסט. כדי לעבד את הכוונה, בדרך כלל מנתחים את קלט הטקסט להחזיר תשובה. החלפה הלוך ושוב מתרחשת עד שהפעולה השיחה מסתיימת.

העלאה של חבילת הפעולות

אחרי שיוצרים את חבילת הפעולות ופורסים את מילוי ההזמנות שלה, אפשר להעלות את חבילת הפעולות אל מסוף הפעולות. מסוף Actions נעשה שימוש בפרויקטים של פעולות כדי לקבץ את הפעולה בשיחה עם מטא-נתונים, כמו הביקורת שלה הסטטוס והשם המוצג בספרייה של Assistant. הפרויקט מאפשר גם להגדיר מטא-נתונים על הפעולה ולנהל את הפעולה ולעקוב אחריה באמצעות תהליך האישור.

אחרי שיוצרים פרויקט, אפשר להעלות את חבילת הפעולות שמגדירה את כל את הפעולות שתבצעו באמצעות ה-CLI של gactions.

שולחים את הפרויקט לאישור כדי שהוא יהיה זמין למשתמשים

דוגמאות

כדי לעיין בפרויקטים שהושלמו, אפשר לעיין בדוגמאות של Actions SDK של Node.js ו-Java.