FormAction SDK for Rasa

Installation

npm i nodejs-formaction-sdk-rasa

OR

npm i https://github.com/rohitnairtech/nodejs-formaction-sdk-rasa/tarball/master

Usage

const {handleFormAction} = require('nodejs-formaction-sdk-rasa');
handleFormAction(<REQUIRED_SLOTS_ARRAY>, <ENTITIES_ARRAY>, <SLOT_ARRAY>, <TEMPLATE_ARRAY>, <NEXT_ACTION_NAME>, <senderID_OPTIONAL>);

OR

const formAction = require('nodejs-formaction-sdk-rasa');
formAction.handleFormAction(<REQUIRED_SLOTS_ARRAY>, <ENTITIES_ARRAY>, <SLOT_ARRAY>, <TEMPLATE_ARRAY>, <NEXT_ACTION_NAME>, <senderID_OPTIONAL>);

FormAction example

const {handleFormAction} = require('nodejs-formaction-sdk-rasa');

const request = req.body; // from express endpoint in external nodejs actions endpoint
const required_slot = ['origin', 'destination', 'date'];
const entites = request.tracker.latest_message.entities;
const slots = request.tracker.slots;
const templates = request.domain.templates;
const nextAction = 'utter_flight_details';
const senderID = request.sender_id;
//SenderID is used to send out random unrepeating utterance if multiple utterance available. Optional feature to enhance user experience 

const formHandle = handleFormAction(required_slot, entities, slots, templates, nextAction, senderID);
formHandle.then(resp=>{
	console.log(resp);
	//send the response back to rasa python agent
}).catch(err=>{
	console.log(err);
});

FormAction example, using expressjs as webserver

"use strict";

const {handleFormAction} = require('nodejs-formaction-sdk-rasa');

const express = require('express');
const app = express();
const port = 3001;

app.use(express.json({limit: '5mb'}));

app.post('/actionWebhook', (req, res) => {

    const request = req.body;
    const next_action = request.next_action;
    const entities = request.tracker.latest_message.entities;
    const slots = request.tracker.slots;
    const sender = request.sender_id;
    const required_slots = ['origin', 'destination', 'flight_class', 'num_people', 'date'];
    const nextAction = 'utter_flight_details';

    let formAction;

    switch(next_action){
        case 'form_name':
            formAction = handleFormAction(required_slots, entities, slots, nextAction, sender);
            formAction.then(resp=>{
                res.json(resp);
            }).catch(err=>{
                console.log(err);
            });
            break;
    }

});

app.listen(port, () => console.log(`Actions server listening on port ${port}`));

Notes

• TURN OFF AUTOFILL for SLOTS in domain, but use the same name as the ENTITIES for SLOTS - SlotFilling happens in the module
• Register utter_ask_<SLOT_NAME> this is used to dynamically utter a question back to the user.
• Register nextAction name - utterance/custom action name in domain. That action will called upon successfully completing slot filling.