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
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
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.
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.
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.
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.
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
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