This document is available in PDF and OpenOffice formats at http://www.scribd.

com/doc/45108454/Pandorabots-Owner-Manual

INTRODUCTION
Greetings and thank you for purchasing a Truth & Beauty Lab 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. Truth & Beauty Lab Pandorabots are configured to query Wikipedia and Wolfram Alpha for responses making the Pandorabot the smartest scripted agent in Second Life. Pandorabots can also be used to deliver notecards/landmarks, greet new arrivals, scan the area for objects and avatars, send email, respond to chat commands from its owner, and emit a wide variety of particle displays. A graphical dialog menu allows you to easily configure and use your Pandorabot. This generation of Pandorabot can detect the user's language and query that language Wikipedia providing responses in the user's language. When properly configured Wikipedia queries that do not match an article will fallback on Wolfram Alpha and then AI chat thus providing you and your guests with instant access to the world's largest and most accurate repositories of information.

CONTENTS
This package contains one preconfigured Pandorabot from the Truth & Beauty Lab. It is ready for immediate use and should require no initial setup. However, each Pandorabot can be extensively customized. The instructions below provide simple steps to configure your own custom Pandorabot. Should you prefer, custom items are available from the Truth & Beauty Lab - simply contact missyrestless@gmail.com or IM Missy Restless inworld. The Truth & Beauty Lab provides a wide variety of intelligent scripted agents including a line of Smart Jewelry, Smart Accessories, various particle emitting displays, follow bots, and 3D animated avatar bots. All are available on the Second Life Marketplace at https://marketplace.secondlife.com/stores/44210

FEATURES
Truth & Beauty Lab Pandorabots contain the following features: Wikipedia & Wolfram Alpha query support including Unicode character display Detects user's language and queries that language Wikipedia Emits a variety of particle displays on command, sequentially, or random Scans the area for avatars and objects producing a detailed report Can target an avatar or object for particle beam Can locate an object or avatar by name (find hidden items!) Email you can use your Pandorabot to send email Greeter functionality so Pandorabots can detect and greet new arrivals Notecard and Landmark dispenser Highly configurable including ability to restrict responses based on name

Dialog menu configuration makes it easy to configure Configure which language Wikipedia to use Configurable as public (local chat) or private channel only low lag

GRAPHICAL DIALOG MENU CONFIGURATION

Although ready to use "out of the box", the Truth & Beauty Lab Pandorabot can be extensively configured. Simply left click the Pandorabot or say configure or menu in local chat and a dialog menu interface will be displayed. Most of the options you would want to customize are available in the dialog menu. Note that if you have configured a private Pandorabot chat channel then the menu and configure chat commands must be issued on that channel.

CHAT COMMANDS
The owner can chat the following commands to the Pandorabot. Note that if a private channel has been configured then the chat commands must be issued on that channel. The chat commands are: Command menu laser burst bubbles bling sparkle blue balls cycle hearts shamrocks clovers more less faster slower next prev default off avatars scan find <name> random lightning Action display the Pandorabot configuration & command dialog menu fire a laser beam from the Pandorabot emit a colorful burst of particles emit bubble particles turn on sparkly bling lights emit a shower of sparkles emit bursts of blue balls sequentially cycle through the particle displays and animations emit heart particles emit shamrock particles emit 4 leaf clover particles emit more particles emit fewer particles increase the frequency at which particles are emitted decrease the frequency at which particles are emitted go to the next particle display go to the previous particle display set the particle display parameters back to the defaults terminate the particle display scan the area for avatars scan the area for avatars and objects attempts to locate the named object or avatar randomly cycle through the particle displays and animations emit lightning particles

Wearable Pandorabots also include the following chat commands to control avatar animation: anims on anims off draw anim kick anim yoga sit yoga stand animate your avatar during particle displays disable avatar animation during particle displays start the double draw animation start the kick animation start the sitting yoga position animation start the standing yoga position animation

Commands are case insensitive. The chat commands are also available as buttons in

the Commands sub-menu of the dialog menu.

NOTECARD CONFIGURATION
Your Pandorabot is delivered with default settings suitable for most uses. 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.

NOTECARD, LANDMARK & USER GUIDE DELIVERY

When touched by a non-owner the Pandorabot can be configured to deliver a notecard, landmark, and the Pandorabots 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. Pandorabots can be configured to deliver a notecard, landmark, and additional documents via a dialog menu.

NAME CONFIGURATION
By default, the name of your Pandorabot is Ana Pandorabot. The NAME_ENABLED configuration variable is set to TRUE so the default behavior of your Pandorabot is to reply only to chat that contains either the first or last name (e.g. pandorabot, who is adam). 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 or replace the two name lines: FIRST_NAME = Buffy LAST_NAME = Smartbot This will change your Pandorabot's name to "Buffy Smartbot". Change Buffy and Smartbot 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.

