בדיקות תקינות

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

נקודת הקצה של כל פעולה נדרשת להגיב לברירת מחדל, ללא הפעלה של פרמטר. כך ניתן יהיה להשתמש בתרחיש שבו המשתמש מבקש לדבר עם פעולה בלי לספק מידע נוסף (לדוגמה, "I want toברי ining name")

שאלות נפוצות

האם צריך להטמיע משהו ספציפי כדי לתמוך בבדיקות התקינות?

לא. בדיקות תקינות של פעולות יפעלו כמו בקשה רגילה לדיבור עם פעולה.

באיזו תדירות נבדקת תקינות הפעולה?

ייתכן שיתבצע מעקב אחר הפעולה במהלך היום.

איך אפשר לזהות שבקשה מסוימת היא בדיקת תקינות?

אם פלטפורמת הפיתוח שלך משמשת ב-Actions Builder, מקבלים בקשה לבדיקת תקינות בדומה לקטע הקוד הבא:

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}

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

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

אם בחרת להשתמש ב-Dialogflow כפלטפורמת הפיתוח, Google מוסיפה ארגומנט "is_health_check" ומעבירה אותו ל-Intent. הארגומנט הזה נמצא באובייקט קלט של בקשת ה-webhook:

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}

מה קורה אם Google מזהה פעולה לא תקינה? אם Google תזהה שמתבצעת הפסקה זמנית בשירות, הפעולה תושעה. משתמשים שמבקשים לבצע את הפעולה הלא תקינה ישמעו את ההודעה: "ACTION_NAME is not available".

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

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

איך אפשר לבדוק את סטטוס התקינות של הפעולה? ניתן לבדוק את סטטוס הפעולה ב-Play Console. הסטטוס של פעולות לא תקינות יהיה Unhealthy. פעולות בריאותיות יסומנו כפרוסות.

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

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