Skip to content

Add smartness and conversational UX to Hubot with API.AI as back-end

License

Notifications You must be signed in to change notification settings

ojacques/hubot-apiai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Add smartness to hubot with API.AI

A hubot script that adds conversational user experience with api.ai as back-end.

When you talk to Hubot, this script sends the text to api.ai, which in turns handles the dialog and detects intents and parameters. Finally, the script emits an event (robot.emit) so that it can be consumed by other scripts.

example

See src/apiai.coffee for full documentation.

Installation

In hubot project repo, run:

npm install hubot-apiai --save

Then add hubot-apiai to your external-scripts.json:

[
  "hubot-apiai"
]

Configuration variable

API_AI_CLIENT_ACCESS_TOKEN: API AI client access token which you get from https://console.api.ai/api-client/

Create listener scripts

hubot-apiai will emit events which correspond to intents that you describe in API.AI.

Let's say that you have an intent called help-me in API.AI. You can create an hubot script which will act on help-me intents:

module.exports = (robot) ->
  robot.on "help-me", (msg, params) ->
    # Your code here

The parameters from the intent are passed as part of Hubot's event.

NPM Module

https://www.npmjs.com/package/hubot-apiai

TODO

  • Add tests