Extends

• ArchBaseCoreObject

Members

static, readonly displayTypeName :string

Returns the display type name string 'ArchSettingsNluKnowledge'.

readonly isArchBaseCoreObject :boolean

Returns true indicating that this is an ArchBaseCoreObject instance.

Overrides:

• ArchBaseCoreObject#isArchBaseCoreObject

readonly isArchSettingsNluKnowledge :boolean

Returns true indicating that this is an ArchSettingsNluKnowledge instance.

readonly knowledgeBaseId :string

Returns the knowledge base id if there is one set on this ArchActionSettingsNluKnowledge instance. If there is not one set, nothing is returned.

readonly knowledgeBaseName :string

Returns the knowledge base name if there is one set on this ArchActionSettingsNluKnowledge instance. If there is not one set, nothing is returned.

readonly knowledgeConfirmation :ArchValueCommunication

Wording the bot will use after playing back one or more knowledge base answers. For example, 'Does this answer your question?'

readonly knowledgeInitialResponseFollowup :ArchValueCommunication

Follow-up wording the bot will use after presenting a knowledge article. For example, 'I hope I answered your question. You can ask anything else you might want to know.' This property maps to the Answer Follow-up setting you would see in the Knowledge settings within a Digital Bot Flow. What you want to do here is have the participant ask their next question as a result of this wording.

readonly knowledgeInitialResponseMulti :ArchValueCommunication

Wording the bot will use to introduce a numbered list of matching Knowledge answers, in the case where multiple good matches are found in the Knowledge Base. For example, 'This is what I found'

readonly knowledgeInitialResponseMultiRetry :ArchValueCommunication

Wording the bot will use to re-introduce a numbered list of matching Knowledge answers, in the case where the user's first attempt to choose a number was unsuccessful. For example, 'I didn't understand that. Please pick one of the following:'

readonly knowledgeInitialResponseSingle :ArchValueCommunication

Wording the bot will use prior to playing back a single knowledge base answer. For example, 'This is what I found'

readonly knowledgeNoMatch :ArchValueCommunication

Wording the bot will use to represent the 'no match' option. For example, 'None of the above'

readonly logStr :string

A string suitable for logging that contains information about this action. This will contain the action tracking id, name and scripting type name.

Overrides:

• ArchBaseCoreObject#logStr

readonly logStrTypeOnly :string

This is a string suitable for logging information about this object where it's just the object's type. This is normally used when logging errors that occur in constructor parameter checking because the scripting object isn't set up and the normal logging str contents wouldn't be set up.

Overrides:

• ArchBaseCoreObject#logStrTypeOnly

readonly maxNumOfAnswersReturned :ArchValueInteger

The maximum number of knowledge base answers to be returned by the bot from the selected knowledge base.

readonly responseBias :ArchValueString

The bias the bot should use when interpreting participant input to prefer knowledge base answers, other natural language understanding settings such as intents, or weight input equally. The string values in ArchEnums#NLU_RESPONSE_BIAS_MODES lists valid values.

readonly sendKnowledgeFeedback :ArchValueBoolean

A boolean value which, if it evaluates to true, will send knowledge confirmation feedback to the knowledge service which will be used to improve the performance of your knowledge base.

readonly welcomeArticleId :string

Returns the knowledge base welcome article id if there is one set on this ArchActionSettingsNluKnowledge instance. If there is not one set, nothing is returned.

readonly welcomeArticleName :string

Returns the knowledge base welcome article name if there is one set on this ArchActionSettingsNluKnowledge instance. If there is not one set, nothing is returned.

Methods

isFilterMatch(archFilterObject) → {boolean}

Returns whether or not this Architect Scripting object is a match for the supplied ArchFilterObject instance.

Parameters:

Name	Type	Description
archFilterObject	ArchFilterObject	the object filter to use to determine if it's a match.

Returns:

boolean

Overrides:

• ArchBaseCoreObject#isFilterMatch

logError(errorStr)

Logs an error to the logging service with a log header from this object's logStr property value when ArchLogging#logErrors is true.

Parameters:

Name	Type	Description
errorStr	string	the error string to log.

Overrides:

• ArchBaseCoreObject#logError

logErrorAndThrow(errorStr)

Logs an error to the logging service with a log header from this object's logStr property value when ArchLogging#logErrors is true and then throws the string in the errorStr parameter.

