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

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

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

שאלות נפוצות

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

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

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

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

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

אם משתמשים ב-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 לא זמין".

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

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

איך אפשר לבדוק את סטטוס התקינות של הפעולה? אפשר לבדוק את ה-Developer Console שלך ולראות את הסטטוס של הפעולה. לא בריאה הסטטוס של הפעולות יהיה לא בריאה. פעולות בריאות יסומנו בפורמט Deployed.

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

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