chore: chat userguide updates (#458)

Author: sr-remsha

docs/tutorials/0.user-guide.md

@@ -96,6 +96,9 @@ During a conversation, you can access several tools to work with prompts.
 
 You can copy answers to reuse them some place else.
 
+* Copy as plain text
+* Copy in markdown format
+
 ![](./img/copy-answer.png)
 
 ##### Stop and Regenerate
@@ -163,7 +166,11 @@ The file(s) will be displayed as attachment(s) in the conversation box and becom
 
 ##### View or download attachments
 
-If the response you have received includes an attachment, you can click the **Download** icon near the file name to download it or an **Expand** to preview.
+You can perform the following actions on attachments received in AI-generated responses:
+
+- **Download**: Click the **Download** icon to save the attachment to your device.
+- **Preview**: Click the **Down Arrow** icon to preview the attachment inline.
+- **Full Screen**: Click the **Expand** icon to view graphics in full screen mode.
 
 ![](./img/download-file.png)
 
@@ -1153,7 +1160,7 @@ Quick Apps 2.0 is a composer for building applications from reusable components.
 | Topics | No | You can assign one of pre-defined topics to your app. Topics and their styles are defined in [DIAL Chat Themes](https://github.com/epam/ai-dial-chat-themes/blob/development/static/config.json). |
 | Document relative URLs | No | If your application includes an instruction in the Toolset to query a document(s) in order to generate a response, use this parameter to select document(s) in [Files](#files). |
 | Model | Yes | Select one of the available language models from the dropdown list. This list includes only available models that can work with toolsets. This model will be used to reply to prompts from users and to orchestrate actions of agents. |
-| Agents & Toolsets | No | Add available [toolsets](#toolsets), [apps](#applications) or [AI models](#models) that will be used as agents in your application. Advanced users can use JSON editor to define agents.<br />Hover over the added agents and toolsets to see their details and state.<br />Click any added agent or toolset to access additional actions such as deploy/undeploy for code apps or login/logout for toolsets.<br />**Note**: When using toolsets, make sure to be logged in to use them if authentication is required. |
+| Agents & Toolsets | No | Add available [toolsets](#toolsets), [apps](#applications) or [AI models](#models) that will be used as agents in your application. Advanced users can use JSON editor to define agents and toolsets.<br />Hover over the added agents and toolsets to see their details and state.<br />Click any added agent or toolset to access additional actions such as deploy/undeploy for code apps or login/logout for toolsets.<br />**Note**: When using toolsets, make sure to be logged in to use them if authentication is required. |
 | Attachment types | No | Types of attachments allowed for this application. Provide the types according to [MIME standard](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). E.g.: image/png and click enter. Enter `*/*` to allow all types. |
 | Max. attachments number | No | The maximal number of attachments the application is allowed to accept. Skip to apply the max integer number. Enter `0` to disable attachments. |
 | Instructions | No | System prompt text. |
@@ -1199,35 +1206,46 @@ Limitations and security restrictions:
 
 ![](./img/register-code-app.png)
 
-##### To Launch Code App
+##### Deploy
 
-> **Keep in mind**, that platform [administrators can undeploy](#deploy-and-undeploy-code-apps) any running application.
+Code apps need to be deployed in order to use them. Application owners, [administrators](#administrators) and [users with editing rights](#sharing-with-editing-rights) can deploy, undeploy and redeploy applications.
 
-After adding, your new Code App will appear in [My workspace](#my-workspace).
-
-1. Click **Deploy** in the Code App menu to run it. When deployed, you will get a notification on your screen and the Code App's status icon will change from yellow to green - this may take a few minutes.
+1. Select any Code app and open its context menu.
+2. Click **Deploy**. 
+3. When deployed, you will get a notification on your screen and the Code App's status icon will change from yellow to green - this may take a few minutes.
 
    ![](./img/deploy-code-app.png)
 
-2. Select the application and click **Use application** to launch it.
+4. Select the deployed application and click **Use application** to launch it.
 
-##### To Access Code App Logs
+You can also deploy a Code apps when you add it as tool for [Quick Apps 2.0](#add-quick-app-20):
 
-You can view and download logs of the deployed Code App from the application menu.
+![](./img/deploy-code-app2.png)
 
-1. Click **Logs** in the deployed code app.
+##### Undeploy
 
-   ![](./img/logs-code-app.png)
+Code apps need to be undeployed to withdraw from usage or [make changes](#to-edit-code-app). To apply changes with less downtime use [Redeploy](#redeploy). Application owners, [administrators](#administrators) and [users with editing rights](#sharing-with-editing-rights) can deploy, undeploy and redeploy applications.
 
-2. In the pop-up window, you can view, refresh and download file with application logs.
+![](./img/undeploy-code-app.png)
 
-   ![](./img/app-logs.png)
+##### Redeploy
+
+Use **Redeploy** in the context menu or directly in the application builder UI to apply changes made to the deployed application without downtime, contrary to the undeploy and deploy process. Application owners, [administrators](#administrators) and [users with editing rights](#sharing-with-editing-rights) can deploy, undeploy and redeploy applications.
+
+![](./img/redeploy-code-app.png)
 
 ##### To Edit Code App
 
-To modify the application source code or the application form parameters, you need to undeploy it. Both **Edit** and **Undeploy** buttons are located in the application's menu:
+If you are the application owner or have [editing rights](#sharing-with-editing-rights) you can modify the application source code or the application form parameters.
+
+> **Important**: Changes apply with the next deployment of application.
 
-![](./img/app-menu.png)
+* To change anything but application name and version, make changes and click [Redeploy](#redeploy).
+* To change application name and version, click [Undeploy](#undeploy), make changes and then click [Deploy](#deploy).
+
+> **Note**, it is not allowed to modify name and version of shared with you applications.
+
+![](./img/edit-code-app.png)
 
 ##### Add/Edit code app form
 
@@ -1243,10 +1261,23 @@ To modify the application source code or the application form parameters, you ne
 | Select folder with source files | Yes | Use this to define the file structure of your application and enter into the built-in fully functional Python code editor. Here, you can write your app from scratch or upload the existing source code files. |
 | Runtime version | Yes | Select the environment in which Python code will be executed. |
 | Endpoints | Yes | Code App must expose a chat completion endpoint. You can also add rate and configuration endpoints. Refer to [DIAL Core](https://github.com/epam/ai-dial-core/blob/development/docs/dynamic-settings/applications.md) to learn about endpoints. **Note**: Code Apps cannot call each other or any external endpoints with the exception of DIAL Core, if it is allowed. |
-| Environment variables | No | You can define environment variables with values for your application. |
+| Environment variables | No | Environment variables used by the application. |
 
 ![](./img/code-app-builder.png)
 
+
+##### To Access Code App Logs
+
+You can view and download logs of the deployed Code App from the application menu.
+
+1. Click **Logs** in the deployed code app.
+
+   ![](./img/logs-code-app.png)
+
+2. In the pop-up window, you can view, refresh and download file with application logs.
+
+   ![](./img/app-logs.png)
+
 #### Mind Maps
 
 Mind Map enables users to access information through an interactive knowledge graph and natural language. The application pulls data from various sources, including documents, URLs, and other data inputs and then presents it on UI as a interactive knowledge graph, facilitating intuitive and engaging user interactions with information.
@@ -1358,7 +1389,7 @@ The key distinction between sharing and [publishing](#publish-2) is that sharing
 
 **Important**: when an application (or its specific version) is shared, any updates made to the app become immediately available to the users with whom the application has been shared, but it's important to note that **conflict resolution** for simultaneous edits by multiple users is not supported, so the changes submitted first will be applied to the shared application for all users immediately.
 
-Applications shared with and without editing rights have different scope of actions available for the target user:
+Applications shared with and without editing rights have different scope of actions available for the target user. For example, users with editing rights can edit, deploy or undeploy applications.
 
 ![](./img/share-app2.png)
 
@@ -1481,7 +1512,7 @@ If you are logged into your own toolset with your credentials, the card of the a
 
 ![](./img/toolset-logged-in.png)
 
-If a toolset was [published with credentials](#to-publish-toolset-with-creds), it can be automatically logged in displaying the label ORG CREDS:
+If a toolset was [published with credentials](#to-publish-toolset-with-creds), it may be automatically logged in and display the **ORG CREDS** label. DIAL administrators can also [log in with organization credentials](#manage-creds) to make a toolset available to all users within the organization:
 
 ![](./img/toolset-logged-in-with-creds.png)
 
@@ -1801,7 +1832,7 @@ All publication requests undergo a review process by administrators before being
 In the [DIAL Marketplace](#marketplace), administrators can deploy and undeploy Code Apps of different users.
 
 1. Go to DIAL Marketplace and apply filter by Applications. Deployed Code Apps have a green status icon.
-2. Click the app you want to undeploy/deploy. Refer to [Launch Code App](#to-launch-code-app) to learn more.
+2. Click the app you want to undeploy/deploy. Refer to [Code Apps/Deploy](#deploy) to learn more.
 
 ### Unpublish
 
@@ -1833,6 +1864,19 @@ Applications, conversations and prompts published via DIAL Core API or DIAL Chat
 2. Select **Unpublish** in the actions menu of the selected application and fill in the request form.
 3. The application will be removed from Marketplace after the unpublish request is approved by the DIAL administrator.
 
+### Manage creds
+
+DIAL administrators can view and manage the authentication status of public toolsets, including logging in and out with organization credentials on behalf of all users.
+
+1. Navigate to the Toolsets tab in Marketplace.
+2. Click any toolset (or a specific version of a toolset) that requires authentication. Refer to [Toolsets](#authentication) to learn more about toolsets authentication feature.
+3. On the toolset info card, click **Manage creds**.
+4. On the **Manage credentials** modal:
+   - **My credentials**: Log in/out using your personal credentials
+   - **Entire organization credentials**: Log in/out using organization credentials - this effects the login status of the selected toolset for all users in the organization
+
+![](./img/admin-toolset-auth.png)
+
 ## Data Visualization
 
 DIAL Chat enables data visualization for specific data types using data visualizers. It comes with built-in support for the [Plotly data visualizer](#plotly). To link any other custom visualizers, you can use the [DIAL Chat Visualizer Connector](https://github.com/epam/ai-dial-chat/blob/development/libs/chat-visualizer-connector/README.md) library.