AISERVA and AIKuari
ChatBots and Knowledge Bases
ChatBots in AISERVA are AI assistants you build yourself, each with its own name, personality and separate knowledge base, answered by the AI model on your own VYROX AI server. You can keep a bot private, share it with customers or staff through a public link, or connect it to another AI agent or program with an API key. Businesses use them for support assistants, internal policy helpers, product FAQs and staff onboarding.
Before You Start
- A server with a chat model is Connected and active. See Manage AI Models.
- Gather the text the bot should know: price lists, FAQs, policies, product manuals, opening hours.
Create a ChatBot
- Go to Apps and open ChatBot. The ChatBots page reads "Create AI assistants - each with its own separate knowledge base and personality."
- Press Create New Chatbot. The New Chatbot sheet opens.
- Fill in Name (up to 100 characters), for example "Support Assistant".
- Optionally fill in Personality / Instructions (up to 4,000 characters), for example "You are a friendly customer-support agent. Answer only from the knowledge base; if unsure, say so."
- Press Create Chatbot. You add its knowledge after it is created.
- The bot appears in the list with the number of documents in its knowledge base. Press Open to use it.
Write Good Instructions
The Personality / Instructions field tells the bot how to behave on every answer.
| Include | Example |
|---|---|
| Who it is | "You are the front-desk assistant for Seri Maju Dental." |
| Who it talks to | "You answer patients and their families." |
| Where answers come from | "Answer only from the knowledge base." |
| What to do when unsure | "If the answer is not in the knowledge base, say so and give our phone number." |
| Tone and language | "Reply briefly and politely, in the language the user writes in." |
| What never to do | "Never quote prices that are not in the knowledge base." |
Add Knowledge Documents
- Open the bot and press the gear icon (Knowledge & Settings).
- Go to the Knowledge tab.
- Enter a Name for the document, such as "Pricing", "FAQ" or "Product Manual".
- Paste the text into Content.
- Press Add to Knowledge Base.
- Repeat for each document. To remove one, press its bin icon (Remove) and confirm "Remove ... from the knowledge base?"
A new bot with no documents shows "No documents yet. Add text below - this bot will answer from it."
How the Bot Uses Its Knowledge
When someone asks a question, AISERVA splits the bot's documents into short passages, picks the passages that best match the words in the question, and hands only those to the model with your instructions. The bot also sees the last few messages of the conversation. This means:
- A bot answers well when the answer is written plainly in one place in a document.
- Very long documents are fine, but only the best-matching passages are read for each question.
- Each document can be up to 2 MB of text.
Change Settings or Clear a Conversation
- To rename the bot or change its behaviour, open Knowledge & Settings > General, edit Name or Personality / Instructions, and press Save Settings.
- To start the conversation over, press the pencil icon (Clear Conversation) and confirm "Clear this conversation? (Knowledge base is kept.)"
Share a ChatBot by Public Link
- Open the bot, press the gear icon and go to Sharing.
- Press Enable Public Link. The status changes to Public Link Is On.
- Press Copy Link and send it, or put it on your website.
- To end access, press Stop Sharing and confirm "Turn off sharing? The current link will stop working." The bot returns to Private.
Anyone with the link can chat with the bot without signing in. Each visitor's chats are tied to their own browser and listed under Your Chats, and visitors cannot see your settings or documents. The shared page shows "Powered by VYROX AI". If the link is turned off, visitors see "This shared chatbot link is invalid or has been turned off."
Connect Another AI Agent with an API Key
The API tab lets another AI agent or program talk to the bot over the internet, sending text, attached images and using the bot's knowledge base, still answered by your own server.
- Open the bot, press the gear icon and go to API.
- Type a Label, for example "Claude on My Laptop".
- Choose the options below.
- Press Create API Key.
- Press Copy Key at once. "Your new key. Copy it now, it will not be shown again."
- Press Copy Agent Instructions to copy ready-made setup text for the agent.
| Option | What It Means | Default |
|---|---|---|
| Also Allow Image Generation | The same key can create and edit images on your server | On |
| Allow All My Chatbots | The key can reach every bot you own | Off; off is safer, the key is locked to this one bot |
You can press Revoke next to a key at any time on the API tab. Confirm "Revoke this key? Any agent using it stops working immediately."
Delete a ChatBot
- On the ChatBots page press Delete next to the bot.
- Confirm "Delete ... and its knowledge base?".
Frequently Asked Questions
Can Visitors on a Public Link See My Documents?
They cannot open your settings or document list, but the bot answers from the documents, so anything in them can appear in an answer.
Why Did the Bot Say It Does Not Know?
The answer is probably not in the knowledge base, or it is worded very differently from the question. Add a section that uses your customers' wording.
Can I Upload a PDF or Word File?
The Knowledge tab takes pasted text. Copy the text out of your file and paste it into Content.
What Happens If My Server Is Off?
The bot cannot answer until your server reconnects. Nothing is sent to an outside AI service instead.
I Lost My API Key. Can I See It Again?
No. Revoke the old key and create a new one.