Ringostat
Log in

Knowledge base (RAG)

~7 min · The agent answers about prices, terms and policies from your documents.
What you get:
the agent answers questions about prices, terms and policies from your documents.
Before you start:
materials as text, .txt, .pdf, .docx or .md files, or JSON articles. To connect a base to a campaign, the campaign must be saved.

The agent keeps the instructions in memory all the time. In the knowledge base it looks up only what it needs for the current reply. So large materials go here: price lists, FAQs, policies, manuals.

1. Create a base

Left menu → “Knowledge Bases” → “+ Add New” in the top right corner.

Knowledge bases
Knowledge bases
New knowledge base
New knowledge base
“Name”requiredThe base's name in the list.
“Description”optionalFor you; the agent doesn't read it.
“Language”recommendedThe language of the materials; it affects search. English by default: for materials in another language, change it.
“Type”required“Text Content” (paste text), “File Upload” (.txt, .pdf, .docx, .md) or “JSON Articles” (a flat array, topics or FAQ — the format is detected automatically; for JSON the description, language and chunking don't apply).
“Advanced settings”optionalChunking: the chunk size (750 tokens by default) and overlap (50 tokens). Leave it empty for ordinary texts.

Click “Upload”. While the base is being processed, the list updates by itself. After processing the status changes to “Active” and the number of chunks appears.

“Upload” button
“Upload” button
Base status and number of chunks
Base status and number of chunks

2. Check the search

Next to the base click the green “View articles” icon. In the “Search query” field enter a customer's question and click “Run search”. You will see chunks close to the ones the agent gets: the smaller the distance, the closer the match.

“View articles” icon
“View articles” icon
Test search
Test search
Base articles
Base articles

3. Connect the base to a campaign

  1. 1
    Open the campaign editor → the “Knowledge base” card.
  2. 2
    In the “Knowledge Base Integration (RAG)” field choose “Enabled” and save the campaign.
  3. 3
    Select the bases this campaign needs. You can select several; a selected base is connected at once.
    Knowledge base in a campaign
    Knowledge base in a campaign
A base can be connected only to a saved campaign. While the campaign has unsaved changes, the “Bot test” button is inactive.

4. Keep the content up to date

Add an article“Add content” next to the base → fill in the fields → “Upload”. The base's name, language and chunking stay the same.Add content
Edit an article“View articles” → the pencil icon next to the article → change the “Title” or “Body” → “Save”.View articlesEdit an article
Delete an article“Delete article” → confirm.Delete article
Change the baseThe settings icon: name, description, chunking. New chunking applies after reprocessing.Base settings
Reprocess or delete the baseThe matching icons next to the base.Reprocess or delete the base

A new article goes through the “Pending” → “Processing” → “Completed” statuses, and the agent sees it only in the “Completed” status. After an edit the agent answers from the previous version until the new one is processed.

Article statuses don't update by themselves. Close and reopen the articles window or refresh the page.

Tips before uploading

  • One file = one article. Only the text is taken from a file; information from images doesn't get into the base.
  • Split into small articles. The system breaks a large article into chunks; you can view and edit them with the (i) “Inspect chunks” button.
  • One base, several campaigns. Changes to a base apply at once in every campaign it is connected to.
Reprocessing creates all chunks anew, and manual chunk edits are lost. So split the information into small articles from the start instead of editing the chunks of a large file.

What next