WOLFRAM ALPHA APPLICATION ID

Wolfram Alpha requires an Application ID for queries made by another application. By default a shared demonstration Wolfram Alpha Application ID is used by all Pandorabots which have not been configured with a valid App ID. However, that ID is limited by Wolfram Alpha to 2000 queries per month. Register for a valid Wolfram

Alpha Application ID at http://products.wolframalpha.com/api/ and set ALPHA_APP_ID in the Configuration notecard to the ID your are provided. See the next section to see why it is important to register for a valid Wolfram Alpha Application ID.

PANDORABOT QUERY MODES

Your Pandorabot can be configured to respond in several modes. The response modes can be configured via the dialog menu but those settings will be restored to the defaults when the Pandorabot is reset or re-rezzed. To configure the default mode you can edit the Configuration notecard in the Pandorabot contents. The following Configuration notecard variables (with defaults) control the various response modes: WIKIPEDIA_ENABLED = TRUE If TRUE some responses will be generated from Wikipedia articles. If a relevant Wikipedia article cannot be found then the response will either be generated from Wolfram Alpha or customized AIML from pandorabots.com ALPHA_ENABLED = TRUE Controls whether the Pandorabot will query the Wolfram Alpha answer engine. If TRUE and ALPHA_APP_ID is set to a valid Wolfram Alpha Application ID then Wikipedia queries that do not find a matching article or which find a Wikipedia disambiguation page will fall back to Wolfram Alpha query. The combination of Wikipedia and Wolfram Alpha query provides a fairly robust degree of intelligence as these two services in combination cover just about every topic imaginable. AI_ENABLED = TRUE If TRUE some responses will be formed using AI from pandorabots.com. AUTO_DETECT = TRUE Controls whether the Pandorabot will attempt to detect the chat language and respond with that language Wikipedia summary. EMAIL_ENABLED = TRUE If TRUE you can use the bot to send email. See the EMAIL_TRIGGERS below. Set to FALSE if you don't want to allow people to use the bot to send email. OWNER_LISTEN_ONLY = FALSE Controls whether the Pandorabot will respond to other users or just the owner. The default mode, out of the box, is to allow email, respond to everyone, auto detect language, query Wikipedia, query Wolfram Alpha, use AI from pandorabots.com, fallback to AI on Wikipedia misses and fallback to AI on Wolfram Alpha misses. Once a valid ALPHA_APP_ID is configured then the Pandorabot will fallback to Wolfram Alpha on Wikipedia misses and AI on Wolfram Alpha misses.

CONFIGURATION NOTECARD SETTINGS

Default values for the following variables can be set by editing the Configuration notecard in the Pandorabot contents: 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 the Pandorabot will chat using AI from pandorabots.com. If FALSE the Pandorabot will still query Wikipedia and Wolfram Alpha as configured. NAME_ENABLED If FALSE the Pandorabot will attempt to respond to all local chat. If TRUE the Pandorabot will attempt to respond only to local chat containing either its first or last name. INVISIBLE If TRUE make the Pandorabot invisible ROTATE If TRUE the Pandorabot will rotate FIRST_NAME & LAST_NAME The name by which your Pandorabot will respond. If NAME_ENABLED is TRUE, the Pandorabot will only respond if either string is in the chat message (case insensitive). CHANNEL Setting this to a positive non-zero value that channel. In this mode the Pandorabot communication with the Pandorabot must be instance, if CHANNEL = 22, the Pandorabot e.g. /22 Who is Abraham Lincoln ? configures the Pandorabot to listen on becomes a private owner-only agent. All prefaced with the channel number. For will only respond to chat prefaced by /22

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 Pandorabot 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. ALPHA_ENABLED If TRUE queries beginning with one of the ALPHA_TRIGGERS below will trigger factual responses from Wolfram Alpha. ALPHA_APP_ID The Wolfram Alpha application ID to use. Register at http://products.wolframalpha.com/api/ to receive your AppID ALWAYS_WIKI If TRUE then Wikipedia will be queried even when no trigger phrase is matched. As in AI_ENABLED = FALSE above, this enables Wikipedia queries without the prefacing trigger phrase (e.g. simply chatting "Abraham Lincoln" will get the Wikipedia article on Abraham Lincoln). To always query Wikipedia and fall back on Wolfram Alpha then AI chat, set WIKIPEDIA_ENABLED = TRUE, ALPHA_ENABLED = TRUE, AI_ENABLED = TRUE and ALWAYS_WIKI = TRUE 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 it 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 nonEnglish 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 for Wikipedia. This list determines not only which language codes are used but the order in which the chat is searched for a trigger phrase (last in list to first in list). You can order this list by reverse "importance" of languages in your region. Note, if you modify the order of this list then you must also modify the LANG_NAMES setting below. You can also substitute a valid language code for one or more of these but then you must also modify the corresponding LANG_NAMES entry and ??_TRIGGERS list of trigger phrases in that language. For example, to replace Italian with Swedish you would change "it" in LANG_CODES to "sv", change "Italiano" in LANG_NAMES to "Svenska", and add the Swedish trigger phrases to IT_TRIGGERS. LANG_NAMES The list of names corresponding to the list of LANG_CODES. AUTO_DETECT Set this to TRUE in order to auto detect the language and query that language Wikipedia if present. Falls back to English if none found or FALSE. EN_TRIGGERS NL_TRIGGERS ES_TRIGGERS PT_TRIGGERS PL_TRIGGERS IT_TRIGGERS DE_TRIGGERS FR_TRIGGERS JA_TRIGGERS RU_TRIGGERS These are the various language Wikipedia trigger phrases. These phrases trigger a

