Skip to main content
Knowledge Bases

Attach Knowledge to Agents and Choose an Answering Mode

Attach knowledge bases to VAW Native agents from either side, and choose whether each agent gets everything up front or looks things up when asked.

Written By voiceaiwrapper

Last updated 26 days ago

A knowledge base does nothing until an agent is attached to it. Once attached, the agent can answer callers from your documents instead of guessing. You can attach from either side: from the agent, or from the knowledge base. For each attachment you also choose an answering mode, which decides whether the agent reads the whole knowledge base up front or looks things up as questions come in.

Applies to: VAW Native Pods. For Vapi, Retell AI and ElevenLabs, see Provider Knowledge Bases and Tools in VoiceAIWrapper.

Before you start

Attaching a knowledge base uses AI credits. While Knowledge bases on calls is on, each call to an agent with a knowledge base attached costs an extra 5 AI credits per minute of answered call time, whether or not the knowledge base is used on that call. In chats, it's an extra 0.5 credits per agent reply. See Credit History and Per-Call Costs.

Limits:

LimitValue
Knowledge bases per agent5
Agents per knowledge baseNo separate limit. Each agent still counts toward its own 5.

Option A: Attach from the agent

Use this when you're setting up one agent.

  1. In the sidebar of your VAW Native Pod, open Agents and click the agent.
  2. Open the Knowledge tab. The Knowledge base card shows how many are attached, for example "2 of 5 attached".
  3. Click Attach. The Attach knowledge bases panel opens.
  4. Tick the knowledge bases this agent should answer from. You can search by name. Each one shows how many documents it has and how many agents already use it.
  5. Click Done. New rows show attaches on Apply.
  6. On each row, choose an answering mode from the dropdown (see "Choose an answering mode" below).
  7. Click Apply in the yellow bar. You'll see "Knowledge bases updated".
Agents β†’ open an agent β†’ Knowledge tab, showing the Knowledge base card with "2 of 5 attached", the Attach button, two attached knowledge bases (one with an "attaches on Apply" badge), the answering-mode dropdown opened on one row so all three options and their descriptions are visible, and the yellow bar "Applies immediately. Not part of the agent Save." with Discard and Apply.

The Knowledge tab saves separately from the rest of the agent. Its yellow bar says "Applies immediately. Not part of the agent Save." Clicking the agent's main save button doesn't save knowledge changes, and Apply doesn't save other unsaved agent edits.

To detach a knowledge base, click the X on its row, then Apply. Changed your mind before applying? Click Undo on the row, or Discard to drop all pending changes.

If a row shows No content yet, that knowledge base has no documents. The agent can be attached to it, but it won't find anything until you add some.

Option B: Attach from the knowledge base

Use this to give one knowledge base to several agents at once, for example a shared FAQ.

  1. Open Knowledge Base and click the knowledge base.
  2. Open the Agents tab.
  3. Click Assign agents. The Assign to agents panel opens.
  4. Tick the agents that should answer from this knowledge base, then click Done.
  5. Choose an answering mode for each agent from its dropdown.
  6. Click Apply in the yellow bar ("Not saved yet. Apply and it takes effect on the next call."). You'll see "Agents updated".
Knowledge Base β†’ open a knowledge base β†’ Agents tab, with two agents listed, each with its mode dropdown, the Assign agents button, and the Assign to agents sheet open on the right showing the agent checklist with one agent marked "No slots left".

An agent that already uses 5 knowledge bases shows No slots left and can't be ticked. Detach one on that agent's Knowledge tab first. If the Pod has no agents yet, Assign agents is greyed out.

To stop an agent using this knowledge base, click the X on its row, then Apply.

Both screens edit the same link. A change made on one shows up on the other.

Choose an answering mode

The mode belongs to each agent-and-knowledge-base pair. The same knowledge base can be given in full to one agent and looked up by another.

ModeWhat the agent doesGood for
Automatic (recommended)We decide based on the knowledge base's size: small ones are given in full, larger ones are looked up.Almost every case.
Give the agent everythingThe agent has the full text of every document from the start of each call.Short, dense material where any detail might matter, such as a one-page price list. Uses more resources.
Look things up when askedThe agent searches the knowledge base during the conversation and uses only the passages that match.Large knowledge bases, such as a whole site or a long handbook. Can be slightly slower to answer than Give the agent everything.

The dropdown shows a short name for the chosen mode: Automatic, Give everything or Look things up.

The size limit for giving everything

Automatic only gives a knowledge base in full while it's under a size ceiling of about 20,000 tokens (very roughly 80,000 characters of text). Above that, an agent set to Automatic looks things up instead.

You don't need to work out the size yourself. When a knowledge base is too large:

  • The knowledge base shows "This knowledge base is too large to put in front of the agent all at once. Agents set to Automatic will look up the relevant parts when a caller asks instead."
  • Each Automatic row shows "Too large to hand over in full, so this agent looks things up instead."

The ceiling is shared by everything one agent is given in full. The agent's knowledge bases are taken in the order you attached them. Each one on Automatic is given in full only if it still fits in what's left of the ceiling; otherwise it's looked up. The row message above only checks each knowledge base on its own, so it doesn't warn you when several small knowledge bases add up to more than the ceiling.

If you choose Give the agent everything, the agent gets the full text whatever its size, and that knowledge base still uses up its share of the ceiling. Large full-text knowledge bases use more resources on every call, so use Automatic unless you have a reason not to.

When an agent looks things up, Results per question and Match threshold on the knowledge base's Settings tab decide what it finds. See Tune Retrieval: Results per Question and Match Threshold.

When changes take effect

Changes apply as soon as you click Apply. The next call uses them. Calls already in progress keep the knowledge bases and answering modes they started with.

Frequently asked questions

Yes. The AI Agent Builder lets you add your site, files or text to a new knowledge base, or pick existing ones, as part of creating the agent. See Create an Agent with the AI Agent Builder.

Check that:

The agent already has 5 knowledge bases attached, the maximum. Detach one, click Apply, then attach the new one.

They carry on working without it. Deleting removes the documents and everything built from them, including the original files, and can't be undone.

Only if you allow it. Client permissions on VAW Native workspaces control whether a client sees the agent's Knowledge tab, can attach knowledge bases, and can see or change the answering mode. See Set Client Permissions on VAW Native Workspaces.