Pamięć sesji

Wartości parametrów dotyczące konkretnego użytkownika w rozmowie możesz przechowywać w pamięci sesji. Akcja może następnie używać tych zapisanych wartości w promptach i warunków, a kod webhooka może uzyskać dostęp do wartości w pamięci sesji dla w razie potrzeby i w razie potrzeby.

Podczas rozmowy wszystkie dane zebrane za pomocą typów są przechowywane w ramach sesji. pamięci masowej. Możesz też wchodzić w interakcję z danymi w pamięci sesji za pomocą wywołań webhooka. W przypadku wywołań webhooka stan pamięci sesji jest przekazywany w interfejsie app.handle() i jest przechowywane w obiekcie session.

Dane przechowywane w pamięci sesji wygasają po zakończeniu rozmowy.

Odczyt i zapis danych w pamięci sesji

Aby zaktualizować lub ustawić nową wartość w pamięci sesji, przypisz ją do funkcji Pole params obiektu session w wywołaniu webhooka. Przykład poniżej ustawia „exampleColor” na „czerwony” w pamięci sesji:

// 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
    }
  }
}
    

Aby uzyskać dostęp do danych przechowywanych w pamięci sesji, przypisz je do zmiennej w webhooku . Ten przykład pobiera wartość z atrybutu „exampleColor” trwa pamięć masowa:

// 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
    }
  }
}
    

Aby usunąć wcześniej zapisaną wartość, ustaw wartość w wywołaniu webhooka na null. Ten przykład usuwa wartość „exampleColor” w pamięci sesji:

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

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

Odwoływać się do przechowywanych wartości w promptach

Możesz odwoływać się do wartości zapisanych w pamięci sesji w prompcie. Aby odwołać się do wartość, użyj składni $session.params.PARAMETER_NAME, gdzie PARAMETER_NAME to nazwa nadana w webhooku, gdy parametr została ustawiona.

Na przykład w pamięci sesji została wcześniej zapisana wartość koloru jako exampleColor. Aby uzyskać dostęp do tej wartości w prompcie, musisz odwoływać się do niej: używając funkcji $session.params.exampleColor:

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

Odwoływanie się do przechowywanych wartości w warunkach

W warunkach możesz też odwoływać się do wartości przechowywanych w pamięci sesji. Do odwołuje się do wartości, użyj funkcji session.params.PARAMETER_NAME gdzie PARAMETER_NAME to nazwa podana w webhooku, parametr został skonfigurowany.

Na przykład w pamięci sesji została wcześniej zapisana wartość koloru jako exampleColor i chcesz dopasować go do wartości „red” w . W warunku odwołujesz się do wartości przedpłaconej za pomocą funkcji session.params.exampleColor Twoje wyrażenie warunku wygląda tak:

session.params.exampleColor == "red"