Partager via


AutoSaveStateMiddleware class

Middleware qui enregistre automatiquement les modifications d’état à la fin du tour.

Remarques

La classe AutoSaveStateMiddleware doit être ajoutée en haut de la pile d’intergiciels de votre bot, avant tout autre composant qui utilise l’état. Les plug-ins BotState passés au constructeur auront leur méthode BotState.saveChanges() appelée lors de la réussite du tour.

Cet exemple montre le code réutilisable pour la lecture et l’écriture de conversation et l’état utilisateur au sein d’un bot :

const { AutoSaveStateMiddleware, ConversationState, UserState, MemoryStorage } = require('botbuilder');

const storage = new MemoryStorage();
const conversationState = new ConversationState(storage);
const userState = new UserState(storage);
adapter.use(new AutoSaveStateMiddleware(conversationState, userState));

server.post('/api/messages', (req, res) => {
   adapter.processActivity(req, res, async (turnContext) => {
      // Get state
      const convo = await conversationState.load(turnContext);
      const user = await userState.load(turnContext);

      // ... route activity ...
      // ...make changes to state objects...
      // ... no need to call userState.saveChanges() or conversationState.saveChanges() anymore!
   });
});

Constructeurs

AutoSaveStateMiddleware(BotState[])

Crée une instance AutoSaveStateMiddleware.

Propriétés

botStateSet

Ensemble de plug-ins BotState enregistrés automatiquement.

Méthodes

add(BotState[])

Ajoute des plug-ins BotState supplémentaires à enregistrer.

onTurn(TurnContext, () => Promise<void>)

Appelé par l’adaptateur (par exemple, un BotFrameworkAdapter) lors de l’exécution pour traiter un d’activité entrante.

Détails du constructeur

AutoSaveStateMiddleware(BotState[])

Crée une instance AutoSaveStateMiddleware.

new AutoSaveStateMiddleware(botStates: BotState[])

Paramètres

botStates

BotState[]

Un ou plusieurs plug-ins BotState pour enregistrer automatiquement à la fin du tour.

Détails de la propriété

botStateSet

Ensemble de plug-ins BotState enregistrés automatiquement.

botStateSet: BotStateSet

Valeur de propriété

Détails de la méthode

add(BotState[])

Ajoute des plug-ins BotState supplémentaires à enregistrer.

function add(botStates: BotState[]): this

Paramètres

botStates

BotState[]

Un ou plusieurs plug-ins BotState à ajouter.

Retours

this

Objet BotStateSet mis à jour.

onTurn(TurnContext, () => Promise<void>)

Appelé par l’adaptateur (par exemple, un BotFrameworkAdapter) lors de l’exécution pour traiter un d’activité entrante.

function onTurn(context: TurnContext, next: () => Promise<void>): Promise<void>

Paramètres

context
TurnContext

Objet de contexte pour ce tour.

next

() => Promise<void>

Fonction de délégué suivante.

Retours

Promise<void>