Entity sesi

Sesi mewakili percakapan antara agen Dialogflow dan pengguna akhir. Anda dapat membuat entity khusus, yang disebut entity sesi, selama sesi. Entity sesi dapat memperluas atau mengganti jenis entity kustom dan hanya ada selama sesi yang dibuat untuknya. Semua data sesi, termasuk entity sesi, disimpan oleh Dialogflow selama 20 menit.

Misalnya, jika agen Anda memiliki jenis entitas @fruit yang menyertakan "pir" dan "anggur", jenis entitas tersebut dapat diperbarui untuk menyertakan "apel" atau "jeruk", bergantung pada informasi yang dikumpulkan agen Anda dari pengguna akhir. Jenis entitas yang diperbarui akan memiliki entri entity "apple" atau "orange" untuk sisa sesi.

Membuat entity sesi dengan fulfillment

Anda dapat membuat entity sesi dengan fulfillment. Jenis WebhookResponse berisi kolom bernama sessionEntityTypes yang digunakan untuk menetapkan entity sesi.

Contoh berikut menunjukkan cara menetapkan entri entity jenis entity fruit ke apple dan orange untuk sesi saat ini.

Contoh 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"
    }
  ]
}

Contoh penggunaan library klien Actions on Google:

Jika menggunakan library klien Actions on Google, Anda dapat menggunakan plugin Entity Sesi.

Kode Anda akan terlihat seperti berikut:

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();
});

Membuat entity sesi dengan API

Catatan: Metode API entity sesi tidak berfungsi dengan integrasi Asisten Google. Gunakan opsi fulfillment untuk integrasi Asisten Google.

Anda membuat, mengelola, dan memperbarui entity sesi menggunakan jenis SessionEntityTypes.