Wikipedia query if WIKIPEDIA_ENABLED is TRUE. If you have set LANG_CODE above to something other than English (en) you may wish to set the Wikipedia trigger phrases to that language as well. Note that the Japanese and Russian lists of Wikipedia trigger phrases JA_TRIGGERS and RU_TRIGGERS are empty by default. If you have Multi-byte input support you can enter the Japanese or Russian trigger phrases. 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 NO_ENDING_NEEDED Whether the Wikipedia triggers specified in WIKIPEDIA_TRIGGERS need a ? or other ending character in order to match and trigger a Wikipedia query. Default is TRUE, no ending character is necessary. ALPHA_TRIGGERS If ALPHA_ENABLED is TRUE these phrases indicate the resident wishes to query Wolfram Alpha for a factual answer. The default Wolfram Alpha triggers are wolfram alpha, wolfram , and alpha . For example, to ask Wolfram Alpha for the cube root of 387 you could say wolfram what is the cube root of 387. EMAIL_TRIGGERS If EMAIL_ENABLED is TRUE these phrases indicate the resident wishes to send email. 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 (case-insensitive) in local chat. NOTE: The following configuration parameters are specific to the Happy Cloak and have no effect on other Pandorabots. INTERVAL The interval (in seconds) at which to change cloak texture. Set to 0.0 to disable cloak texture changes GROW Grow and shrink the cloak tentacles on each texture change REVERSE To reverse the direction of movement during tentacle growth TEXTURE The default texture to use on the cloak. Must be either the name of a texture in the Happy Cloak inventory or a valid texture uuid. When combined with a INTERVAL = 0.0 setting, this will be the unchanging texture of your cloak CLOAK_PRIMS The link numbers of the cloak prim - the prims to change textures on TENTACLE_PRIMS The link numbers of the two tentacles - the prims to grow and shrink on texture changes

GREETER CONFIGURATION
In addition to the Configuration notecard, your Pandorabot may include a Greeter with a Greeter_Config notecard that can be modified to customize the greeting provided new arrivals. NOTE: Not all Pandorabots include the Greeter. By default the Greeter is disabled. To enable the Greeter edit the Greeter_Config notecard and set GREET_ENABLED = TRUE and one or more of: GIVE_LANDMARK = TRUE GIVE_NOTECARD = TRUE GIVE_NAMED_NOTECARD = TRUE Default values for the following Greeter variables can be set by editing the Greeter_Config notecard in the Pandorabot contents: GREET_1 GREET_2 The greeting will be 'GREET_1 <name of avatar>! GREET_2'. 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. NOTE_NAME The name of the notecard to deliver to new arrivals. NOTE_NOTE The message to issue to new arrivals along with the named 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 recognized 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. GREET_ENABLED Should a greeting be issued to new arrivals via Instant Message default FALSE GIVE_LANDMARK Should new arrivals be given a landmark default FALSE GIVE_NOTECARD Should new arrivals be given a notecard default FALSE GIVE_NAMED_NOTECARD Should new arrivals be given the named notecard NOTE_NAME default FALSE

FOLLOWER CONFIGURATION
Some Pandorabots include a follow owner feature. Should you wish to change the default follow settings you can do so by editing the Follow_Config notecard. A complete list of user configurable parameters can be found in the Follow_Config notecard in the Pandorabot's Contents.

