Born Digital - Documentation
  • Welcome
    • Welcome to Digital Studio
  • Digital Agent
    • Introduction
    • Workspace
      • List of Projects
      • Project Details
      • Deploy Project
    • Conversation Flow
      • User Interface Basics
      • Nodes Explained
        • MESSAGE node
        • ANSWER node
        • DECISION node
        • FUNCTION node
        • AI node
        • TRANSFER node
        • REDIRECT node
        • START / END nodes
      • Training set
        • Overview
        • Best practices for writing training set
      • Launching project
      • Setting tab
    • Building new projects
      • Knowledge base project
        • Step 1. - Initializing Your Project
        • Step 2. - Integrating AI Node
        • Step 3. - Finalizing with Testing and Training
        • (Optional) - Integrating a Knowledge Base Index
      • Advanced project
        • Step 1. - Establishing Functions
        • Step 2. - Crafting Greetings
        • Step 3. - Adding the AI node
        • Step 4. - Managing Flow Scenarios
        • Step 5. - Finalizing the Project
        • Step 6. - Training and Execution
    • Advanced functions
      • Knowledge base
      • New AI node property variables
      • Recordings
      • Statistics
      • Code editor
      • Widgets
  • For advanced users
    • Conversation design tips
      • Customizing speech synthesis
      • Customizing text output
      • Customizing smart functions output
      • Randomizing message content
      • Alternative messages based on variable values
      • Setting time-based greetings
      • Personalised URL links
      • Custom business statuses with variables
      • String slicing
      • Implementing chat buttons
    • Intent recognition tips
      • Fine-Tuning Intent Recognition using Generative AI
      • Multi-step intent recognition
      • Recognition based on named entity extraction
    • Prompting cookbook
      • Basics
      • Prompting techniques
  • Product changelog
    • Product changelog
  • Initial setup
    • Starting up
    • My settings
  • Contacts
    • Contacts for you
Powered by GitBook
On this page
  • Overview of the New Blank Project
  • Comments
  • Notes
  • Overview of the Not-so-Blank Project
  • Simplified interactions using shortcuts

Was this helpful?

  1. Digital Agent
  2. Conversation Flow

User Interface Basics

Before starting work on any Conversation Flow, wether creating a new project or updating an existing one, it is important to understand the basics of the User Interface

PreviousConversation FlowNextNodes Explained

Last updated 10 months ago

Was this helpful?

Overview of the New Blank Project

To start from scratch, refer to the page for detailed instructions.

Remember, you can also import projects based on your templates into your workspace.

To understand different versions, check out the Project Version History and refer to the video below.

1. Files:

The Files section serves as a gateway to manage your project files and configurations. It contains a dropdown menu with the following options:

  • Import: Allows you to import files or data into your project from external sources.

  • Export: Enables you to export project files or data for sharing or backup purposes, deal for creating various project cases and scenarios.

  • Shortcuts: Provides access to keyboard shortcuts overview for quick navigation and actions within the platform.

  • Settings: Allows you to customize project settings and configurations according to your preferences. See Setting tab for detail explanation.

2. Cursor Icons:

These icons offer flexibility in navigating and interacting with the project canvas:

  • Standard Cursor: Allows you to select and interact with nodes and elements on the canvas.

  • Hand Cursor: Enables you to grab and move nodes or scroll within the canvas for better navigation.

3. Comment Icon:

Clicking on this icon activates the commenting feature, allowing users to add comments.

4. Sync Toggle:

This toggle allows you to enable or disable synchronization between the flow diagram and the code.

5. Undo/Redo Icons:

These icons offer the ability to undo or redo previous actions, providing a safety net for experimentation and preventing accidental changes.

6. Search Panel:

The search panel provides a convenient way to search for nodes within your project by their names, allowing for quick navigation and location of specific elements.

Use basic interaction options such as zoom-in, zoom-out, or fit to the project screen by clicking on the basic interaction menu.

  1. Save: Save the current project status. If the Flow Editor and Code Editor are synced, automatic saving is enabled.

  2. Save Model Version: Saving the model version is crucial. Visit "Project Fundamentals" to understand why versioning matters.

  3. Train Version: This feature is used to train the completed project flow (explained later).

  4. Deploy Version: Change parameters and deploy your created project.

  5. Test in Debug Mode: This offers advanced technical logs about the project in the elastic app, more suitable for advanced users and optimization purposes.

  6. Notepad: Blank pages for notes, thoughts and ideas about your project.

  7. Comment panel: Overview of all existing comments within the project.

Comments

To enhance cooperation and streamline communication, users have the flexibility to add two types of comments:

  • General comments General comments provide a space for users to share overall feedback, ask questions, or discuss ideas that are not tied to any specific node or element within the project. They can be placed anywhere on the canvas and are not tied to a specific node.

  • Node-specific comments Node-specific comments offer more targeted feedback by linking comments directly to specific nodes or elements within the project. This feature is invaluable for providing precise feedback on particular parts of a conversation flow, code segments, or design components.

Creating comments step-by-step
  1. Access the Comment Feature: Locate the comment icon in the top menu among other tools. Click on this icon to activate the comment feature.

  2. Placing Comments:

    • For general comments: Click anywhere within the project where you want to place the comment.

    • For node-specific comments: Click on the specific node or element within the project to tie the comment with that particular node.

  3. Compose Your Comment: A text box will appear where you can type your comment. Write the text of your comment, providing feedback, asking questions, or sharing ideas as needed.

  4. Save Your Comment: Once you've written your comment, click on the check mark icon to save it. Your comment will be added to the project, visible to all users with access to the project.

