{"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":"2023-03-20T08:46:20","modified_gmt":"2023-03-20T08:46:20","slug":"using-the-dialog-builder-tool","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/chatbot-overview\/using-the-dialog-builder-tool\/","title":{"rendered":"Using the Dialog Builder"},"content":{"rendered":"
<\/div>\r\n\t
\r\n\t\t
\r\n\t\t\t

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

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>    \"\"<\/a><\/li>\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. If you have not configured any integration for your virtual assistant, you will see the Explore Integrations<\/strong> option. Once you click this option, you will be redirected to the <\/span>Actions <\/strong>page to configure an integration for your VA. For more information, see <\/span>Actions Overview<\/span><\/a>.<\/span>\n
      \n
    1. Click and expand More Options<\/strong> to set additional options for Intent Settings<\/em>, Analytics – Containment Type<\/em> and Conversation Context<\/em>.<\/li>\n
    2. 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>        \"\"<\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
          \n
        1. <\/li>\n<\/ol>\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

          Auto-Generated Dialog Tasks <\/span><\/span><\/h2>\n

          Introduction<\/span><\/span><\/h3>\n

          This feature auto-generates dialog flows using the VA’s purpose and intent description provided during task creation. The Platform uses LLM and generative AI to create suitable Dialog Tasks for Conversation Design, Logic Building, and Training by including the required nodes in the flow. This helps simplify and shorten the development process and suggests possible pathways that developers might not think otherwise.<\/span><\/p>\n

          To enable this feature, you must turn on <\/span>LLM and Generative AI<\/strong><\/a>, and <\/span>Automatic Dialog Task Generation <\/strong>under <\/span>Buld > Natural Language > Advanced NLU Settings<\/strong>.<\/span><\/p>\n

          The nodes and the flow for the Business Logic are automatically built for your conversation, and you only need to configure the flow transition.<\/span><\/p>\n

          The Platform auto-defines the <\/span>Entities, Prompts, Error Prompts, Bot Action nodes, Service Tasks, Request Definition<\/span><\/em>, and other parameters.<\/span><\/p>\n

          Auto-Generate Dialog Tasks <\/span><\/span><\/h3>\n

          If you have enabled LM and Generative AI features and Automatic Dialog Task Generation, you will see a <\/span>Conversation Preview<\/strong> window right after creating your Dialog Task.<\/span> In this window, you can create mock conversations and convert them into dialog flows for every intent. <\/span><\/p>\n

            \n
          1. Start by adding a meaningful description that states the purpose of the Dialog Task and provides example intents.<\/span><\/li>\n
          2. Click <\/span>Generate <\/strong>when ready.
            \"\"<\/a>
            <\/span><\/li>\n
          3. Wait a few moments until the Platform generates dialog flows for your specified intents. When done, you see a mock conversation based on which dialog flows will be generated afterward. You can preview the conversation flow, view the Bot Actions taken, improvise the intent description, and <\/span>Regenerate <\/strong>the conversation if needed.<\/span><\/li>\n
          4. Click <\/span>Generate Dialog Task<\/strong> when the mock conversation looks good.<\/span>
            <\/span>            \"\"<\/a><\/span><\/li>\n
          5. Once you generate the Dialog Task, the canvas is populated with nodes corresponding to the mock conversation. You can customize the flow per your requirements by editing the generated nodes and adding your own. You can configure the generated Dialog Tasks just like any other dialog task. Keep reading to learn more.
            \"\"<\/a><\/span>
            <\/span><\/li>\n<\/ol>\n

            Dialog Task Builder Overview<\/span><\/span><\/h2>\n

            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><\/p>\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><\/p>\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