INTRODUCTION

Greetings and thank you for purchasing a Restless Studio Pandorabot. Pandorabots
can be on hand to greet and inform or entertain guests on your parcel even when you
are offline. A properly customized Pandorabot can act effectively as a personal or
business assistant, directing and informing your visitors to products, services, or
personal whereabouts. Once deployed a Pandorabot is not a static feature of the
parcel but continues to evolve as responses to additional matching words, phrases,
questions, and comments are programmed or learned.

Restless Studio Pandorabots are now preconfigured to query Wikipedia for responses
making the Pandorabot the smartest robot in Second Life. The Pandorabot is the
only chat bot in Second Life that supports multiple bot deployment allowing you
to place two or more Pandorabots in your store or home, each responding to
queries for a particular product, service, or function. Pandorabots can also be
used to check spelling, deliver notecards/landmarks, and greet new arrivals.

Pandorabot V4 and later can be integrated with an Actorbot from Sine Wave to
provide a realistic 3D animated avatar. Instructions on integrating a Pandorabot V4
with an Actorbot are included in the Pandorabot V4 package and available in PDF
format at http://www.scribd.com/missyrestless . A tutorial on creating a 3D
animated avatar Pandorabot is available at http://pandorabot.blogspot.com/p/how-
to.html . Pandorabot V5 and later can also be integrated with a METAbolt bot using
the text client at http://www.metabolt.net/

CONTENTS

This package contains one or more preconfigured Pandorabots for immediate use.
The instructions below provide simple steps to configure your own custom
Pandorabot. Should you prefer, custom Pandorabots are available from Restless
Studio - simply contact missyrestless@gmail.com or IM Missy Restless inworld.

Restless Studio provides a business dress female human avatar Pandorabot, a male
human avatar Pandorabot, a female human club go-er Pandorabot, a rotating Steven
Colbert / Bob Dobbs Pandorabot head, a talking parrot on a perch Pandorabot, and a
wearable parrot Pandorabot. All of these can be rezzed and positioned to converse
with avatars in Local Chat. The wearable Pandorabots are designed so they can be
worn on the shoulder or another attachment point allowing you to deploy a
Pandorabot in areas where you cannot rez objects.

FEATURES

Restless Studio Pandorabots contain the following features:

• Artificially Intelligent chat using the latest AI research results
• Wikipedia query support including Unicode character display
• Greeter functionality so Pandorabot can greet new visitors
• Email support – any resident can use the Pandorabot to send email
• Notecard and Landmark dispenser
• Speech synthesis (male and female voices) for shared media capable viewers
• Spell Check support – any resident can check spelling with a Pandorabot
• Highly configurable including ability to restrict responses based on name
• Variety of preconfigured avatar types to use
• Integration with a Sine Wave Actorbot for a realistic 3D animated avatar
• Dialog menu configuration makes it easy to configure your Pandorabot
• Configure which language Wikipedia to use
• Configurable as public (local chat) or private channel only – low lag
• Integration with 3D animated avatar via Actorbot and METAbolt
GRAPHICAL DIALOG MENU CONFIGURATION

Although ready to use "out of the box", the Pandorabot can be extensively
configured. Restless Studio Pandorabots V2 and later support easy dialog menu
configuration by the owner. Simply click your active Pandorabot or say “configure”
and a dialog menu interface will be displayed. Most of the Pandorabot options you
would want to customize are available in the dialog menu.

NOTECARD CONFIGURATION

Your Pandorabot is delivered with default settings suitable for most deployments.
Should you wish to change the default settings you can do so by editing the
Configuration notecard.

A complete list of user configurable parameters can be found in the Configuration

notecard in the Pandorabot object's Contents. Below are most of the commonly used
configuration options.

Settings are specified in the format "<name> = <value>"

DO NOT use "=" in either the <name> or <value>
Place any uncommented configuration settings above the END_SETTINGS
line. Lines below END_SETTINGS will not be read and are there
for information and help configuring.

The default settings should work well for most uses.

NOTECARD, LANDMARK & USER GUIDE DELIVERY

When touched by a non-owner the Pandorabot will deliver a notecard, landmark, and
the Pandorabot User Guide. The Pandorabot simply looks for the first notecard and
landmark in its inventory and delivers these. To configure your Pandorabot's
delivery items, drop the notecard and landmark you wish delivered to your visitors
into the Pandorabot's contents. Make sure these are named so they appear first in
alphabetical order. For instance, use an underscore or asterisk as the first
character in their names. Pandorabot V5 and later can be configured to deliver a
notecard, landmark, and additional documents via a dialog menu.

NAME CONFIGURATION

To change the name of your Pandorabot, open the Configuration notecard:

right click the object -> Edit
click the Contents tab
right click the Configuration notecard -> Open
At the beginning of the notecard add two lines like:
FIRST_NAME = Buffy
LAST_NAME = Bot

This will change your Pandorabot name to "Buffy Bot". Change Buffy and Bot to
whatever name you want your Pandorabot to have. When finished, click Save and
close the edit window. When NAME_ENABLED is TRUE the name of the Pandorabot
determines which local chat the Pandorabot responds to. See NAME_ENABLED
below for more information on response control.

