ישויות של סשנים

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

לדוגמה, אם לסוכן שלכם יש סוג ישות @fruit שכולל את המילים "אגס" ו "ענב", אפשר לעדכן את סוג הישות הזה כך שיכלול את המילים "תפוח" או "תפוז", בהתאם למידע שהסוכן אוסף מהמשתמש. סוג הישות המעודכן יכלול את רשומת הישות apple או orange למשך שאר הסשן.

יצירת ישויות של סשנים עם ביצוע הזמנה

אפשר ליצור ישויות של סשנים באמצעות fulfillment. הסוג WebhookResponse מכיל שדה בשם sessionEntityTypes שמשמש להגדרת ישויות של סשן.

בדוגמאות הבאות מוצגות דרכים להגדיר את הערכים apple ו-orange עבור רשומות של ישויות מסוג fruit בפעילות הנוכחית.

דוגמה ל-WebhookResponse:

{
  "fulfillmentMessages": [
    {
      "text": {
        "text": [
          "Choose apple or orange"
        ]
      }
    }
  ],
  "sessionEntityTypes":[
    {
      "name":"projects/project-id/agent/sessions/session-id/entityTypes/fruit",
      "entities":[
        {
          "value":"APPLE_KEY",
          "synonyms":[
            "apple",
            "green apple",
            "crabapple"
          ]
        },
        {
          "value":"ORANGE_KEY",
          "synonyms":[
            "orange"
          ]
        }
      ],
      "entityOverrideMode":"ENTITY_OVERRIDE_MODE_OVERRIDE"
    }
  ]
}

דוגמה לשימוש בספריית הלקוח Actions on Google:

אם אתם משתמשים בספריית הלקוח של Actions on Google, אתם יכולים להשתמש בתוסף Session Entities.

הקוד ייראה בערך כך:

const { sessionEntitiesHelper } = require('actions-on-google-dialogflow-session-entities-plugin')

const app = dialogflow()
    .use(sessionEntitiesHelper())

app.intent('input.welcome', (conv) => {
  conv.ask('make your choice: apple or orange?');
  // Set the fruit session entity values to 'apple' and 'orange'.
  conv.sessionEntities.add({
    name: 'fruit',
    entities: [{
      value: 'APPLE_KEY',
      synonyms: [
        'apple', 'green apple', 'crabapple'
      ]
    }, {
      value: 'ORANGE_KEY',
      synonyms: ['orange']
    }]
  });
  conv.sessionEntities.send();
});

יצירת ישויות של סשנים באמצעות API

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

הקודם
Custom entities
הבא
Regexp entities