נפח האחסון של המשתמשים

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

המצב של אחסון המשתמש מועבר בבקשת app.handle() ונשמר באובייקט user.

קריאה וכתיבה של נתונים בשיחות שונות

כדי לעדכן או להגדיר ערך חדש באחסון של המשתמש, צריך להקצות את הערך ל-params בשדה של האובייקט user בקריאת תגובה לפעולה מאתר אחר (webhook). הדוגמאות הבאות מגדירות "exampleColor" ל"אדום" באחסון המשתמש:

Node.js

// Assign color to user storage
app.handle('storeColor', conv => {
  let color = 'red';
  conv.user.params.exampleColor = color;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED",
        "exampleColor": "red"
      }
    }
  }
}

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

Node.js

// Retrieve color from user storage
app.handle('getStoredColor', conv => {
  let color = conv.user.params.exampleColor;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED",
        "exampleColor": "red"
      }
    }
  }
}

כדי למחוק ערך שנשמר בעבר, צריך להגדיר את הערך כ-null בשיחת תגובה לפעולה מאתר אחר (webhook). הדוגמה הבאה מנקה את הערך של 'exampleColor' באחסון המשתמש:

Node.js

// Clear color from user storage
app.handle('clearStoredColor', conv => {
  conv.user.params.exampleColor = null;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED"
      }
    }
  }
}

הפניה לערכים מאוחסנים בהנחיות

אתם יכולים להפנות לערכים שמאוחסנים באחסון של המשתמש בהודעה. כדי להפנות אל צריך להשתמש בתחביר $user.params.PARAMETER_NAME, כאשר PARAMETER_NAME הוא השם שניתן ב-webhook כאשר הוגדר פרמטר.

לדוגמה, אחסנתם בעבר ערך צבע באחסון של משתמש בתור הפרמטר exampleColor. כדי לגשת לערך הזה בהנחיה, אתם מפנים אל ערך באמצעות $user.params.exampleColor:

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Your favorite color is $user.params.exampleColor."
      }]
    }
  }]
}

הפניה לערכים מאוחסנים בתוך תנאים

אפשר גם להפנות לערכים שמאוחסנים באחסון של המשתמש בתנאים. שפת תרגום בהפניה לערך, משתמשים בפונקציה user.params.PARAMETER_NAME כאשר PARAMETER_NAME הוא השם שניתן webhook כשהפרמטר הוגדר.

לדוגמה, אחסנתם בעבר ערך צבע באחסון של משתמש בתור הפרמטר exampleColor, וצריך להתאים אותו לערך "red" תוך שימוש תנאי. בתנאי שלכם, אתם מפנים לערך המאוחסן באמצעות user.params.exampleColor ביטוי התנאי ייראה כך:

תחביר של תנאים

user.params.exampleColor == "red"

תפוגת התוקף של נתוני האחסון של המשתמש

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

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

סיבות אפשריות לכך שלמשתמש יש סטטוס אימות GUEST:

  • התוצאות האישיות הושבתו עבור המשתמש.
  • המשתמש השבית את האינטרנט ו פעילות באפליקציות. חשוב לזכור שבחלק מהמקרים משתמשים יכולים להשבית את ההגדרה הזו ברמת הדומיין.
  • אם התכונה Voice Match מופעלת במכשיר, ההתאמה נכשלת או שהמשתמש מפעיל Assistant בלי להשתמש בקול (למשל, לחיצה ארוכה על Nest Home במכשיר).
  • המשתמש לא מחובר לחשבון.

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

חשיפה למשתמשים

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

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

  1. נכנסים אל הספרייה של Assistant.
  2. מחפשים את הפעולה שרוצים להציג או לנקות את נפח האחסון של המשתמש ובוחרים בה.
  3. גוללים לתחתית הדף:
    • כדי להציג את תוכן נפח האחסון של המשתמש, לוחצים על [הצגת נתונים מאוחסנים].
    • כדי לאפס את הנתונים שמאוחסנים באחסון של המשתמש בשירות, לוחצים על איפוס.
    • כדי להסיר נתונים שמאוחסנים באחסון של המשתמש ולהפסיק את השירות מ- כדי לזכור אותך, יש ללחוץ על הפסקת השימוש ב-action_name כדי שלא תזכור אותי.