Note that judicious choice of a Pandorabot name coupled with NAME_ENABLED set
to TRUE can configure your Pandorabot to only respond to local chat specific
to a particular need. For instance, a Pandorabot named "Spellfire Sword" might
be deployed to respond only to queries concerning either the Spellfire battle
system and/or swords, perhaps replying with a slurl to their location.
GENDER

To change a Pandorabot from female to male, change the name as above and also
add the line at the top of the Configuration notecard:

TEXTURE = male

After saving your changes and closing the edit window your Pandorabot should
set the name to the new name you gave it as well as retexture itself with the
male texture. You can replace either the female or male textures in the
Pandorabot object contents or add your own custom textures. The gender can also be
selected from several preconfigured appearances via the dialog menu.

VOICE CONFIGURATION

Pandorabots V3 and later are preconfigured to speak using the free speech synthesis
provided at http://secondlife.mitsi.com by Ferd Frederix. The Pandorabot can be
configured to use a female voice, male voice, or no voice. The default voice can be
set in the Configuration notecard by setting “VOICE = Female”, “VOICE = Male”, or
“VOICE = None”. Male or Female voice setting is automatically performed when
setting the Gender in the dialog menu unless “None” has previously been selected.
Email and spelling corrections are never spoken.

CONFIGURATION NOTECARD SETTINGS

Default values for the following variables can be set by editing the Configuration
notecard in the Pandorabot contents:

SHOW_BOT_MENU

Provide additional configuration menu entries for and Actorbot or METAbolt bot if
they have been integrated with the Pandorabot.

OWNER_BOT_MENU

If TRUE only the owner (or group if group access has been configured) may operate
the configuration dialog menu system. If FALSE non-owner/non-group residents will
be provided with a subset of the dialog menus suitable for Pandorabot interaction.

AI_ENABLED

If TRUE Pandorabot will chat using AI from pandorabots.com. If FALSE the Pandorabot
will still query Wikipedia, spellcheck, greet, etc as configured.

NAME_ENABLED

If FALSE the bot will attempt to respond to all local chat

If TRUE the bot will attempt to respond only to local chat containing
either first or last name. Regardless, all email and shutoff triggers in
local chat are responded to if EMAIL_ENABLED and/or SHUTOFF_ENABLED are TRUE.

GREET_ENABLED

If TRUE the bot will issue a greeting to new arrivals. If FALSE, no greeting will
be issued. The greeting text and sensor range can be customized by editing the
Greeter_Config notecard in the object contents.
HOVER_ENABLED

If FALSE the hover text will not be set. If TRUE the hover text will be set.

SPELL_ENABLED

If TRUE the bot will act as a spell checker when it recognizes certain trigger
phrases. See SPELL_TRIGGERS for more information.

TEXT_ENABLED

If FALSE the bot textures will not be altered. If TRUE the texture will be
set to TEXTURE on startup.

INVISIBLE

If TRUE make the bot invisible

FIRST_NAME & LAST_NAME

The name by which your bot will respond. If NAME_ENABLED is TRUE, the bot
will only respond if either string is in the chat message (case insensitive).

CHANNEL

Setting this to a positive non-zero value configures the Pandorabot to listen on

that channel. In this mode the Pandorabot becomes a private owner-only agent. All
communication with the Pandorabot must be prefaced with the channel number. For
instance, if CHANNEL = 22, the Pandorabot will only respond to chat prefaced with /
22 – e.g. “/22 Who is Abraham Lincoln ?”

TEXTURE

The name of the texture in the object's inventory to use.

Product is delivered with "male" and "female" textures but you can drop
any texture in the object Contents and set this to the name. Note that the
default textures use a full height avatar photo with transparent background.

HOVER_TEXT

The hover text over the bot. Use "\n" for newline and "" for no text

HOVER_COLOR

The hover text color <red, green, blue>, float values between 0 and 1

BOT_ID

The Pandorabot ID to use. Note, this is the ID of the bot at pandorabots.com, not
the UUID of any Second Life object or avatar. To create your own custom Pandorabot,
program the responses in AIML at http://www.pandorabots.com/ and set this to your
custom Pandorabot ID. Alternately, a custom Pandorabot can be created to your
specification by contacting Missy Restless at missyrestless@gmail.com

BOT_NAME

Name of corresponding Bot ID. This is the name of the preprogrammed bot personality
at pandorabot.com and not the name by which the bot will identify itself.
WIKIPEDIA_ENABLED

If TRUE, chat including one of the WIKIPEDIA_TRIGGERS will cause the Pandorabot to
query Wikipedia for an appropriate response.

EMAIL_ENABLED

If TRUE you can use the Pandorabot to send email. See the EMAIL_TRIGGERS below.

EMAIL_TIMEOUT

Number of seconds a user has to compose email.

VERBAL_SHUTOFF_ENABLED

