סקירה כללית של פעולות ב-SDK (Dialogflow)

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

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

CLI של פעולות

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

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

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

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

  • "Ok Google, talk to ExampleAction."
  • "Ok Google, לדבר עם exampleAction כדי לקנות נעליים".
  • "Ok Google, לדבר עם exampleAction כדי לבדוק את ההזמנה שלי."
  • "Ok Google, talk to ExampleAction to show the offers of today"

קובץ ה-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 של מילוי ההזמנה, אתם מקבלים את קלט המשתמש כמחרוזת טקסט. כדי לעבד את הכוונה, מנתחים בדרך כלל את קלט הטקסט ומחזירים תגובה. החלפה זו מתרחשת הלוך וחזור עד שהשיחה בפעולה מסתיימת.

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

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

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

יש לשלוח את הפרויקט לאישור ולהנגיש אותו למשתמשים

טעימות

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