Parameters:

Name	Type	Description
errorStr	string	the error string to log. This should be a non-blank string.

Throws:

• Throws the submitted error string.

Overrides:

• ArchBaseCoreObject#logErrorAndThrow

logNote(noteStr)

Logs a note to the logging service with a log header from this object's logStr property value when ArchLogging#logNotes is true.

Parameters:

Name	Type	Description
noteStr	string	the note string to log. This should be a non-blank string.

Overrides:

• ArchBaseCoreObject#logNote

logNoteVerbose(noteStr)

Logs a note to the logging service with a log header from this object's logStr property value when ArchLogging#logNotesVerbose is true.

Parameters:

Name	Type	Description
noteStr	string	the note string to log. This should be a non-blank string.

Overrides:

• ArchBaseCoreObject#logNoteVerbose

logWarning(warningStr)

Logs a warning to the logging service with a log header from this object's logStr property value when ArchLogging#logWarnings is true.

Parameters:

Name	Type	Description
warningStr	string	the warning string to log. This should be a non-blank string.

Overrides:

• ArchBaseCoreObject#logWarning

setKnowledgeBaseByIdAsync(knowledgeBaseId, callbackFunctionopt) → {Promise.<ArchSettingsNluKnowledge>}

This sets the knowledge base that will be used for use at runtime by the knowledge base id.

Parameters:

Name	Type	Attributes	Description
knowledgeBaseId	string		the id of the Knowledge Base to set.
callbackFunction	function	<optional>	a callback function to call if the Knowledge Base is successfully looked up and configured on this action. The first parameter passed to the callback function will be this Architect NLU Knowledge Settings instance.

Returns:

Promise.<ArchSettingsNluKnowledge>

setKnowledgeBaseByNameAsync(knowledgeBaseName, callbackFunctionopt) → {Promise.<ArchSettingsNluKnowledge>}

This sets the knowledge base that will be used for use at runtime by the knowledge base name.

Parameters:

Name	Type	Attributes	Description
knowledgeBaseName	string		the name of the Knowledge Base to set. Knowledge Base names are looked up case insensitively.
callbackFunction	function	<optional>	a callback function to call if the Knowledge Base is successfully looked up and configured on this action. The first parameter passed to the callback function will be this Architect NLU Knowledge Settings instance.

Returns:

Promise.<ArchSettingsNluKnowledge>

setWelcomeArticleByIdAsync(knowledgeBaseDocumentId, callbackFunctionopt) → {Promise.<ArchSettingsNluKnowledge>}

This sets the welcome article that will be used by the bot at runtime by the knowledge base document's identifier. Remember that prior to setting a knowledge base document as the welcome article that the knowledge base must be configured since this search operation will look up a document by id within that knowledge base.

Parameters:

Name	Type	Attributes	Description
knowledgeBaseDocumentId	string		the id of the Knowledge Base document to set.
callbackFunction	function	<optional>	a callback function to call if the Knowledge Base Article is successfully looked up and configured on this action. The first parameter passed to the callback function will be this Architect NLU Knowledge Settings instance.

Returns:

Promise.<ArchSettingsNluKnowledge>

See:

• ArchSettingsNluKnowledge#setKnowledgeBaseByIdAsync
• ArchSettingsNluKnowledge#setKnowledgeBaseByNameAsync

setWelcomeArticleByNameAsync(knowledgeBaseDocumentName, callbackFunctionopt) → {Promise.<any>}

This sets the welcome article that will be used by the bot at runtime by the knowledge base document's name. Remember that prior to setting a knowledge base document as the welcome article that the knowledge base must be configured since this search operation will look up a document by name within that knowledge base.

Parameters:

Name	Type	Attributes	Description
knowledgeBaseDocumentName	string		the name of the Knowledge Base document to set as the welcome article. Knowledge Base document names are looked up case insensitively.
callbackFunction	function	<optional>	a callback function to call if the Knowledge Base Article is successfully looked up and configured on this action. The first parameter passed to the callback function will be this Architect NLU Knowledge Settings instance.

Returns:

Promise.<any>

See:

• ArchSettingsNluKnowledge#setKnowledgeBaseByIdAsync
• ArchSettingsNluKnowledge#setKnowledgeBaseByNameAsync

