Dialog Manager Flow Elements

an entry point element has a one to one relationship to an intent whilst an entry point always occurs at the beginning of a flow, they can also occur at any point within a flow where a more explicit intent (typically containing entities) signifies and alternative entry into the flow an intent represents actions the user wants to perform the intent is a purpose or goal expressed in a user's input, such as reseting a password, applying for leave, or requesting access in sofi you define entry points that relate to an intent and then define the actions that must be taken for that intent the name of the entry point should be unique it should also be descriptive as is defines the intent of the action that a user wishes to perform for example, password reset request there are restricted characters when naming entry points (intents) entry point name field description name the name of the entry point for each entry point you will need to configure a list of typical utterances that could be used to access the entry point you can access the utterances by clicking the speak bubbles on the top left of the entry point element 211 you can also access the utterances for an entry point from the the nlu model > entry points menu option note entry points are essentially intents (however there are also other types of intents within sofi managing intents and entities 1026 to enter an utterance just start typing in the field at the top of the form pressing enter will create the utterance click on the three dots to edit or delete an utterance once you have defined an utterance, then, label the parts of the utterance that are relevant to your environment as entities an entity represents detailed information that is relevant in the utterance for example, in the utterance "reset my outlook password", "outlook" is an application by recognising and labeling the entities that are mentioned in the user’s utterance, sofi helps you choose the specific action to take to answer a user's request in summary, an intent is used to trigger an action and an entity is used as a parameter to execute an action to label an entity, select and open the intent (entry point) by selecting nlu model > intents to display the list of utterances labeling entities to label a single word, just click on the word and select the entity to label a phrase (two or more words), click on the first word and then click on the last word in the phrase to create a new entity, just enter a unique entity name into the search field on the entity list (from an utterance) and the add option will appear for more information on entities visit 1497 entity labelling topic elements are the work horse of the conversational interaction between the user and sofi they typically pose a question and take action based on the users response branches of topics are configured to wait for a natural language response (response intent) from a user they work in a similar way to entry points in that there is a mapping between an intent (of that branch) and the utterances that the user can enter 773 to reference details of the logged in user, use the following syntax {{user id}} {{user display name}} {{user first name}} {{user last name}} referencing user details within dialog flows field description general name name of element response the response provided by sofi hint optional provide hint to guide the user prompts similar to suggestions however prompts are typically short single words such as yes and no suggestions + (add suggestion) suggestions appear as selectable 'buttons' within the chat interface that a user can click to streamline interaction with sofi click + to create a suggestion for the user to select multiple suggestions can be created hint keep suggestions small no more that 3 4 words hint hitting enter after each suggestion will automatically create a branch for the suggestion branches + (add branch) a branch (intent) determines which path sofi should take depending on the user's response if using suggestions, branches are automatically created (remember to hit enter key when you add a new suggestion) you must press enter after entering a suggestion in order for sofi to automatically create a branch for that suggestion if you fail to do this try deleting the suggestion and adding it again alternatively manually create the branch remember to press enter (or tab) key when adding new suggestions branch utterances can be added by clicking on the 'speech bubbles' on the top left of the topic element additional utterances can be added for each branch if you need to manually create a branch for a suggestion, make sure that the name of the branch is the same as the name of the suggestion manually creating branches for suggestions an exit point indicates an end to a flow there can be multiple exit points within a flow field description name name of element response the response provided by sofi action choose the action to be performed upon exit close chat anything else? close delay the delay in seconds before the chat windows closes advanced clear conversation tracking field set to on if using a continuation point element in a flow and you wish to clear this field (on the target table) at the exit of the flow note only used for saa based (expert assist) flows conversation tracking field if using a continuation point element in a flow, this field should be the same as 'set conversation field name' value used on the continuation point element copy chat history to field on/off note only used for saa based (expert assist) flows chat history field name the name of the field on the target table to copy the chat / conversation history into a continuation point allows you to define a point in a conversation (flow) where you need the customer to 'go away' to perform some task with the expectation they will return to the flow at some later point the continuation point allows you to define the point in the flow the user will return to when they return to this active conversation by default, (if you do not connect the output branch), the flow will return to the element immediately prior to to the continuation point alternatively, you can connect the output of the continuation point to any other element to define the point whether the conversation will continue field description name name of element response the response provided by sofi action the action to be performed upon exit close chat close delay the delay in seconds before the chat windows closes set conversation field name the field on the active servicenow form that the conversation id is copied into this field is used by servicenow to track and reopen the conversation (via a ui action / script) servicenow tracks and initiates an active conversation by recording the conversation id of a flow on a target servicenow form (eg incident form) for example you may create a new field on the task / incident table called u sofi conversation, then use the set conversation field name parameter above to copy the conversation id to this field a ui action can then be created on the servicenow to 'continue' the conversation at some point the example ui action below creates a ui action form button to trigger the continuation of a flow you can use this to test the continuation of a flow you can then create an onload script to perform this based on your requirements javascript function dosoficonversationcheck() { 	var conversationid = g form getvalue("u sofi conversation"); 	if (conversationid != "") { 	 saa continueconversation(g form getvalue("u sofi conversation"), { force true }); 	} } at present this conversation persistence is only supported on flows used with the service agent assistant chat interface (expert assist) only supported on expert assist (virtual agent on service agent assistant) refer here for information on subflows are flows referenced by the current flow to perform specific actions and return results to the current flow if a subflow exit is used within the subflow, the conversation will return to the previous flow upon reaching that subflow exit if an exit point element is used within the subflow, the conversation will end within the subflow at that point field description name name of the element description description of the subflow subflow id read only field that identifies the id of the selected subflow that this element calls dialog flow selector icon on top of the element used to select the flow an exit subflow, exits a subflow (a flow called from another flow) and returns the conversation to the previous (calling) flow field description name name of element