# User Interface Basics

### **Overview of the New Blank Project**

To start from scratch, refer to the [Creating Project](/digital-agent/workspace/list-of-projects.md) 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 ](broken://pages/NbR5bCBZnYtNWpMVaK3n)and refer to the video below.

<figure><img src="/files/jhIHYCKKWO2glixGhSm3" alt=""><figcaption><p>creating new flow</p></figcaption></figure>

{% tabs %}
{% tab title="Top Panel" %}

<figure><img src="/files/HPxgkwrDcKVnMCFkh7oi" alt=""><figcaption></figcaption></figure>

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

#### 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](/digital-agent/conversation-flow/setting-tab.md) for detail explanation.
* **Variables overview:** list of all variables within selected project.

#### 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.
{% endtab %}

{% tab title="Nodes panel" %}
The left panel showcases Nodes and an interactive panel with various building blocks. For a deeper understanding, explore the [Nodes Explained chapter](/digital-agent/conversation-flow/nodes-explained.md).
{% endtab %}

{% tab title="Zoom panel" %}
Use basic interaction options such as zoom-in, zoom-out, or fit to the project screen by clicking on the basic interaction menu.
{% endtab %}

{% tab title="Bottom panel" %}

1. **Save:** Save the current project status. If the Flow Editor and Code Editor are synced, automatic saving is enabled.
2. **Save  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:** This offers advanced technical logs about the project in the elastic app, more suitable for advanced users and optimization purposes.
6. **Notes:** Blank pages for notes, thoughts and ideas about your project.
7. **Comments:** Overview of all existing comments within the project.
   {% endtab %}
   {% endtabs %}

### 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.

<figure><img src="/files/g1m5sgjX2TM0HayyXVVd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Gl92AYuGSj4v6F2cNlI3" alt=""><figcaption></figcaption></figure>

<details>

<summary>Creating comments step-by-step</summary>

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.

</details>

<details>

<summary>Editing comments step-by-step</summary>

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

</details>

<details>

<summary>Assigning comments to user step-by-step</summary>

1. **Write Your Comment:** Begin writing your comment in the text box.
2. **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.\
   :exclamation:Remember, you can tag only users who have access to the project, see [Project Details](/digital-agent/workspace/project-details.md#users-settings) for details.
3. **Complete Your Comment:** Continue writing the rest of your comment as needed.
4. **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

</details>

<details>

<summary>Managing comments step-by-step</summary>

**Marking Comments:**

1. **Mark as Read/Unread:**
   * To indicate that you've read a comment, simply click on the icon <img src="/files/jPJhmrcFxpo4gr5ZIN1R" alt="" data-size="line">, and it will be marked as read.
   * 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:

2. **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:

3. **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:**

4. #### 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.

</details>

### Notes

Within each project, **a notepad** is provided, offering a simple yet powerful tool for collaboration and organization.&#x20;

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.

<mark style="color:yellow;">SPend</mark>

<figure><img src="/files/kbJ8TR2TrNA8nmy3X6ts" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5lHAAJ18AKuyjWunAOYR" alt=""><figcaption></figcaption></figure>

***

### **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.&#x20;

This straightforward project was built step-by-step (refer to the [Creating My First Virtual Assistant](/digital-agent/building-new-projects.md) page), utilizing nodes as fundamental building blocks, elaborated further in the upcoming chapter - [Nodes Explained](/digital-agent/conversation-flow/nodes-explained.md).

<figure><img src="/files/51k64lM0wxXJMMpnmWNv" alt=""><figcaption><p>Training example project</p></figcaption></figure>

<details>

<summary>Step by step to train the project</summary>

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

</details>

{% hint style="info" %}
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
{% endhint %}

***

### 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:

<figure><img src="/files/5ja4aACuOyM6O8pd9TrX" alt=""><figcaption></figcaption></figure>

#### Learn how to use shortcuts&#x20;

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.

{% tabs %}
{% tab title="Deployment" %}
Ideal for training, deployment, and various project management tasks.

<table><thead><tr><th width="256">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>ALT + S</td><td>Save</td></tr><tr><td>ALT + SHIFT + S</td><td>Save model version</td></tr><tr><td>ALT + SHIFT + I</td><td>Import</td></tr><tr><td>ALT + SHIFT + E</td><td>Export</td></tr><tr><td>ALT + SHIFT + T</td><td>Train version / untrain</td></tr><tr><td>ALT + SHIFT + F</td><td>Test in debug</td></tr><tr><td>ALT + SHIFT + D</td><td>Project Deploy</td></tr></tbody></table>
{% endtab %}

{% tab title="Edit" %}
Streamline your editing process with these handy shortcuts.

<table><thead><tr><th width="301">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>CTRL + C</td><td>Copy</td></tr><tr><td>CTRL + V</td><td>Paste</td></tr><tr><td>CTRL + X</td><td>Cut</td></tr><tr><td>CTRL + D</td><td>Duplicate</td></tr><tr><td>ALT + F</td><td>Find</td></tr><tr><td>Shift + Left mouse</td><td>Multiselect</td></tr></tbody></table>
{% endtab %}

{% tab title="Essentials" %}
Familiar essential shortcuts, now with ALT replacing CTRL for improved accessibility.

<table><thead><tr><th width="237">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>ALT + Y</td><td>Redo</td></tr><tr><td>ALT + Z</td><td>Undo</td></tr><tr><td>ESC</td><td>Escape the node</td></tr><tr><td>BACKSPACE</td><td>Delete node</td></tr><tr><td>END</td><td>Previous node</td></tr><tr><td>ALT + G</td><td>Group selection</td></tr><tr><td>ALT + SHIFT + G</td><td>Ungroup selection</td></tr></tbody></table>
{% endtab %}

{% tab title="Nodes" %}
Effortlessly create multiple nodes with a simple click on the canvas. Press ESC to revert to the normal cursor.

<table><thead><tr><th width="266">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>SHIFT + M</td><td>Message node</td></tr><tr><td>SHIFT + A</td><td>Answer node</td></tr><tr><td>SHIFT + D</td><td>Decision node</td></tr><tr><td>SHIFT + F</td><td>Function node</td></tr><tr><td>SHIFT + G</td><td>Generative AI node</td></tr><tr><td>SHIFT + R</td><td>Redirect</td></tr><tr><td>SHIFT + T</td><td>Transfer </td></tr><tr><td>SHIFT + E</td><td>End</td></tr></tbody></table>
{% endtab %}

{% tab title="Tools" %}
Navigate UI changes quickly with shortcuts for the move tool, hand tool, and comment tool.

<table><thead><tr><th width="175">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>ALT + V</td><td>Move tool</td></tr><tr><td>ALT + H</td><td>Hand tool</td></tr><tr><td>ALT + C</td><td>Insert comment</td></tr><tr><td>ALT + SHIFT + C</td><td>Show/hide comment panel</td></tr><tr><td>ALT + SHIFT + N</td><td>Open / hide notepad</td></tr></tbody></table>
{% endtab %}

{% tab title="Zoom" %}
Enhance your project view with quick zoom in/out shortcuts.

<table><thead><tr><th width="229">Shortcut</th><th width="186">Name of the action</th></tr></thead><tbody><tr><td>Mouse wheel</td><td>Zoom in / out</td></tr><tr><td>SHIFT + 1</td><td>Zoom to fit</td></tr><tr><td>SHIFT + 2</td><td>Lock interactivity</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Special Note for Mac Users:**&#x20;

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.
{% endhint %}

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.borndigital.ai/digital-agent/conversation-flow/user-interface-basics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.