traverse(callbackFunction, traverseFilteropt) → {number}

This method iterates over this object and ArchBaseCoreObject instances within it. For each object it will call the ArchBaseObject#isFilterMatch method with a filter and call the supplied callback function if isMatch returns true. The callback will be passed an ArchTraverseInfo with details about the match such as the match object itself along with current contextual information such as the object hierarchy for the match object relative to the object on which this traverse call is being made.

The traverse filter is one which you can create by calling ArchFactoryFilters#createFilterObject and then add desired clauses or clause containers to it. If not specified, this function will use a default filter.

Here is an example that does a simple flow traversal using the default filter and logs information about objects in the callback from the traverse object that's passed back:

archInboundCallFlow.traverse(function(traverseInfo) {
   archLogging.logNote('  Object     : ' + traverseInfo.matchObject.logStr);
   archLogging.logNote('    Hierarchy: ' + traverseInfo.context.hierarchyStr);
});

This might be enough for most uses and you can check various aspects about the object in the callback such as "is this an Architect action?" by seeing if traverseInfo.matchObject.isArchBaseAction is true. You can specify a filter for the traversal code to use as well and only have it call your callback when the object's ArchBaseCoreObject#isFilterMatch method returns true for the filter. Here's an example that creates a filter for callbacks on any type of transfer action, any decision action or objects whose name property case insensitively matches the word 'foo'. While this could all be done with one property callback clause the example will use multiple clauses for the sake of simplicity:

const myTraverseFilter = filterFactory.createFilterObject(archEnums.FILTER_CONTAINER_OPERATORS.or);
myTraverseFilter.addClausePropertyValueEquals('isArchBaseActionTransfer', true);
myTraverseFilter.addClausePropertyValueEquals('isArchActionDecision',     true);
myTraverseFilter.addClausePropertyCallback('name', function(propValue, archContainingObject, propName) {
      // We fully spelled out the function signature above but archContainingObject and propName are
      // not needed in this case.  The archContainingObject is the object that contains the
      // property and propName is the property name itself.  We pass in propName because the same
      // function could be used for multiple property callback clauses.
      // Remember to return a boolean true, false or undefined from ths callback.  :)
      return propValue && propValue.toLowerCase() === 'foo';
});
archTask.traverse(function(traverseContext) {
   // You will only be called back here for ArchBaseCoreObject instances that
   // have the isArchBaseActionTransfer or isArchActionDecision property values equal to true.
}, myTraverseFilter);

If you supply a filter with no clauses, this tells the traverse method to call the supplied callback function for every ArchBaseCoreObject it traverses.

If you want traversal itself to stop after a callback, simply return boolean false from the callback function you supply to the traverse call.

The traverse method does not process deprecated property names such as orgId, orgName or languageSettings. Additionally it does not traverse in to properties that would "jump out" of the current traversal. An example of this would be if the code was traversing an ArchActionJumpToMenu action that it would not start traversing in to the menu that it jumps to. Another example would be a ArchActionChangeState action where it would not traverse in to the target state of the action. This also means traversal does not traverse in to the ArchBaseValue#flowLevelDefault property.

And lastly, as Scripting evolves over time with new versions, you can expect to get callbacks for new object types such as new actions or new properties on objects. As such, it's important not to assume any particular order in callbacks to keep code most compatible with traversal callbacks. Or if you use inequality checks in filter clauses remember that new "stuff" may satisfy an inequality check which may or may not be anticipated in your logic.

Note: This traverse method is a helper method and is very handy for iterating over Architect Scripting objects and their properties in a generic fashion with filtering capabilities. Obviously you can write your own custom traversal code if this implementation doesn't cut it for some reason. :)

This function returns the number of times it called the callback function.

Parameters:

Name	Type	Attributes	Default	Description
callbackFunction	callbackTraverseInfo			the callback function to call for objects that match the traverse filter.
traverseFilter	ArchFilterObject	<optional>	ArchFactoryFilters#createFilterTraverseDefault	the filter to use when performing the traversal to determine which ArchBaseCoreObject instances you wish to be called back for. If no filter is specified, this function will call ArchFactoryFilters#createFilterTraverseDefault and use that traversal default filter. The wantArchBaseValues parameter on that call is set to true.

Returns:

number

Overrides:

• ArchBaseCoreObject#traverse