Editing comments step-by-step
  1. Select Comment: Click on the comment directly within the canvas or in the comment panel. This action fully opens the comment.

  2. Access Editing Mode: Once the comment is opened, click on the pencil icon. This action allows you to edit the content of the comment.

  3. Edit Comment: Update the text of the comment as needed, making any necessary changes or revisions.

  4. Save Changes: After editing the comment, click on the check mark icon to save your changes

Assigning comments to user step-by-step
  1. Write Your Comment: Begin writing your comment in the text box.

  2. Complete Your Comment: Continue writing the rest of your comment as needed.

  3. Save Your Comment: Once your comment is complete, click on the check mark icon to save it. The comment will now be assigned to the selected user

Managing comments step-by-step

Marking Comments:

  1. Mark as Read/Unread:

    • Similarly, if you want to mark a comment as unread to revisit it later, click on the icon again, and it will revert to an unread status.

Resolving Comments:

  1. Mark as Solved:

    • If a comment has been addressed or no longer requires attention, you can mark it as solved.

    • This action will remove the comment from the canvas or comment panel, streamlining the view for unresolved comments.

Filtering Comments:

  1. Filtering Options in Comment Panel:

    • You can filter comments in the comment panel based on different criteria:

      • Only comments you've made.

      • All comments marked as read.

      • All comments marked as solved.

    • By default, you'll see all unresolved comments in the order of their creation or last update.

Delete Comment:

  1. Deleting Comments:

  • If a comment is no longer needed or is redundant, you can delete it by clicking on the trash bin icon associated with the comment.

Notes

Within each project, a notepad is provided, offering a simple yet powerful tool for collaboration and organization.

The notepad features a user-friendly graphical interface with a blank space where you can jot down your thoughts, ideas, and reminders. Additionally, a formatting panel is available, allowing you to customize the appearance of your notes with options such as font styles, colors, and list formatting.


Overview of the Not-so-Blank Project

Here, you'll find the editor displaying an example project. We have a flow with connections and nodes as the primary building blocks shaping our conversational flow, featuring a starting node and an end node (phones). After training the version, we gain access to the chatbot widget, allowing us to toggle the left navigation bar and hide/show the node bar.

Step by step to train the project

See the more information about training / untraining version in page (Training model)

Prerequsities - having the completed conversation flow, see the example project in page - Creating my first Virtual Assistant

  1. Select the right project

  2. Click "Train version"

  3. Click chatbot widget in bottom right corner and start interacting with simple chatbot (Virtual assistant)

  4. Check the flow

  5. Untrain model, make modification and train again

You can see that we can expand the chatbot widget or move it to the middle by clicking the buttons in the top left corner


Simplified interactions using shortcuts

These shortcuts are designed to enhance your workflow and help you navigate the studio with ease. Check out the new shortcuts in action below:

Learn how to use shortcuts

You can find a comprehensive overview of all the new shortcuts within the app. Just navigate to FILE -> Shortcuts modal to learn more and incorporate them into your projects.

Ideal for training, deployment, and various project management tasks.

Shortcut
Name of the action

ALT + S

Save

ALT + SHIFT + S

Save model version

ALT + SHIFT + I

Import

ALT + SHIFT + E

Export

ALT + SHIFT + T

Train version / untrain

ALT + SHIFT + F

Test in debug

ALT + SHIFT + D

Project Deploy

Streamline your editing process with these handy shortcuts.

Shortcut
Name of the action

CTRL + C

Copy

CTRL + V

Paste

CTRL + X

Cut

CTRL + D

Duplicate

ALT + F

Find

Shift + Left mouse

Multiselect

Familiar essential shortcuts, now with ALT replacing CTRL for improved accessibility.

Shortcut
Name of the action

ALT + Y

Redo

ALT + Z

Undo

ESC

Escape the node

BACKSPACE

Delete node

END

Previous node

ALT + G

Group selection

ALT + SHIFT + G

Ungroup selection

Effortlessly create multiple nodes with a simple click on the canvas. Press ESC to revert to the normal cursor.

Shortcut
Name of the action

SHIFT + M

Message node

SHIFT + A

Answer node

SHIFT + D

Decision node

SHIFT + F

Function node

SHIFT + G

Generative AI node

SHIFT + R

Redirect

SHIFT + T

Transfer

SHIFT + E

End

Navigate UI changes quickly with shortcuts for the move tool, hand tool, and comment tool.

Shortcut
Name of the action

ALT + V

Move tool

ALT + H

Hand tool

ALT + C

Insert comment

ALT + SHIFT + C

Show/hide comment panel

ALT + SHIFT + N

Open / hide notepad

Enhance your project view with quick zoom in/out shortcuts.

Shortcut
Name of the action

Mouse wheel

Zoom in / out

SHIFT + 1

Zoom to fit

SHIFT + 2

Lock interactivity

Special Note for Mac Users:

Don't worry, we've got you covered! Mac users can enjoy these shortcuts by using the OPTION key in place of ALT, and the COMMAND key instead of CTRL.


The top panel of our platform provides essential tools and functionalities for seamless project management and navigation. Let's break down each component:

The left panel showcases Nodes and an interactive panel with various building blocks. For a deeper understanding, explore the .

Tag a User: To assign the comment to a specific user, type "@" followed by the user's name. As you type, suggestions of other users in your organization will appear. Select the appropriate name from the suggestions to assign the comment to that user. Remember, you can tag only users who have access to the project, see for details.

To indicate that you've read a comment, simply click on the icon , and it will be marked as read.

This straightforward project was built step-by-step (refer to the page), utilizing nodes as fundamental building blocks, elaborated further in the upcoming chapter - .

Nodes Explained chapter
Creating My First Virtual Assistant
Nodes Explained
❗
Creating Project
Training example project
Users settings