Skip to content

Knowledge — Lookup sources ​

Lookup sources are the knowledge bases the agent searches when the conversation calls for it. They sit in the right column of the Knowledge panel.

By the end of this guide you will know how to add and remove bases, and what to put in them instead of in the fixed facts.

Before you start ​

  • At least one knowledge base created under AI Employees → Libraries. This panel doesn't create bases — it picks from the ones that already exist.

What to put here ​

Long text and long-tail questions: FAQ, warranty policy, manual, detailed tables, catalog, documents.

The search is semantic: the agent writes the question the way the customer asked it and gets back the closest excerpts. It decides on its own when to search.

If the data is short and critical — address, hours, list prices — it belongs in the Fixed facts, not here: the search may not find it, and then the agent answers without the data.

Adding and removing ​

Add — click + Add base and choose from the account's available bases. The list shows the number of items in each one.

Remove — the ✕ at the end of the row takes the base off this agent. The base still exists; it just stops being searched here.

Create — the footer of the picker leads to Libraries, where bases are created and filled. Creating a base is a job for that screen, not this one.

The list shows only this agent's bases. If it is on the list, it is active.

Several sources don't cost more ​

Turning on more bases doesn't increase the cost or the response time. The search has a global limit of excerpts: five bases return the same number of excerpts as one. What changes is the chance of finding it.

This is the opposite of fixed facts, where every line added weighs on every message.

What it costs in credits ​

The AI credit follows the size of the reply and what it did, not how many bases there are:

  • By size — 1 credit up to 4 thousand input tokens in the turn, 2 above 4 thousand, 3 above 8 thousand. This includes the agent's prompt, the fixed facts, the history and what the search brought back.
  • Searched the base — the reply costs at least 2 when the agent searched the sources before answering (one or several searches in the same turn count once).
  • Read a whole item — at least 3, in the rare cases where the search brought back a cut-off excerpt and the agent opened the full item.

The higher of the two always applies. A library set to Whole library in the prompt (in the library's Settings) doesn't trigger a search, but its content counts toward the size of every reply. A simple question answered off the top of its head, with a short prompt, still costs 1.

The primary base ​

When there is more than one base, the first one is marked as primary. It is the agent's reference base for operations that need a single destination.

The order comes from the sequence in which the bases were added.

How to know it worked ​

  • The base appears on the list, with its item count.
  • In the menu, Knowledge shows the number of sources.
  • In Test, ask a question that only the document answers. Below the message the line "searched [base name]" appears — it's the confirmation that the search ran.

Common problems ​

The base is on the list but the agent never searches it. Cause: the Search knowledge base action is off. How to check: open the Actions panel and check. Solution: turn it on — without it the agent has no way to search, no matter how many bases are linked.

The agent searches and doesn't find what is in the document. Cause: the search is semantic and depends on the excerpt existing in a recognizable form. How to check: in Test, repeat the question using the words that are in the document. Solution: if it works that way, the content exists but is worded far from the way the customer asks — it's worth adding a direct question and answer to the base.

I can't find the base I created. Cause: the platform's shared bases can't be linked from here. How to check: open Libraries and see whether the base belongs to your account. Solution: duplicate the content in a base of your account.

GetRaze - AI-Powered Lead Generation