Updating configuration files
To configure Program D to use Artificial Intelligence Markup Language (AIML), you must update the following files in the C:\Program Files\BMC Software\BMCVirtualAgent\VirualAgentComponents\var\programd\conf folder on the Mid Tier server:
Open each file in a text editor, such as Notepad, edit the content as explained in the following sections, and save the files.
bots.xml
The bots.xml file contains the location of the AIML files for which Program D must watch. By default, bots.xml specifies that all AIML and XML files in the aiml folder (under the programd folder) be watched.
Specify the location and names of the files in the <learn> element, as shown in the following example:
<learn>../aiml/.xml</learn>
<learn>../aiml/.aiml</learn>
core.xml
The core.xml file contains the option to watch for changes (true or false) and specifies the frequency (in milliseconds) to check for changes.
Set these options in the <entry> element, as shown in the following example:
<entry key="programd.use-watcher">true</entry>
<entry key="programd.watcher.timer">2000</entry>
properties.xml
The properties.xml file contains the knowledge base server value. If the server value is not specified in this file, links to knowledge articles can be broken if the knowledge base server changes.
Specify the knowledge base server in the <entry> element, as shown in the following example:
<entry name="kbpath">[http://mykbpath]</entry>
substitutions.xml
The substitutions.xml file contains normalized data that assists in interpreting user input. When you use the substitutions file, you can reduce the number of AIML responses and thereby increase accuracy.
For example, if your AIML content says I cannot get to the internet and a user searches on I can't get to the internet, the AIML content is found only if an entry exists in the substitutions.xml file.
The substitutions file can contain the following information:
- Synonyms for common words
- Abbreviations that are spelled out to prevent sentence splitting (Mr. to mister)
- File name extensions separated from their file name (.zip to zip)
BMC Virtual Agent supplies a default substitutions.xml file that you can customize for your environment. Open the default substitutions.xml file (in the C:\Program Files\BMC Software\BMCVirtualAgent\VirualAgentComponents\var\programd\conf folder) and modify it to suit your needs.
The following sample code shows an excerpt of the default substitutions.xml file:
<!--
Substitutions are grouped according to several AIML interpreter functions.
-->
<substitutions xmlns="http://aitools.org/programd/4.6/bot-configuration" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://aitools.org/programd/4.6/bot-configuration http://aitools.org/programd/4.6/bot-configuration.xsd">
<!--
Input substitutions correct spelling mistakes and convert "sentence"-ending characters into characters that will not be identified as sentence enders.
-->
<input>
<substitute find="=reply" replace="" />
<substitute find="name=reset" replace="" />
<substitute find=":\-\)" replace="smile" />
<substitute find=":\)" replace="smile" />
<substitute find=",\)" replace="smile" />
<substitute find=";-\)" replace="smile" />
<substitute find=">" replace="gt" />
<substitute find="<" replace="lt" />
<substitute find="\byuo\b" replace="you" />
<substitute find="\bwanna\b" replace="want to" />
<substitute find="\byou'd\b" replace="you would" />
<substitute find="\byou're\b" replace="you are" />
<substitute find="\byou re\b" replace="you are" />
<substitute find="\byou've\b" replace="you have" />
<substitute find="\byou ve\b" replace="you have" />
<substitute find="\byou'll\b" replace="you will" />
<substitute find="\byou ll\b" replace="you will" />
</input>
</substitutions>