> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/documentation/documentation-en/automations/knowledge-bases.md).

# Knowledge bases

Centralize your brand information to power your AI Agents

{% hint style="success" icon="list-check" %}
**IN BRIEF**

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 then be used by several of your AI agents.
{% endhint %}

{% hint style="info" icon="lightbulb" %}
When your [AI agents](https://docs.fullwhere.com/documentation/documentation-en/automations/ai-agents.md) require a large amount of information to generate accurate 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 synchronize your website.

Your knowledge base can then be used by several of your AI agents.
{% endhint %}

{% hint style="info" icon="shield-check" %}
**ACCESS RIGHTS**

To edit the Knowledge Bases in your Fullwhere workspace, you must be a supervising member with Administrator rights.
{% endhint %}

Knowledge bases bring together all the information sources that your AI Agents can use to formulate accurate responses.

Each knowledge base can contain up to five data sources of different types:

* Website → allows you to synchronize your website directly;
* Documents → allows you to upload files;
* Segments → allows you to write articles manually.
* <i class="fa-notion">:notion:</i> Notion → allows you to synchronize Notion content in your knowledge base.

Each data source can have an unlimited number of contents, with a content being a web page, a file, or a segment.

***

## Access your knowledge bases <a href="#h_3ac2f4405e" id="h_3ac2f4405e"></a>

To access your knowledge bases, go to the Automation menu → [Knowledge bases](https://app.fullwhere.com/automation/knowledge-base) from the main navigation bar on the left of your screen.\
There you can see all existing bases, along with several key pieces of information:

| Column        | Description                                                                                                                               |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 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 the knowledge base was last updated                                                                                              |
| Created by    | The user who created the knowledge base                                                                                                   |
| Creation date | The date the knowledge base was created                                                                                                   |

This view gives you an overview of the organization of your knowledge and their 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 menu → Contents.

\
You can filter by content type (web page, files, segments) or by knowledge base.\
The text search bar lets you search for specific items.

***

## Create a new knowledge base <a href="#h_727643bafc" id="h_727643bafc"></a>

To create a base, click + Create a base from the main knowledge bases page. Give the base a clear name, corresponding for example to a brand, an entity, or a functional scope.

Once the base is created, you access its configuration page.

## Add data sources <a href="#h_904ef67d26" id="h_904ef67d26"></a>

Since a knowledge base is made up of data sources, the first step is to create the data sources for your base. To do so, click the + Add button and select the type of data source you want to create: Website, Documents, Segments or Notion.

### Website <a href="#h_ca321ef733" id="h_ca321ef733"></a>

This type of source automatically synchronizes the pages of a site or of a specific section of the site.

\
Enter the URL to analyze:

* to synchronize a website in its entirety, enter its "source" URL (for example `https://mysite.com`): all pages whose root is this URL will be synchronized (*e.g.*. `https://mysite.com/docs` and `https://mysite.com/history`
* to synchronize part of a website, enter the "starting" URL (for example `https://mysite.com/docs/`): only this page and those belonging to the same "root" will be synchronized, (*e.g.* : `https://mysite.com/docs/files` will be synchronized, but `https://mysite.com/history` will not).\
  Once the source is saved, the system automatically starts an extraction and then a synchronization.

Once the data source is created, click "Synchronize" to start retrieving the website.

If the site changes, you can restart the update using the Synchronize button.

***

### Files <a href="#h_acf7d78e87" id="h_acf7d78e87"></a>

A Files-type source allows you to import documents such as PDFs.\
When creating it, specify the folder name (e.g. *Legal documents*) in which you will be able to add documents.\
Once the source is created, you can add files by clicking + Add a file.

Once your files are imported, you can synchronize them with your knowledge base via the Synchronize button at the top right.

Whenever files are added or modified, you must Synchronize your data source so that your changes are taken into account in your knowledge base.

Here is the list of accepted files:

| Extension | Meaning                                               |
| --------- | ----------------------------------------------------- |
| `.c`      | C language source file                                |
| `.cpp`    | C++ source file                                       |
| `.cs`     | C# source file (C Sharp)                              |
| `.css`    | CSS style sheet used for web formatting               |
| `.doc`    | Microsoft Word document (legacy format)               |
| `.docx`   | Microsoft Word document (modern XML format)           |
| `.go`     | Go language source file (Golang)                      |
| `.html`   | Web page in HTML format                               |
| `.java`   | Java source file                                      |
| `.js`     | JavaScript script file                                |
| `.json`   | Data file in JSON format (JavaScript Object Notation) |
| `.md`     | Markdown file, used for writing structured text       |
| `.pdf`    | PDF document (Portable Document Format)               |
| `.php`    | PHP code file (server-side web language)              |
| `.pptx`   | Microsoft PowerPoint presentation (modern XML format) |
| `.py`     | Python source file                                    |
| `.rb`     | Ruby source file                                      |
| `.sh`     | Shell script (Bash, Linux, macOS)                     |
| `.tex`    | LaTeX file used for composing scientific documents    |
| `.ts`     | TypeScript source file                                |
| `.txt`    | Plain text file (plain text)                          |

***

### Segments <a href="#h_d9b534a14b" id="h_d9b534a14b"></a>

Segments are pieces of content written directly from Fullwhere. They can be used to create a knowledge base from scratch, or to supplement a knowledge base with certain specific information.

When creating a folder of the segments type, 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 using 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 synchronize them with your knowledge base via the Synchronize button at the top right.

Whenever segments are created or modified, you must Synchronize your data source so that your changes are taken into account in your knowledge base.

***

### Notion <i class="fa-notion">:notion:</i> <a href="#h_notion" id="h_notion"></a>

A Notion source allows you to synchronize the content of your Notion workspace with your knowledge base.

When creating, select **Notion** then log in to your account. Then choose the workspace, then the pages or databases to synchronize.

The connection between Notion and your knowledge base is then created. Click on **Synchronize** to import the selected contents.

***

## Synchronize and maintain your data sources <a href="#h_5d89b7b5a1" id="h_5d89b7b5a1"></a>

Each data source has a synchronization status visible from its knowledge base.\
This status changes according to progress: *site extraction*, *start of synchronization*, *synchronization in progress*, then *synchronized*.

You can restart a synchronization at any time, especially after:

* a website or file update;
* adding new documents or segments;
* or any major change to the initial content.

A Synchronize button is available in the table showing the data sources of a knowledge base, and also at the top right when you view the content of a data source.\
​

***

## Browse the contents of a knowledge base <a href="#h_8c75ca7bfd" id="h_8c75ca7bfd"></a>

When you enter a knowledge base, you find the table of all the data sources that make it up, with the following information:

| Column               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                 | Data source name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Type                 | Type of the data source (Website, Documents, Segments or Notion)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Content              | The number of items contained in the data source. For websites, this is the number of synchronized pages on the website. For Documents or Segments, it is the number of existing items.                                                                                                                                                                                                                                                                                                                                                                                                       |
| Last synchronization | <ul><li>Displays the "Synchronize" button if your data source has never been synchronized.</li><li>Displays the date of the last synchronization if your data source has already been synchronized</li><li><p>Displays the progress status if a synchronization is in progress:</p><ul><li>Start of synchronization</li><li>Website extraction (website only)</li><li>Synchronization in progress</li><li>Synchronization failed</li></ul></li></ul><p>For a source that has already been synchronized, the Synchronize button appears when you hover over the last synchronization date.</p> |
| Synchronization      | <p>Indicates whether the file data source is "Synchronized" or "To synchronize".</p><p>If the data source is "To synchronize", it means that content has been added or modified since the last synchronization. These changes will not be taken into account until the data source is synchronized again.</p>                                                                                                                                                                                                                                                                                 |
| Created by           | User who created the data source                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Creation date        | Date the data source was created                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

Click on a Data source to browse its contents.

The Synchronize button and the Last synchronization date are displayed at the top right.

The table displays content information according to their type:

Website

| Column       | Description             |
| ------------ | ----------------------- |
| Name         | The web page name       |
| URL          | The URL of the web page |
| Last updated | The last update date    |

Files

| Column          | Description                                                                                                                                                                                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name            | The file name                                                                                                                                                                                                                                                                         |
| Type            | File type/extension                                                                                                                                                                                                                                                                   |
| Created by      | User who added the file                                                                                                                                                                                                                                                               |
| Creation date   | Date the file was added                                                                                                                                                                                                                                                               |
| Synchronization | <p>Indicates whether the file is "Synchronized" or "To synchronize".<br>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 synchronize".</p> |

\
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 import 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

| Column          | Description                                                                                                                                                                                                                                                                                   |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name            | The segment name                                                                                                                                                                                                                                                                              |
| Last updated    | The date the segment was last updated                                                                                                                                                                                                                                                         |
| Created by      | User who created the segment                                                                                                                                                                                                                                                                  |
| Creation date   | Date the segment was created                                                                                                                                                                                                                                                                  |
| Synchronization | <p>Indicates whether the segment is "Synchronized" or "To synchronize".<br>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 synchronize".</p> |

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.

***

### Organization best practices <a href="#h_67df0ccabe" id="h_67df0ccabe"></a>

To ensure the consistency and performance of your knowledge bases, it is recommended to structure your sources clearly and consistently.

A good practice is to create one knowledge base per business brand or establishmen&#x74;*.*

\
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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fullwhere.com/documentation/documentation-en/automations/knowledge-bases.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
