Knowledge bases
Centralize your brand information to feed your AI Agents
IN SHORT
Knowledge bases allow you to provide your AI agents with accurate knowledge to generate relevant responses.
They can be built using your website, documents, or articles written in Fullwhere.
A knowledge base can later be used by several of your AI agents.
When your AI agents require the use of a large amount of information to generate precise and relevant responses based on your brand or location information, it can be useful to set up knowledge bases. You can add or write documents there and sync your website.
Your knowledge base can later be used by several of your AI agents.
Knowledge bases group together all the sources of information that your AI Agents can use to formulate precise answers.
Each knowledge base can contain up to five data sources of different types:
Website → allows you to directly sync your website;
Documents → allows you to upload files;
Segments → allows you to manually write articles.
Each data source can have an unlimited number of contents, a content being a web page, a file or a segment.
Access your knowledge bases
To access your knowledge bases, go to the Automation → Knowledge bases menu. There you can view all existing bases, accompanied by several key pieces of information:
Name
The name of your knowledge base
Source
The number of data sources (up to 5)
Contents
The total number of items contained in the data sources of your knowledge base (that is, the number of web pages, documents or segments)
Last updated
The date of the knowledge base's last update
Created by
The user who created the knowledge base
Creation date
The date the knowledge base was created
This view gives you an overall picture of the organization of your knowledge and its update status. You can also create a new base, access the details of an existing base or check its progress.
To view all contents (web pages, documents and segments) indexed in all your knowledge bases, go to the Automation → Contents menu.
You can filter by content type (web page, files, segments) or by knowledge base. The text search bar allows you to search for specific items.
Create a new knowledge base
To create a base, click + Create a base from the main knowledge bases page. Give the base an explicit name, corresponding for example to a brand, an entity or a functional scope.
Once the base is created, you will access its configuration page.
Add data sources
A knowledge base being made up of Data Sources, the first step is to create the data sources of your base. To do this, click the + Add button and select the type of data source you want to create: Website, Documents, Segments.
Website
This type of source allows you to automatically sync the pages of a site or a specific section of the site.
Enter the URL to analyze:
to sync an entire website, enter its "source" url (for example
https://monsite.com): all pages with this URL as root will be synced (e.g..https://monsite.com/docsandhttps://monsite.com/historyto sync a part of a website, enter the "start" url (for example
https://monsite.com/docs/): only that page and those belonging to the same "root" will be synced, (e.g. :https://monsite.com/docs/fileswill be synced, buthttps://monsite.com/historywill not be). Once the source is saved, the system automatically starts an extraction then a synchronization.
Once the data source is created, click "Sync" to start retrieving the website.
If the site is modified, you can restart the update via the Sync button.
Files
A Files-type source allows you to import documents such as PDFs. When creating it, enter the folder name (e.g. Legal documents) in which you can add documents. Once the source is created, you can add files to it by clicking + Add a file.
Once your files are imported, you can sync them with your knowledge base via the Sync button at the top right.
Whenever files are added or modified, you must Sync your data source for your changes to be taken into account in your knowledge base.
Here is the list of accepted files:
.c
Source file in C language
.cpp
Source file in C++ language
.cs
Source file in C# (C Sharp)
.css
CSS stylesheet used for web formatting
.doc
Microsoft Word document (old format)
.docx
Microsoft Word document (modern XML format)
.go
Source file in Go (Golang) language
.html
Web page in HTML format
.java
Source file in Java language
.js
JavaScript script file
.json
Data file in JSON format (JavaScript Object Notation)
.md
Markdown file, used for writing structured text
.pdf
Document in PDF format (Portable Document Format)
.php
PHP code file (server-side web language)
.pptx
Microsoft PowerPoint presentation (modern XML format)
.py
Source file in Python language
.rb
Source file in Ruby language
.sh
Shell script (Bash, Linux, macOS)
.tex
LaTeX file used for composing scientific documents
.ts
Source file in TypeScript
.txt
Plain text file
Segments
Segments are contents written directly from Fullwhere. They can be used to create a knowledge base from scratch, or to supplement a knowledge base with specific information.
When creating a folder of type segments, give it a Name (e.g. Refund information). In your folder, you can create one or more segments via the + Create a segment button and write them from the integrated Markdown editor: headings, rich text, lists, links, etc.
When you have finished editing a segment, click Save to save your changes.
When all the segments in your folder are written, you can sync them with your knowledge base via the Sync button at the top right.
When creating or modifying any segments, you must Sync your data source for your changes to be taken into account in your knowledge base.
Sync and maintain your data sources
Each data source has a synchronization status visible from its knowledge base. This status evolves according to progress: site extraction, start of synchronization, synchronization in progress, then synchronized.
You can restart a synchronization at any time, notably after:
updating a site or a file;
adding new documents or segments;
or any major modification of the original content.
A Sync button is available in the table displaying the data sources of a knowledge base, and also at the top right when you view the contents of a data source.
Browse the contents of a knowledge base
When entering a knowledge base, you will find the table of all the data sources that make it up, with the following information:
Name
Data source name
Type
Type of the data source (Website, Documents, Segments)
Content
The number of items contained in the data source. For websites, this is the number of pages of the synced website. For Documents or Segments, this is the number of existing items.
Last synchronization
Displays the "Sync" button if your data source has never been synchronized.
Displays the date of the last synchronization if your data source has already been synchronized
Displays the progress status if a synchronization is in progress:
Start of synchronization
Website extraction (Website only)
Synchronization in progress
Synchronization failed
For a source that has already been synchronized, the Sync button appears when hovering over the last synchronization date.
Synchronization
Indicates whether the file data source is "Synchronized" or "To be synchronized".
If the data source is "To be synchronized", it means that contents have been added or modified since the last synchronization. These changes will not be taken into account until the data source is synchronized again.
Created by
User who created the data source
Creation date
Creation date of the data source
Click on a Data Source to browse its contents.
The Sync button and the Last synchronization Date are displayed at the top right.
The table displays content information according to their type:
Website
Name
The name of the web page
Url
The URL of the web page
Last updated
The date of last update
Files
Name
The file name
Type
File Type/Extension
Created by
User who added the file
Creation date
Date when the file was added
Synchronization
Indicates whether the file is "Synchronized" or "To be synchronized". When a file is added or modified in a data source, it is not taken into account until the data source has been synchronized with the knowledge base. In this case, this field indicates "To be synchronized".
You can also View, Download or Delete a file using the action buttons at the end of each row. You can also perform multiple deletions by selecting several items at once and using the Delete button at the top of the table.
When you upload a file with the same name as a file already present in the same source, it is simply updated: it replaces the existing one without creating a duplicate. Segments
Name
The name of the segment
Last updated
Date of the segment's last update
Created by
User who created the segment
Creation date
Date when the segment was created
Synchronization
Indicates whether the segment is "Synchronized" or "To be synchronized". When a segment is created or modified in a data source, it is not taken into account until the data source has been synchronized with the knowledge base. In this case, this field indicates "To be synchronized".
You can also Delete a segment using the action button at the end of each row. You can also perform multiple deletions by selecting several items at once and using the Delete button at the top of the table.
Organizational best practices
To ensure the consistency and performance of your knowledge bases, it is recommended to structure your sources in a clear and uniform manner.
A good practice is to create one knowledge base per business brand or establishment.
Inside each base:
add a Website source corresponding to the website of the entity (brand or location) concerned or to online documentation (FAQ, help center, etc.);
create a Files source grouping your documents
and add a Segments source for additional information or internal articles.
Last updated