{"id":17950,"date":"2016-12-06T20:15:09","date_gmt":"2016-12-06T20:15:09","guid":{"rendered":"https:\/\/developer.kore.com\/?post_type=docs&p=9146"},"modified":"2022-10-05T11:59:22","modified_gmt":"2022-10-05T10:59:22","slug":"using-the-dialog-builder-tool","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v9-3\/docs\/bots\/chatbot-overview\/using-the-dialog-builder-tool\/","title":{"rendered":"Using the Dialog Builder"},"content":{"rendered":"

The Dialog Builder is where you can create your Dialog Tasks, from end-to-end. This is an in-depth article on how to use this tool.<\/span><\/p>\n

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

Create a Dialog Task<\/span><\/span><\/h1>\n

To create a dialog task, you must have already created an assistant to add a dialog task to. See <\/span>Create Your First Assistant<\/span><\/a> for more information.<\/span><\/p>\n

To add a dialog task, follow the steps below:<\/span><\/p>\n

    \n
  1. Open the assistant for which you want to create the dialog task.<\/span><\/li>\n
  2. Select the <\/span>Build<\/strong> tab from the top menu.<\/span><\/li>\n
  3. From the left menu, click <\/span>Conversational Skills > Dialog Tasks<\/strong>.<\/span><\/li>\n
  4. On the Dialog Tasks page, click the <\/span>Create Dialog<\/strong> button.<\/span><\/li>\n

    \"\"<\/a><\/p>\n

  5. The Dialog Builder now displays the root intent component.<\/span><\/li>\n
  6. Enter a name for the dialog task in the <\/span>Intent Name<\/strong> field. As the field label states, the name should reflect the user intent you want to achieve with this Dialog Task. Optionally, you can add a <\/span>description<\/strong>.<\/span><\/li>\n
  7. You can add user utterances that should trigger this intent, using the <\/span>Intent Training <\/strong>field<\/span>.<\/strong> You may add this data later, from the user intent node that is generated within this task.<\/span><\/li>\n
  8. Set additional options<\/strong>\n
      \n
    1. Set the task to be independent or a <\/span>sub-intent dialog.<\/strong><\/li>\n
    2. Hide from help<\/strong> requests by the user.<\/span><\/li>\n
    3. Specify the context tags as <\/span>intent preconditions <\/strong>– this will ensure that the intent would be detected only when the context tag is present.<\/span><\/li>\n
    4. Set the <\/span>Context Output<\/strong> and define the context tags to set when this intent is initiated.<\/span><\/li>\n
    5. If you are using the legacy Dialog Builder please select <\/span>Create Using the New Conversation Driven Dialog Builder<\/strong> which was introduced in ve r9.0 of the Platform. This is the default setting and recommended. If you do not select this option, you will be prompted to <\/span>Upgrade<\/strong> whenever you open the dialog task.<\/span><\/li>\n<\/ol>\n<\/li>\n
    6. Click Proceed<\/strong>.<\/span><\/li>\n

      \"\"<\/a><\/p>\n

      Now, you are ready to add nodes and establish transitions between these nodes for your workflow. <\/span>Click here to know about Nodes & Connections<\/span><\/a>.<\/span><\/p>\n

      \"\"<\/a><\/p>\n

      But before moving on, here is an overview of the Dialog Task Builder. For details, please see <\/span>Navigating the Dialog Task Builder<\/span><\/a>. <\/span><\/p>\n

      \"\"<\/a>
      \n

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

      Add Nodes<\/span><\/span><\/h2>\n

      There are three ways to add a node:<\/span><\/p>\n

        \n
      1. Using the conversation-first approach, <\/span>refer here for details<\/span><\/a>.<\/span><\/li>\n
      2. Drag and drop nodes from the panel onto the dialog builder, see below<\/a>.<\/span><\/li>\n
      3. Using the options from the Dialog Builder Canvas, see below<\/a>.<\/span><\/li>\n<\/ol>\n

        In this article, we will be working with drag and drop, and the Dialog Builder Canvas. For details about the conversation-first approach, please read about the Conversation-Designer<\/a><\/span><\/p>\n

        Use Drag and Drop<\/span><\/span><\/h3>\n

        You can add nodes within the dialog task, by dragging the node from the panel on the left to the designated place in the dialog task, on the canvas. <\/span><\/p>\n

        You can also drag and drop a node from the side panel on the left in-between two existing nodes. A connector comes up on hovering over the connecting line, and you can drop your new node on it. <\/span><\/p>\n

        \"\"<\/a><\/p>\n

        Use the Dialog Canvas<\/span><\/span><\/h3>\n

        Use the “<\/span>+’<\/strong> button next to the node under which you want to add another node. You can either add a new node or connect an existing node. This existing node can be either from the current task or from a different one.<\/span><\/p>\n

        \"\"<\/a><\/p>\n

        You can use the <\/span>Add Node<\/strong> button visible on hover over the connector line, to add nodes between two existing nodes. You can create a new node or pick from the existing node list.<\/span><\/p>\n

        \"\"<\/a><\/p>\n

        Add If-Else Node Connections<\/span><\/span><\/h3>\n

        To add <\/span>If-Else<\/strong> connection conditions, hover over the node and click the blue “+” button on the bottom. <\/span>Learn more<\/span><\/a>.<\/span><\/p>\n

        \"\"<\/a>
        \n

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

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

        Clicking on a node will open its Properties panel, which includes specific features, depending on the type of node you are working with. Please consult the documentation on <\/span>Node Types<\/span><\/a> to learn more about what is included with each. So, noting that some nodes may not come with some features, here is a general overview of what is available within this panel: <\/span><\/p>\n