ystanwar / pb-python

Pandorabots API module for Python

###pb-python###

Pandorabots API module for Python

This is a guide for the Pandorabots SDK for the Python programming language. It provides usage guidelines as well as code examples.

Please read the [Documentation.] (https://developer.pandorabots.com/docs)

Installation

The easiest way to install the latest version is by using pip/easy_install to pull it from PyPI:

pip install PbPython

You may also use Git to clone the repository from Github and install it manually:

git clone https://github.com/pandorabots/pb-python.git
cd pb-python
python setup.py install

All you have to do is write the following lines to the top of your code.

from pb_py import main as API
host = 'aiaas.pandorabots.com'

Each API call returns a value indicating the success of the call. In the event of an error, a message is returned detailing the error. To receive visual feedback as to the success of your call simply print the result, as in the following examples.

To create a bot:

result = API.create_bot(user_key, app_id, host, botname)
print result

To get a list of your bots:

result = API.list_bots(user_key, app_id, host)
print result

To delete a bot:

result = API.delete_bot(user_key, app_id, host, botname)
print result

To upload a file to a bot:

filename = 'test.aiml'
result = API.upload_file(user_key, app_id, host, botname, filename)
print result

To delete a file:

result = api.delete_file(user_key, app_id, host, botname, filename)
print result

To get a list of all your bot's files:

result = API.list_files(user_key, app_id, host, botname)
print result

To get a file:

filename = 'test.aiml'
result = API.get_file(user_key, app_id, host, botname, filename
print result

To download a bot as a zip file:

result = API.download_bot(user_key, app_id, host, botname)
print result

By default the bot downloads to the folder where the call was made from, but alternatively you can specify a folder as a download location:

result = API.download_bot(user_key, app_id, host, botname, '~/username/Downloads/'
print result

To compile a bot:

result = API.compile_bot(user_key, app_id, host, botname)
print result

To talk to a bot. It has the optional parameters of recent, session_id, reset, and client_name.

API.talk(user_key, app_id, host, botname, input_text, session_id, recent=True)

This call returns both the bot's response and the session id. Here is an example that shows capturing and displaying these values.

result = API.talk(user_key, app_id, host, botname, input_text, session_id, recent=True)
bot_response = result['response']
session_id = result['sessionid']
print bot_response, session_id

To debug input to a bot:

Note: session_id, reset, trace, and recent are all optional parameters. In the example provided, they are all passed in as True. Trace, if included, will include AIML trace information for an input Reset resets a bot’s memory, erasing predicates as well as that and topic information.

result = API.debug_bot(user_key, app_id, host, botname, input_text, session_id=True, reset=True, trace=True, recent=True)
print result

It should be noted that storing the return values of the various API calls, as in the previous examples, is not required. The following two examples accomplish the same thing, the only difference being that the second example provides feedback as to the success or failure of the call.

Example 1:

API.create_bot(user_key, app_id, host, botname)

Example 2:

result = API.create_bot(user_key, app_id, host, botname)
print result