What is Vault & What File Format is Supported?

Modified on Wed, 15 Jul at 6:44 PM

The Vault is FlexiAgent's centralized knowledge base — the place where you store the business documents your AI agents use to answer customer queries. Instead of adding business information directly to each agent, you upload your knowledge files to the Vault and connect them to the appropriate agent.


Think of the Vault as your Google Drive or your computer's file storage. Just like you keep all your important documents organized in folders on Drive — and share the right folder with the right person — the Vault organizes and manages all the files your AI agents need to do their jobs.

The Vault section in FlexiAgent showing the Knowledge Vault with the folder panel and content-type filters

How the Vault is Organized

The Vault follows a simple folder-based structure.

At the top level is your Tenant folder, which represents your FlexiAgent account. Inside the Tenant folder, you can store multiple knowledge files that are associated with different AI agents. For example:

Tenant
│
├── Olive Sales
│     └── Discount Plumbing.md
│
├── Support Agent
│     └── FAQ.md
│
├── Marketing Agent
│     └── Campaign Details.md
│
└── HR Agent
      └── Company Policies.md

In the Vault, this structure appears in the left panel — starting with the tenants folder, with your account's folder inside it:

The Vault folder panel showing the tenants folder with the account folder inside it

Each agent can have one or multiple knowledge files connected to it.

Why Does an AI Agent Need the Vault?

Your AI agents are already configured with their behavior and responsibilities. For example, a Sales Agent already knows:

  • How to communicate with customers
  • How to ask qualifying questions
  • How to guide a sales conversation
  • How to respond professionally

However, the agent does not automatically know information about your business.

✅ Why this mattersThink of a new employee on their first day. They already know how to do their job — how to talk to customers, how to be polite, how to sell. But they don't yet know your prices, your products, or your refund policy. The Vault is the employee handbook you hand them. Business-specific information — products, services, pricing, policies, and FAQs — must be provided through the Vault. Without it, even a perfectly configured agent can only give generic answers.

When a customer asks a question, the AI agent retrieves the relevant information from the connected knowledge files and uses it to generate an accurate response.

Uploading Knowledge Files

To add business information to an agent:

  1. Open the Vault from the left sidebar (under Data).
  2. Click the + (Add) button in the top-right corner.
  3. Upload your knowledge file.
  4. Associate the file with the appropriate AI agent.

The Vault toolbar with the green + Add button in the top-right corner

In the upload window, choose the destination: select a specific Agent to connect the file to that agent — the recommended practice, so each agent has its own dedicated knowledge base. (A Shared option also exists for files meant to be available across agents.) Then drop your file in (or click to browse) and click Upload.

The Upload to Vault window with Shared or Agent destination options and the file drop area

You can upload:

  • A single knowledge file, or
  • Multiple knowledge files for the same agent

Each uploaded file becomes part of the agent's knowledge base.

Supported File Format

Currently, the Vault supports only one file format:

  • Markdown (.md)

Before uploading a document, ensure that it is saved with the .md extension.

⚠️ Important: Other formats are NOT supportedFiles in formats such as PDF (.pdf), Microsoft Word (.docx), Text (.txt), or Excel (.xlsx) are not supported for direct upload. If your business information is in any of these formats, convert the content into a Markdown (.md) file first, then upload it to the Vault.
? Tip: Creating a .md file is easier than it soundsA Markdown file is just a plain text file with a different extension. Open any text editor (Notepad on Windows, TextEdit on Mac in plain-text mode), paste your content, and save the file as my-business-info.md. You can also ask an AI assistant like ChatGPT or Claude to convert your document's content into Markdown format for you — then copy the result into a .md file.

Best Practices

To improve your AI agent's response quality:

  • Keep each knowledge file focused on a single topic. One file about pricing, another about refund policies — not everything in one giant file.
  • Organize information with clear headings and sections. Well-structured files help the agent find the right answer faster.
  • Keep your documents up to date. If your prices change, update the file — your agents will immediately start using the new information.
  • Use descriptive filenames like gym-membership-pricing.md instead of doc1.md for easier management.
  • Separate different business topics into individual Markdown files whenever possible.

Quick Answers

❓ "Can I upload my PDF or Word document directly?"No — the Vault currently accepts Markdown (.md) files only. Copy the content out of your PDF or Word document, paste it into a plain text editor, and save it with the .md extension before uploading.
❓ "Do I need a separate knowledge base file for each agent?"Yes — that's the recommended practice. Even if two agents work with the same products, create each agent's file separately, tailored to its responsibilities and conversation style: sales-focused content for the Sales Agent, support-focused content for the Support Agent. (A Shared destination also exists for files meant to be available across agents.)
❓ "How many files can one agent have?"An agent can have one or multiple knowledge files connected to it. In fact, splitting knowledge into several focused files (pricing, FAQs, policies) usually gives better answers than one huge file.
❓ "My agent is giving generic answers instead of using my business details."Check two things in the Vault: (1) your knowledge file uploaded successfully as a .md file, and (2) it's connected to the correct agent (or set to Shared). An agent can only answer from files it's actually connected to.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article