If TRUE the Pandorabot will shutoff when hearing one of these phrases.
See SHUTOFF_TRIGGERS below. Touch the Pandorabot to wake him or her up.

OWNER_LISTEN_ONLY

If set to TRUE only the owner of the Pandorabot can talk to and hear the Pandorabot

RESTRICTED_ACCESS

This can be used to restrict the ability to shutdown and configure the Pandorabot
to owner only (set to 1), group only (set to 2), or all residents (set to 0).
Setting RESTRICTED_ACCESS = 0 allows all residents to shutdown and restart the
Pandorabot as well as access a limited dialog menu appropriate for guests.

LANG_CODE

Set the language code to use for Wikipedia queries. By default the Pandorabot will
query the English Wikipedia. To configure your Pandorabot to query one of the non-
English Wikipedias, set LANG_CODE to the appropriate language code. See
http://meta.wikimedia.org/wiki/List_of_Wikipedias for a list of all Wikipedias and
their corresponding language codes. Non-English query misses are followed by an
English Wikipedia query.

LANG_NAME

The name by which the LANG_CODE selected language will be referred.

LANG_CODES

The list of language codes which can be selected in the dialog menus

LANG_NAMES

The list of names corresponding to the list of LANG_CODES.

UNWIKIABLE_PHRASES

Don't attempt to pass these to Wikipedia, get the response from pandorabots.com

WIKIPEDIA_TRIGGERS

These phrases trigger a Wikipedia query if WIKIPEDIA_ENABLED is TRUE

EMAIL_TRIGGERS

If EMAIL_ENABLED is TRUE these phrases indicate the resident wishes to send email.

SPELL_TRIGGERS

If SPELL_ENABLED is TRUE these phrases indicate the resident

wishes to check the spelling of a word.

SHUTOFF_TRIGGERS

If SHUTOFF_ENABLED is TRUE these phrases will shut the Pandorabot off

until touched. By default the Pandorabot will stop responding when it hears
either “Be quiet” or “Shut up” in local chat.

GREETER CONFIGURATION SETTINGS

In addition to the Configuration notecard Pandorabot V5 and later has a

Greeter_Config notecard that can be modified to customize the greeting provided new
arrivals. Default values for the following Greeter variables can be set by editing
the Greeter_Config notecard in the Pandorabot contents:

GREET_1
GREET_2
GREET_3

The greeting will be 'GREET_1 <name of avatar>! GREET_2'. If running as an Actorbot

the greeting will also include 'GREET_3'. For example, if GREET_1 and GREET_2 are
set as follows:
GREET_1 = Hello
GREET_2 = Chat with me in local chat.

Then a new arrival by the name of “Joe Blow” would be greeted with”

Hello Joe Blow! Chat with me in local chat.

INVITE

If TRUE offer new arrivals a group invitation if GROUP_KEY is set.

GROUP_KEY

The group key to use for group invitations.

INVITE_TRIGGER

If running as an Actorbot, the trigger string to issue a group invitation.

NOTE_NAME

The name of the notecard to deliver to new arrivals.

NOTE_NOTE

The message to issue to new arrivals along with the notecard

RANGE

The range at which new arrivals will be detected (in meters)

FREQUENCY

The frequency of scans for new arrivals (in seconds)

LIST_SIZE

The maximum size of the list of previously recongnized new arrivals

COUNT_MODE

If TRUE switch NAME_ENABLED mode based on avatar count. This can be used to
automatically switch the Pandorabot into NAME_ENABLED mode when the number of
avatars within chat distance exceeds some specified limit. If the number of
detected avatars drops below that limit the Pandorabot will switch back to
responding to all local chat.

ENABLE_COUNT

If COUNT_MODE is TRUE switch to NAME_ENABLED mode when the avatar count exceeds
this and back to responding to all local chat when the avatar count drops below or
equal to this value.

NAME_ENABLED

Initial value of NAME_ENABLED (does the Pandorabot respond only by name ?). This
should match the value set in the Configuration notecard.

FURTHER INFORMATION

The Pandorabots Owner Manual (this document) and Pandorabots User Guide are
available in PDF format at http://www.scribd.com/missyrestless

Visit the Pandorabot blog at http://pandorabot.blogspot.com where you can find many
How-To tutorials on Pandorabot use, configuration, and deployment at
http://pandorabot.blogspot.com/p/how-to.html

You can create a Sine Wave Actorbot at http://www.sinewaverobots.com/

A tutorial on how to integrate a Pandorabot V4 or later with your Actorbot is
available at http://pandorabot.blogspot.com/p/how-to.html and the Pandorabot
Actorbot Add-On Manual is available at http://www.scribd.com/doc/44821053/

Although not available at the time of this publication, manuals and tutorials for
Pandorabot METAbolt integration will also be available at
http://www.scribd.com/missyrestless and http://pandorabot.blogspot.com/p/how-
to.html

Have fun and email missyrestless@gmail.com with any questions, comments,

suggestions, requests for custom configurations or AIML programming.

View other Restless Studio creations in the Second Life Marketplace

at http://tinyurl.com/24s5fed