Skip to main content
Knowledge Bases

Create a Knowledge Base and Upload Files

Create a knowledge base for a VAW Native Pod and upload PDF, Word, text, Markdown, HTML or CSV files for your agents to answer from.

Written By voiceaiwrapper

Last updated 26 days ago

Give your agents reference material by creating a knowledge base and uploading the documents you already have: price lists, product sheets, FAQs, handbooks and policies. Once a file is read, any agent you attach the knowledge base to can answer from it.

Applies to: VAW Native Pods. Vapi, Retell AI and ElevenLabs Pods show their own knowledge bases read-only. See Provider Knowledge Bases and Tools in VoiceAIWrapper.

Before you start

  • A VAW Native Pod with fewer than 25 knowledge bases.
  • Your files in a supported format (see the table in Step 2), each up to 25 MB.
  • PDFs with real text in them. If you can't select the text in a PDF viewer, it's a scanned image and can't be read.

Step 1: Create the knowledge base

  1. Open your VAW Native Pod in the sidebar and click Knowledge Base.
  2. Click New knowledge base. If you don't have any yet, click Create a knowledge base in the middle of the page.
  3. Enter a Name that says what it covers, such as Pricing or Support FAQ.
  4. Optionally, fill in Description (optional). It's for your team only. Agents never see it.
  5. Click Create.
The New knowledge base sheet opened from Knowledge Base β†’ New knowledge base, with Name filled in as "Pricing" and Description (optional) filled in as "Plans, billing and refunds", and the Create button enabled.

You'll see Knowledge base created, and the new knowledge base opens on its Documents tab.

Choose the name before you add documents. It's written into every passage the agent reads from this knowledge base, so a clear name like "Pricing" helps the agent find the right answers. You can rename it later on the Settings tab, but documents that were already read keep the old name until they're read again.

Step 2: Upload a file

  1. Click Add to knowledge base (top right, or in the middle of an empty knowledge base).
  2. Make sure File is selected.
  3. Click Choose a file and pick a file from your computer.

The upload starts as soon as you pick the file, and the box shows Uploading.... When it's done you'll see File queued and the sheet closes. Repeat for each file you want to add.

A knowledge base page with the Add to knowledge base sheet open on the File option: the File / Web address / Paste text switcher with File selected, the dashed Choose a file box with the formats line, the CSV note below it, and the "n of 200 documents" count in the sheet description.

Supported files

FormatFile typesHow it's read
PDF.pdfAs text. Tables lose their columns. Scanned PDFs with no text layer can't be read.
Word.docxText, plus any Word tables as tables. Older .doc files aren't accepted.
Plain text.txtAs text.
Markdown.md, .markdownAs text. Headings and pipe tables are recognised.
HTML.html, .htmThe main content only. Menus, headers and footers are dropped.
CSV or TSV.csv, .tsvAs a table, one record per row, with the first row as the column names.

Each file can be up to 25 MB, and a knowledge base can hold up to 200 documents. The sheet shows how many you've used.

For price lists, product catalogues and anything else with rows and columns, upload a CSV. A table inside a PDF is read as plain text and loses its columns, which makes single-row questions ("How much is the BH74?") harder to answer.

Step 3: Wait for the file to be ready

Each file goes from Waiting to Reading to Ready. The page updates by itself while files are being read, so you don't need to refresh.

The Documents tab groups files by what, if anything, you need to do:

  • Needs your attention: something went wrong. Hover over the status, or click the question-mark icon, to see why.
  • Being read: still in progress.
  • Answering questions: ready to use.

The Read as column shows what was made of each file: Read as text, Read as a table or Text and tables. Check that a price list says Read as a table.

Files never sync on a schedule, so Last synced shows a dash. A file only changes when you replace it.

The Documents tab after uploading a PDF and a CSV price list: both rows under Answering questions with Ready badges, the PDF showing Read as text and the CSV showing Read as a table, and a dash in the Last synced column.

Step 4: Attach it and test it

A knowledge base isn't used until it's attached to an agent.

  1. Attach it from the agent's Knowledge tab or the knowledge base's Agents tab. See Attach Knowledge to Agents and Choose an Answering Mode.
  2. Ask it a few questions on the Test tab before going live. See Test Your Knowledge Base.

Attaching a knowledge base adds a per-minute AI credit charge to that agent's calls, and a small charge per chat reply. See the cost section of How Knowledge Bases Work.

Update or remove a file

You can't edit an uploaded file in place. To update one, remove it and upload the new version.

  • Download the original with the download icon on its row.
  • Remove it with the bin icon, then click Remove to confirm. Your agents stop being able to answer from it.

Removing a file also deletes the original we stored. It can't be undone, so download a copy first if you don't have one.

If you change the same short text often, consider pasting it instead. Pasted text can be edited in place. See Add and Edit Pasted Text.

Troubleshooting

The file's extension isn't on the list above. Convert it first:

  • Old Word .doc files: save as .docx.
  • Excel or Google Sheets: export as CSV.
  • Slides, images and other formats: export or save as PDF (with real text, not images of text).

Split the document into smaller files, or remove images from it and export again. Images aren't read, so they only add size.

The file had no text we could read. This is almost always a scanned PDF (a picture of a page). Run it through a text-recognition (OCR) tool and upload the result, or copy the text and use Paste text instead.

Tables inside PDF files are read as plain text. Remove the file, export the table as CSV (or a Word .docx table), and upload that.

Remove documents you no longer need, or create a second knowledge base and attach both to the agent (up to 5 per agent). Pages from a site crawl count toward the 200, including pages that were left out.

The Pod already has 25 knowledge bases. Delete one you no longer need first.

For other statuses, see Document Statuses, Syncing and Failed Documents.