VNCai Webclient User Manual
This user manual provides step-by-step guidance for using VNCai features across VNCtalk and VNCfluid with the key benefits of
- Privacy: Local backend processing ensures data stays on-premise.
- Accessibility: Available in VNCtalk (chats) and VNCfluid (dashboard).
VNCai, when deployed, is accessible as a plugin for VNCtalk through the AI agent Vincent and via dashlet on the VNCfluid dashboard.
For general information on how to use the VNCtalk application, check out the VNCtalk User Manual, for VNCfluid, the VNCfluid User Manual .
VNCai Webclient User Manual¶
In order to use VNCai in your VNClagoon installation needs to have the VNCai OVMS-Backend installed and configured as precondition to make the AI-GFeatures available in your VNClagoon applications.
1. Access VNCai via VNCfluid Dashboard¶
- Open Dashboard: Log into VNCfluid with valid VNClagoon credentials and locate the AI dashlet:
- For AI-Prompting, you can switch by clicking if additional internal (RAG) data or only external (LLM) data should be considered by the AI agent for your processing your prompts.
- Once decited, you can enter your queries or prompts to the AI agent into the input field.
-
Whether internal data used by the AI for processing your input, is indicated by the color of the icon:
- Blue: Active: internal data is used
- Grey: Inactive: internal data is not used
2. Interact with VNCai using the VNCtalk webclient¶
- Open VNCtalk webclient: Log into VNCtalk with valid VNClagoon credentials
1:1 Chat with AI agent "Vincent"¶
-
To start a chat with the AI-Agent Vincent,
- Click on the "+" icon in the top-lweft area of the VNCtalk UI
- in the opening drop-down menu, select Start AI Chat
-
This will open a 1:1 Chat with the AI-Agent Vincent, with whom you can interact by typing prompts (e.g., questions, requests) into the input field and receive responses in the main chat window.
- it will also add the conversation with Vincent to your recent list in the left pane of the VNCtalk interface, from where you can now quickly access the chat for further AI queries.
-
Below the input mask, the icons are located, explained left to right:
AI settings: Here you can tweak how the AI will process your prompts. On click, it opens the AI settings page in the right side bar:
providing you the adjustable parameters
- Max_new_tokens: Set 0-1000 (e.g., 200 for medium responses).
- Temperature: 0-4 (low for precise, high for creative; e.g., 0.5 for balanced).
- Top_p: 0-1 (low for conservative, high for diverse; e.g., 0.3 for technical).
- Top_k: 1+ (low for focused, high for varied; e.g., 150 for writing).
Apply: Save for task-specific optimization (e.g., low values for technical docs, high for creative content).
Example Table for Settings:
Use Case Temperature Top-p Top-k Max Tokens Technical Documentation 0.3 - 0.5 0.2 - 0.4 100 - 200 500 - 800 Business Emails 0.6 - 0.8 0.5 - 0.7 200 - 300 300 - 500 Creative Content 1.5 - 3.0 0.8 - 0.95 300 - 500 600 - 1000 When activating the switch Clear chat history you can select, how long the chat history with Vicent should be remembered, available options are
- 90 days - 7 days - 24 hours - Off (which has the same effect as deactivating the switch)
Attach file:
Click the paper clip icon to upload files you want to share with the VNCai agent to the chat.
This will open the file picker of your OS, allowing you to select the file(s) you want to have processed by the AI. Currently these file types are supported:txt, docx, pdf, csv, xlsx, jpg, png, gif, mp3, wav, mp4
When done, a blue thumbnail icon appears below the input mask, indicating that it can be used for prompting now
Next, enter your prompt, regarding the VNCai's desired interaction with the attached file(s), into the input mask.
VNCai currently supports tasks like- Translate (EN <-> DE) - Summarize (Documents/ Texts/ Video/ Audio) - Ask Questions about the attached file's content
Use internal Data switch:
Activate/ deactivate per click. Whether internal data used by the AI for processing your input is active or not, is indicated by the color of the icon:
- Blue: Active: internal data is used
- Grey: Inactive: internal data is not used
Group Chat with AI agent in VNCtalk¶
Create/Add to Group: Start a new group chat or add the AI-Agent to an existing one via participant list.
-
To create a new groupchat, click "+" and select New group chat from the opening dropdown menu
-
Add participants (+) to the Groupchat, including the AI-agent Vincent
-
When done, finish the group chat creation by clicking CREATE
-
In order to interact with VNCai via the AI-Agent in a group chat, you need to mention the AI-agent, meaning, use
"@Agent Vincent [Question]" (e.g., "@Agent Vincent How is the wheather in Berlin today?").
and make sure, that you clicked the AI button in the lower button bar of the group chat interface
The indicator color of the AI button informs you, whether the AI-Agent is enabled or disabled:
- blue --> enabled
- grey --> disabled
-
Now click the SEND button, to submit your prompt.
In case the AI is active, your input will be recognized as an AI prompt, indicated by the Prompt tag in the chat window. The AI will then start processing your input, visualized colored spinner animation appearing aside of the AI-agent's avatar in the chat window.
The AI response is presented in form of a chat message sent by the Agent Vincen, once the processing has been completed.
If the Prompt tag is missing, your input has not been recognized as a prompt but only as a standard chat message.
For more information on basic interaction with the VNCai-agent Vincent, check out this video tutorial on interacting with Vincent
Compare documents¶
VNCai offers an interface to compare multiple documents according to user definable criteria.
-
To compare documents in VNCtalk, click "+" and select Compare Documents with AI from the opening dropdown menu
-
In the opening iterface, click the paper clip icon to upload the files you want to compare. This will open the file picker of your OS to select the files
-
When done, the uploaded files are listed in the Selected Files section
-
Now enter the criteria on which you want VNCai to compare the uploaded files against each other
-
Click Compare to start the comparision by VNCai
-
VNCai will then provide the comparison analysis into the Comparison Result field
VNCai prompts and operations on Attachments¶
Translate documents and texts¶
Currently VNCai is able to translate texts and documents from English to German and vice versa.
The texts for translation can be
-
provided to Vincent as payload in a prompt, where the text to translate is encapsuled into quotation marks, like
Please translate me this text into English: "<paste text to translate>"
-
or the text to translate can be uploaded as file-attachment via the paper clip button along with a prompt like this:
Please translate the attached document into German.
For more information, check out this video tutorial on translating documents and texts with VNCai
Summarizing documents, conversations or texts¶
- Upload a document or enter text to summarize enclose in quotes
-
Prompt: "Please summarize this [specify format, e.g., in 100 words or 5 bullets]", eg.
"Summarize the key points from this chat."
-
Vincent will then provide the respective overview as reply in the chat window.
Summarize content of video/audio files and recordings¶
- Upload mp3, mp4, wav file in chat or enter file URL
-
Prompt:
"Summarize the content of this video/audio file" or "What's the speaker talking about? [URL]" or "Provide the key points from [URL]".
-
Vincent will then provide the respective summary as reply in the chat window.
Asking VNCai for specific content of attached documents¶
- Upload document (e.g., PDF) in chat or enter file URL, eg. a document that cotains information about VNClagoon
-
Prompt:
"What is VNClagoon? Refer to [file name]".
-
Vincent will then provide the respective information extracted from the uploaded/ linked document as reply in the chat window.
Schedule meetings with VNCai via VNCtalk¶
-
To schedule a meeting in VNCtalk with the help of VNCai, click "+" and select
Schedule meeting with AI from the opening dropdown menu -
In the opening input mask, enter a topic and click the "+" button to add the desired meeting participants
-
Agent Vincent has been already added as mandatory member to the participant list.
Now search and add the desired participants to the participant list and click SELECT when done.
-
Back in the Schedule meeting interface, you have to enter some key information, on what the meeting is about, into the Meetings's Purpose field.
-
When done, click Generate in the bottom left corner.
-
VNCai will then start generating an invitation including a meeting agenda, based on the information you provided into the Generated content field.
-
When VNCai is done generating, you can review the result and adjust it to your needs, if required. When done, click Schedule to create the meeting in VNCtalk, in your VNCmail calendar and triggers the eMail-invites to the participants.
For more information, check out this video tutorial on scheduling meetings with VNCai