Metadata-Version: 2.1
Name: rasa-addons
Version: 0.9.14
Summary: Rasa Addons - Components for Rasa and Botfront
Home-page: https://botfront.io
Author: Botfront
Author-email: hi@botfront.io
License: Apache 2.0
Description: # Rasa Addons
        
        ![PyPI](https://img.shields.io/pypi/v/rasa-addons.svg)
        ![Travis](https://img.shields.io/travis/mrbot-ai/rasa-addons.svg)
        
        A set of 🚀🚀🚀 components to be used with Botfront and/or Rasa.
        
        [Botfront](https://github.com/botfront/botfront) is an open source chatbot platform built with Rasa.
        
        ## rasa_addons.core.policies.BotfrontDisambiguationPolicy
        
        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``.
        
        ### Example usage
        
        ```
        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"
        ...
        ```
        
        ### Parameters
        
        ##### fallback_trigger
        
        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.
        
        ##### disambiguation_trigger
        
        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.
        
        ##### deny_suggestions
        
        String: the intent associated in the payload for the 'Other' option.
        
        ##### n_suggestions
        
        Int (default 3): the maximum number of suggestions to display (excluding the 'Other' option).
        
        ##### excluded_intents
        
        List (regex string): any intent (exactly) matching one of these regular expressions will not be shown as a suggestion.
        
        ##### disambiguation_title
        
        Dict (language string -> string): localized disambiguation message title.
        
        ##### intent_mappings
        
        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.
        
        ## rasa_addons.core.policies.BotfrontMappingPolicy
        
        This policy implements regular expression-based direct mapping from intent to action.
        
        ### Example usage
        
        ```
        policies:
        ...
          - name: rasa_addons.core.policies.BotfrontMappingPolicy
            triggers:
              - trigger: '^map\..+'
                action: 'action_botfront_mapping'
                extra_actions:
                  - 'action_myaction'
        ...
        ```
        
        ### ActionBotfrontMapping
        
        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``.
        
        ## rasa_addons.core.channels.webchat.WebchatInput
        
        ### Example usage
        
        ```
        credentials:
        ...
        rasa_addons.core.channels.webchat.WebchatInput:
          session_persistence: true
          base_url: {{rasa_url}}
          socket_path: '/socket.io/'
        ...
        ```
        
        ## rasa_addons.core.channels.rest.BotfrontRestInput
        
        ### Example usage
        
        ```
        credentials:
        ...
        rasa_addons.core.channels.rest.BotfrontRestInput:
          # POST {{rasa_url}}/webhooks/rest/webhook/
        ...
        ```
        
        ## rasa_addons.core.nlg.BotfrontTemplatedNaturalLanguageGenerator
        
        Idential to Rasa's `TemplatedNaturalLanguageGenerator`, except in handles templates with a language key.
        
        ## rasa_addons.core.nlg.GraphQLNaturalLanguageGenerator
        
        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".
        
        ### Example usage
        
        ```
        endpoints:
        ...
        nlg:
          url: 'http://localhost:3000/graphql'
          type: 'rasa_addons.core.nlg.GraphQLNaturalLanguageGenerator'
        ...
        ```
Platform: UNKNOWN
Description-Content-Type: text/markdown
