{"id":19983,"date":"2019-05-03T10:33:24","date_gmt":"2019-05-03T10:33:24","guid":{"rendered":"https:\/\/developer.kore.ai\/v9-3\/?p=19983"},"modified":"2022-09-22T14:39:46","modified_gmt":"2022-09-22T13:39:46","slug":"working-with-the-user-intent-node","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v9-3\/docs\/bots\/bot-builder-tool\/dialog-task\/working-with-the-user-intent-node\/","title":{"rendered":"User Intent Node"},"content":{"rendered":"
\r\n\t
\r\n\t\t
\r\n\t\t\t

As a bot developer, you typically create a task to resolve one primary user intent. Yet, user conversations can branch into related intents (follow-up or sub-intents) as a part of the primary intent.<\/span><\/p>\n

Let us take a look into this sample conversation for a flight booking assistant:<\/span><\/p>\n

VA: Hi, how may I help you today? <\/span><\/em>
User: Hey, what flight options have I got from LA to NYC? <\/span><\/em>
VA: Sure, let me know the travel date. <\/em><\/span>
User: Wait a minute, will it rain in NYC this Sunday?<\/em><\/span><\/p>\n

The primary intent of this conversation is to book a flight ticket. But the user wants to know the weather forecast before completing the booking, which is a valid use case.<\/span><\/p>\n

User Intent Nodes help you add a root intent, a follow-up or sub-intents to your dialog tasks. The flow for a follow-up intent is built within the same dialog task using transitions, and cannot be linked to external tasks. When the execution of a follow-up intent is completed, the conversation flow continues within the same dialog tasks based on the transitions you add.<\/span><\/p>\n\n\n\n
\n

Note<\/em><\/strong>: To start a new Dialog Task from an existing one, you can use the Dialog Task nodes.<\/span><\/em><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Setting up a user intent node in a dialog task involves the following steps:<\/span><\/p>\n

<\/div><\/div>\n

Add the Node<\/span><\/span><\/h1>\n
    \n
  1. Open the dialog task to which you want to add the user intent node.<\/span><\/li>\n
  2. Add a user intent node in the designated place. For steps on adding nodes, <\/span>please read more here<\/span><\/a>.<\/span><\/li>\n
  3. The user intent window is displayed with the <\/span>Component Properties<\/strong> tab selected by default.<\/span><\/li>\n<\/ol>\n

    \"\"<\/a>
    \n

    <\/div><\/div>\n

    Configure the Node<\/span><\/span><\/h1>\n
    <\/div><\/div>\n

    Component Properties<\/span><\/span><\/h2>\n\n\n\n
    \n

    Note<\/em><\/strong>: The configurations you set up or edit in the Component Properties tab reflects in all the dialog tasks that use this node. These settings are the same for Intent and Sub-intent nodes.<\/span><\/em><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

     <\/p>\n

      \n
    1. On the <\/span>Component Properties <\/strong>tab, under the <\/span>General Settings<\/strong>, you can modify<\/span><\/li>\n
        \n
      1. The <\/span>Name<\/strong>,<\/span><\/li>\n
      2. The <\/span>Display Name<\/strong>,<\/span><\/li>\n
      3. The <\/span>Description<\/strong>.<\/span><\/li>\n<\/ol>\n<\/ol>\n

        \"\"<\/a>
        \n

        <\/div><\/div>\n

        Instance Properties<\/span><\/span><\/h2>\n

        Under the Instance Properties tab, you can configure the instance specific fields for the selected intent node. These settings are applicable only if you are connecting an existing intent node and only for the selected node instance, and will not affect other dialog tasks that may invoke the node you are working with. <\/span><\/p>\n

        You can add tags to build custom profiles of your VA’s conversations. You can define a key and a value for each of the following:<\/span><\/p>\n

          \n
        1. Message – Define custom tags to be added to the current message in the conversation.<\/span><\/li>\n
        2. User – Define custom tags to be added to the user’s profile information.<\/span><\/li>\n
        3. Session – Define custom tags to be added to the current conversation session.<\/span><\/li>\n<\/ol>\n

          Here is an example of a dialog task that is connected as a subintent in a more complex one.<\/span><\/p>\n

          \"\"<\/a>
          \n

          <\/div><\/div>\n

          NLP Properties<\/span><\/span><\/h2>\n
            \n
          1. From the <\/span>NLP Properties <\/strong>tab, you can configure the following:<\/span><\/li>\n
              \n
            1. Machine Learning<\/span><\/a> settings to provide user utterances to improve the detection for this intent.<\/span><\/li>\n
            2. Patterns & Rules<\/span><\/a> to capture this intent if the user’s utterance contains these specific patterns.<\/span><\/li>\n
            3. Bot Synonyms<\/span><\/a> or related phrases for this user intent.<\/span><\/li>\n
            4. Manage Context<\/span><\/a> to control the flow of the conversation: <\/span><\/li>\n
                \n
              1. Set Intent Preconditions: <\/span>The intent will be detected only if any of the context tags specified as pre-conditions are available in the context at the time of intent detection.<\/span><\/li>\n
              2. Configure Context Output: <\/span>Define the tags to be set in the context when this intent is initiated. Intent name is automatically set as output context by the system.<\/span><\/li>\n<\/ol>\n<\/ol>\n<\/ol>\n

                \"\"<\/a>
                \n

                <\/div><\/div>\n

                Connections Properties<\/span><\/span><\/h2>\n

                Click the <\/span>Connections <\/strong>tab and set the transition properties to determine the node in the dialog task to execute next. <\/span><\/p>\n

                Primary Intent nodes only allow you to select the next node to trigger.<\/span><\/p>\n

                If the Intent node you are working with does not represent the primary intent within the dialog task (if it follows another node), you can write conditional statements based on the values of any Entity or Context Objects in the dialog task, or you can use intents for transitions. For details on how to work with connection conditions, please see <\/span>Adding IF-Else Conditions to Node Connections. <\/span><\/a><\/p>\n\n\n\n
                \n

                Note<\/em><\/strong>: These conditions are applicable only for this instance and will not affect this node when being used in any other dialog.<\/span><\/em><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                \"\"<\/a><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n

                <\/div><\/div>[vc_raw_html]JTNDZGl2JTIwY2xhc3MlM0QlMjJ3LXBvc3QtZWxtJTIwcG9zdF9uYXZpZ2F0aW9uJTIwbGF5b3V0X3NpbXBsZSUyMGludl9mYWxzZSUyMiUzRSUwQSUwOSUzQ2ElMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtJTIwb3JkZXJfZmlyc3QlMjB0b19wcmV2JTIyJTIwaHJlZiUzRCUyMiUyRmRvY3MlMkZib3RzJTJGYm90LWJ1aWxkZXItdG9vbCUyRmRpYWxvZy10YXNrJTJGZGlhbG9nLXRhc2tzJTJGJTIyJTNFJTNDJTJGcCUzRSUwQSUzQ2RpdiUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0tYXJyb3clMjIlM0UlM0MlMkZkaXYlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLW1ldGElMjIlM0VQcmV2aW91cyUzQyUyRmRpdiUzRSUwQSUzQ2RpdiUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0tdGl0bGUlMjIlM0UlM0NzcGFuJTNFRGlhbG9nJTIwVGFzayUzQyUyRnNwYW4lM0UlM0MlMkZkaXYlM0UlMEElM0NwJTNFJTNDJTJGYSUzRSUzQ2JyJTIwJTJGJTNFJTBBJTNDYSUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0lMjBvcmRlcl9zZWNvbmQlMjB0b19uZXh0JTIyJTIwaHJlZiUzRCUyMiUyRmRvY3MlMkZib3RzJTJGYm90LWJ1aWxkZXItdG9vbCUyRmRpYWxvZy10YXNrJTJGd29ya2luZy13aXRoLXRoZS1kaWFsb2ctbm9kZSUyRiUyMiUzRSUzQyUyRnAlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLWFycm93JTIyJTNFJTNDJTJGZGl2JTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS1tZXRhJTIyJTNFTmV4dCUzQyUyRmRpdiUzRSUwQSUzQ2RpdiUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0tdGl0bGUlMjIlM0UlM0NzcGFuJTNFRGlhbG9nJTIwTm9kZSUzQyUyRnNwYW4lM0UlM0MlMkZkaXYlM0UlMEElM0NwJTNFJTNDJTJGYSUzRSUzQyUyRmRpdiUzRQ==[\/vc_raw_html]
                <\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"As a bot developer, you typically create a task to resolve one primary user intent. Yet, user conversations can branch into related intents (follow-up or sub-intents) as a part of the primary intent. Let us take a look into this sample conversation for a flight booking assistant: VA: Hi, how may I help you today?...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[29],"tags":[],"class_list":["post-19983","post","type-post","status-publish","format-standard","hentry","category-dialog-task"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/19983","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/comments?post=19983"}],"version-history":[{"count":27,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/19983\/revisions"}],"predecessor-version":[{"id":45278,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/19983\/revisions\/45278"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/media?parent=19983"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/categories?post=19983"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/tags?post=19983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}