bot

Documentation

Index

• Variables
• type Auth
• type Bot
  • func New(botConfig *Config) (*Bot, error)
  • func (b *Bot) Answer(receiveMsg *messages.Receive) ([]query.Answer, error)
  • func (b *Bot) ChannelHandler(w http.ResponseWriter, r *http.Request, chnl channels.Channel)
  • func (b *Bot) RegisterRoutes()
  • func (b *Bot) Run()
• type Config
  • func LoadConfig(path string, port int) (*Config, error)
  • func (c *Config) ShouldReplyError(isExistingConversation bool) bool
  • func (c *Config) ShouldReplyUnknown(isExistingConversation bool) bool
  • func (c *Config) ShouldReplyUnsure(isExistingConversation bool) bool
• type Conversation
• type ConversationConfig
• type ErrUnknownExtension
  • func (e *ErrUnknownExtension) Error() string
• type Prediction

Variables

var ErrValidationFailed = errors.New("the callback token is invalid")

ErrValidationFailed happens when a channel cannot validate an incoming callback

Types

type Auth

type Auth struct {
	Token string `mapstructure:"token"`
}

Auth is authorization for the bot API

type Bot

type Bot struct {
	Name       string
	Store      store.Store
	Domain     *fsm.Domain
	Classifier *clf.Classifier
	Extensions extension.ServerMap
	Channels   *channels.Channels
	Config     *Config
	Router     *mux.Router
}

Bot models a bot with a Classifier and an FSM

func New

func New(botConfig *Config) (*Bot, error)

New initializes and returns a new Bot

func (*Bot) Answer

func (b *Bot) Answer(receiveMsg *messages.Receive) ([]query.Answer, error)

Answer takes a user input and executes a transition on the FSM if possible

func (*Bot) ChannelHandler

func (b *Bot) ChannelHandler(w http.ResponseWriter, r *http.Request, chnl channels.Channel)

ChannelHandler takes an incoming http.Request and passes it to a channel for it to respond

func (*Bot) RegisterRoutes

func (b *Bot) RegisterRoutes()

RegisterRoutes with the bot router

func (*Bot) Run

func (b *Bot) Run()

Run starts the bot which is a long running process

type Config

type Config struct {
	Name         string                  `mapstructure:"bot_name"`
	Extensions   extension.ConfigMap     `mapstructure:"extensions"`
	Store        storeconfig.StoreConfig `mapstructure:"store"`
	Port         int                     `mapstructure:"port"`
	Path         string
	Conversation Conversation `mapstructure:"conversation"`
	Auth         Auth         `mapstructure:"auth"`
}

Config struct models the bot.yml configuration file

func LoadConfig

func LoadConfig(path string, port int) (*Config, error)

LoadConfig loads bot configuration from bot.yml

func (*Config) ShouldReplyError

func (c *Config) ShouldReplyError(isExistingConversation bool) bool

ShouldReplyError depending on the conversational settings lets the bot know if it should reply with Error to the channel

func (*Config) ShouldReplyUnknown

func (c *Config) ShouldReplyUnknown(isExistingConversation bool) bool

ShouldReplyUnknown depending on the conversational settings lets the bot know if it should reply with Unknown to the channel

func (*Config) ShouldReplyUnsure

func (c *Config) ShouldReplyUnsure(isExistingConversation bool) bool

ShouldReplyUnsure depending on the conversational settings lets the bot know if it should reply with Unsure to the channel

type Conversation

type Conversation struct {
	New      ConversationConfig `mapstructure:"new"`
	Existing ConversationConfig `mapstructure:"existing"`
}

Conversation settings for new and existing conversations

type ConversationConfig

type ConversationConfig struct {
	ReplyUnsure  bool `mapstructure:"reply_unsure"`
	ReplyUnknown bool `mapstructure:"reply_unknown"`
	ReplyError   bool `mapstructure:"reply_error"`
}

ConversationConfig for the bot

type ErrUnknownExtension

type ErrUnknownExtension struct {
	Extension string
}

ErrUnknownExtension is returned by the Bot when the provided extension name does not exist

func (*ErrUnknownExtension) Error

func (e *ErrUnknownExtension) Error() string

Error returns the ErrUnknownExtension error message

type Prediction

type Prediction struct {
	Original    string  `json:"original"`
	Predicted   string  `json:"predicted"`
	Probability float32 `json:"probability"`
}

Prediction models a classifier prediction and its original string