> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vivi.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Documents

A **document knowledge base** allows you to store and retrieve information from files, notes, or manually created text. Documents are indexed using VIVI’s RAG.DB system, which breaks content into small chunks and applies cosine similarity scoring to return the most relevant results. Document knowledge bases are ideal for structured reference content, reference material, and any knowledge you want your agent to use consistently.

***

## Set Up

Navigate to the **Knowledge Base** tab and click **Add New**. Select **Document** from the Category dropdown menu and fill in the sections marked as required.

<video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/ksg-ea85c748/ODM9ksCR8GZibnmp/videos/vivi_documents.mp4?fit=max&auto=format&n=ODM9ksCR8GZibnmp&q=85&s=c20b5272f23e526abd6993895e7f42e9" data-path="videos/vivi_documents.mp4" />

Once a document knowledge base is created, index provisioning begins automatically. A status banner at the top of the page will display the current status of the index. Once provisioned successfully, you can add your documents. There are three ways to add documents into VIVI:

<Columns cols={3}>
  <Card title="Cloud" icon="cloud-arrow-up" iconType="regular" color="#0066ff">
    Connect VIVI directly to your cloud storage provider. We support *Google Drive, Dropbox, OneDrive Personal* and *OneDrive Work/School*.
  </Card>

  <Card title="Created" icon="pen-to-square" iconType="regular" color="#0066ff">
    Write and save new documents directly in VIVI using the built-in editor. This is perfect for quick FAQs or guides.
  </Card>

  <Card title="Uploaded" icon="upload" iconType="regular" color="#0066ff">
    Add files directly from your computer into VIVI using either your *Browser* or *Storage Explorer via Azure* for large files.
  </Card>
</Columns>

Once your documents are imported, they will begin the indexing process. The banner at the top of the document knowledge base updates in live time to indicate the status of the indexer and your documents. This includes the number of documents processed, processing, or failed during ingestion.

***

## Best Practices

* **Organize content into folders** to maintain organization structure.
* **Verify indexing status of documents** to ensure files show as `Processed` before use in production.
* **Write clear, informative descriptions** to help your agents use your knowledge base properly, such as what topics are contained and when the agent should use it.
