אחסון ביקור

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

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

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

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

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

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

{
  "responseJson": {
    "session": {
      "id": "12345678901234567890",
      "params": {
        "exampleColor": "red"
      }
    },
    "prompt": {
      "override": false
    }
  }
}
    

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

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

{
  "responseJson": {
    "session": {
      "id": "12345678901234567890",
      "params": {
        "exampleColor": "red"
      }
    },
    "prompt": {
      "override": false
    }
  }
}
    

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

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

{
  "responseJson": {
    "session": {
      "id": "12345678901234567890",
      "params": {}
    },
    "prompt": {
      "override": false
    }
  }
}
    

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

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

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

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

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

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

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

session.params.exampleColor == "red"