A set of 🚀🚀🚀 components to be used with Botfront and/or Rasa.
Botfront is an open source chatbot platform built with Rasa.
This policy implements fallback and suggestion-based disambiguation.
It works with actions rasa_addons.core.actions.ActionBotfrontDisambiguation, rasa_addons.core.actions.ActionBotfrontDisambiguationFollowup and rasa_addons.core.actions.ActionBotfrontFallback.
policies:
...
- name: rasa_addons.core.policies.BotfrontDisambiguationPolicy
fallback_trigger: 0.30
disambiguation_trigger: '$0 < 2 * $1'
deny_suggestions: 'deny_suggestions'
n_suggestions: 3
excluded_intents:
- ^chitchat\..*
disambiguation_title:
en: "Sorry, I'm not sure I understood. Did you mean..."
fr: "J'ai mal compris. Voulez-vous dire..."
intent_mappings:
basics.yes:
en: "Yes"
fr: "Oui"
basics.no:
en: "No"
fr: "Non"
I_need_help:
en: "Help me"
fr: "Aidez-moi"
I_come_from:
en: "I come from {from}"
fr: "Je viens de {from}"
want_shirt:
en: "I want a {color} shirt"
fr: "Je veux un chandail {color}"
deny_suggestions:
en: "Something else"
fr: "Autre chose"
...
Float (default 0.30): if confidence of top-ranking intent is below this threshold, fallback is triggered. Fallback is an action that utters the template utter_fallback and returns to the previous conversation state.
String (default '$0 < 2 * $1'): if this expression holds, disambiguation is triggered. (If it has already been triggered on the previous turn, fallback is triggered instead.) Here this expression resolves to "the score of the top-ranking intent is below twice the score of the second-ranking intent". Disambiguation is an action that lets the user to choose from the top-ranking intents using a button prompt.
In addition, an 'Other' option is shown with payload defined in deny_suggestions param is shown. It is up to the conversation designer to implement a story to handle the continuation of this interaction.
String: the intent associated in the payload for the 'Other' option.
Int (default 3): the maximum number of suggestions to display (excluding the 'Other' option).
List (regex string): any intent (exactly) matching one of these regular expressions will not be shown as a suggestion.
Dict (language string -> string): localized disambiguation message title.
Dict (intent string -> language string -> string): localized representative button title for intents. If no title is defined for a given intent, the intent name is rendered instead. These titles support entity substitution: any entity name enclosed in curly brackets ({entity}) will be filled with entity information from the user utterance.
Important: The title for the 'Other' option is also defined here.
This policy implements regular expression-based direct mapping from intent to action.
policies:
...
- name: rasa_addons.core.policies.BotfrontMappingPolicy
triggers:
- trigger: '^map\..+'
action: 'action_botfront_mapping'
extra_actions:
- 'action_myaction'
...
The default action ActionBotfrontMapping takes the intent that triggered the mapping policy, e.g. map.my_intent and tries to generate the template utter_map.my_intent.
credentials:
...
rasa_addons.core.channels.webchat.WebchatInput:
session_persistence: true
base_url: {{rasa_url}}
socket_path: '/socket.io/'
...
credentials:
...
rasa_addons.core.channels.rest.RestInput:
# POST {{rasa_url}}/webhooks/rest/
...
Idential to Rasa's TemplatedNaturalLanguageGenerator, except in handles templates with a language key.
The new standard way to connect to the Botfront NLG endpoint. Note that support for the legacy REST endpoint is maintained for the moment. This feature is accessed by supplying a URL that doesn't contain the substring "graphql".
endpoints:
...
nlg:
url: 'http://localhost:3000/graphql'
type: 'rasa_addons.core.nlg.GraphQLNaturalLanguageGenerator'
...