FOLLOW_CONFIG NOTECARD SETTINGS

Default values for the following variables can be set by editing the Follow_Config notecard in a Truth & Beauty Lab Pandorabot's contents: OFFSET = <2.0, 2.0, -0.75> The offset (in meters) from the target avatar as a vector <X, Y, Z> DYNAMIC_OFFSET = TRUE Whether to dynamically set the Z offset or use the default offset If you always want to use the value for OFFSET you set above then set this to FALSE. Otherwise the Z offset will be recalculated for each avatar. HERE_TIMER = 1.0 The interval (in seconds) to check on the owner's position when in sim GONE_TIMER = 30.0 The interval (in seconds) to check on the owner's position when not in sim This is also the interval used to sense and follow non-owner avatars FOLLOW = FALSE Follow owner on startup/reset FOLLOW_TARGET = owner Key of avatar/object to follow (default is owner). Setting must be a valid key LOOKAT = FALSE To look at nearest avatar when owner is gone, set to TRUE FOLLOW_OTHERS = TRUE To follow the nearest avatar when owner is gone, set to TRUE

RANGE = 20.0 The range at which avatars will be detected (in meters) PARCEL_ONLY = TRUE Try to limit the movement to the parcel MAX_FOLLOW = 128.0 Maximum distance (in meters) to follow in either X or Y direction USE_SOUND = FALSE Whether to play sounds on certain events FOUND_SOUND = 20126392-138f-0969-ec66-97f43dc2c99c Sound to use when an avatar is detected OWNER_LEDT_SOUND = 4d5e7a3f-8878-243c-8e68-ec6a60759a4e Sound to use when the owner leaves ENABLE_ROTATE = TRUE Can the Follower be rotated ? CHANGE_PHYSICS = FALSE Whether to change the physical status of the object to phantom when nobody is around then back to physical when following someone Note: if both of the following 2 are set to TRUE then they will be ignored. MAKE_PHYSICAL = FALSE Set the object's status to physical (makes it subject to gravity etc) MAKE_PHANTOM = FALSE Set the object's status to phantom (not subject to gravity etc) LASER_LINK = 1 Link number of the prim to be used as a laser CHECK_ON_REZ = FALSE Check for the owner within 20 meters when rezzing OFF_FRONT_LEFT = <-2.0, 2.0, -0.75> OFF_FRONT = <0.0, 2.0, -0.75> OFF_FRONT_RIGHT = <2.0, 2.0, -0.75> OFF_LEFT = <-2.0, 0.0, -0.75> OFF_ABOVE = <0.0, 0.0, 2.0> OFF_RIGHT = <2.0, 0.0, -0.75> OFF_BACK_LEFT = <-2.0, -2.0, -0.75> OFF_BACK = <0.0, -2.0, -0.75> OFF_BACK_RIGHT = <2.0, -2.0, -0.75> Offset presets for dialog menu offset selection

EYE CANDY NOTECARD SETTINGS

The single prim Eye Candy Scanning Follower can also be configured by editing the Eye_Candy_Config notecard in the Eye Candy object's Contents. Default values for the following variables can be set: The interval (in seconds) at which to change shape and texture INTERVAL = 120.0

The interval at which the object changes shape (in multiples of INTERVAL). A value of 0 disables shape and texture changes. MULTIPLE = 1 Should the prim rotate ? ROTATE = TRUE If you just want a small static box set this to TRUE. Setting this to TRUE also sets MULTIPLE above to 0 and SIZE below to small. SIMPLE = FALSE Some size defaults. This can be set to tiny, small, medium, large, XL, or XXL SIZE = large Whether to set the prim to flexible FLEXIBLE = FALSE

FURTHER INFORMATION
The Pandorabots Owner Manual, Pandorabots User Guide, the Truth & Beauty Lab Smart Dance Pole Manual, Truth & Beauty Lab Smart Tip Jar Manual, Pandorabot METAbolt Add-On Manual, Pandorabot METAbolt Diagram, and more are available in PDF and OpenOffice formats 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 View and interact with the Truth & Beauty Lab demonstration METAbolt integrated Pandorabot at http://slurl.com/secondlife/Gualdo/210/226/42/ . Follow me on Twitter at http://twitter.com/missyrestless Like Pandorabots on Facebook at http://on.fb.me/t3ItL3 Be my friend on Plurk at http://www.plurk.com/MissyR Have fun and email missyrestless@gmail.com with any questions, comments, suggestions, requests for custom configurations or AIML programming. View other Truth & Beauty Lab creations in the Second Life Marketplace at https://marketplace.secondlife.com/stores/44210