You can give an AI phone agent on Bland a knowledge base by adding a file, a website, a block of text, or a synced document, attaching it to your agent, and testing what it retrieves, with no code. Bland's knowledge guide sets out each step.
Knowledge is how an agent answers from your content rather than from its prompt, so a caller who asks which plans you take hears an answer read out of your documents. On Bland, knowledge means the same thing as a knowledge base.
What do you need before you start?
You need a Bland agent to attach sources to, and building your first AI phone agent covers creating one. You need the content you want your agent to answer from.
For a synced document, you need an account already linked under Connections.
How do you add knowledge to an AI phone agent?
You add knowledge on Bland in two moves: add a source, then attach it to your agent. Each thing you add is a source.
- Open Knowledge. At All agents it sits under Resources in Bland's sidebar, and inside an agent it sits under Build.
- On the Sources tab, press Add sources. A dialog opens with four kinds along the top: Upload, Website, Text, and Integration.
- Add your content for the kind you picked. Upload, Website, and Text carry a Description field, and Integration takes only a name.
- Upload: drag files in, or click to pick them. Bland accepts PDF, TXT, CSV, JSON, and DOCX, up to 10 MB each and 10 files at a time. Each file becomes its own source.
- Website: Discover from a site takes a domain, reads its sitemap, and comes back with everything it found, all selected, so turn off what you do not want and add the rest. Or paste URLs into the field under it, separated by spaces or commas. The whole list becomes one source, so name it for the site.
- Text: paste content directly. This one needs a name.
- Integration: pick a document from an app you have connected: today, a Notion document or a Google Doc.
- Wait for processing, because your source is not searchable until it finishes and the Status column tells you where it is.
- Attach it. Switch the sidebar selector to your agent, open Knowledge, and check that the environment selector in the top bar reads Development, the environment you edit.
- Check the sources your agent should use.
- Save with the floppy disk icon beside Add sources. Nothing is attached until you press it.
You can attach a source by typing @ in your agent's prompt and picking it from the list, which writes the tag for you, whereas typing that text attaches nothing. Like any other edit, an attached source reaches a live call when you publish and promote.
How do you test what your AI phone agent retrieves?
Bland's Source testing tab answers a question the way your agent would, before a caller asks it. Save first, because inside an agent the picker starts with whatever is checked on the Sources tab, including checks you have not saved yet, and a passing test would prove nothing about the agent you ship.
- Open the Source testing tab and pick your sources in the bar at the bottom.
- Type a question and press Enter.
- Open Show diagnostics under the answer.
Bland's diagnostics are Generated query, which is what it actually searched for, Gap evaluation, which reads answerable or gap with a reason, and Retrieved chunks, the passages it found in the order retrieval ranked them, usually with a score.
A low score on the top chunk means the wording in your source and the wording of the question are too far apart. When the tester decides a question is a gap, a banner offers to answer it on the spot: you write the answer and pick a source to keep it in.
What can go wrong?
Knowledge on Bland can fail in a few common ways, and each has a fix.
- The agent answers as though the source does not exist. Check your agent's Sources tab. An unchecked row is not attached, and a checked row you never saved is still not attached.
- It is attached and still never gets used. Your agent decides whether to search a source from its name and description, and only the name can be changed afterwards. Rename it first so the name says what is in it, in the words a caller would use.
- Save fails and says the agent was updated somewhere else. On a published environment the checkboxes look editable and the save is rejected. Switch to Development, check the sources there, and save again.
- A source came off an agent on its own. Deleting the last
@tag of a source detaches it, so someone edited a prompt. Re-check the row and press Save. - It retrieves the wrong passage. A low score means your source does not use the caller's words, so rewrite that passage in them. A good score on the wrong passage means the source covers two things at once, so split the second one into its own source.
How do you keep your agent's knowledge current?
On Bland, you keep your agent's knowledge current with three tabs: Questions, Query logs, and Knowledge map.
Questions collects what callers asked and your agent could not answer, with a count of how often each came up, and answering one writes it into a source you choose. Query logs records every retrieval, so when a caller got a bad answer, you can open that call's row and see what your agent searched for.
Knowledge map shows which sources carry the questions over 30 days, with red for a source that is being asked and failing. A website source stays current with Sync now or a daily auto-sync switch.
Norm, Bland's AI assistant, works with knowledge too: Norm can edit an existing agent, including its knowledge, and you can upload files or attach your existing knowledge bases for Norm to reference when it builds or edits.
Testing an AI phone agent in your browser, testing before launch, and connecting HubSpot are the next how-tos, and the no-code AI call center guide and no-code AI phone agents hub cover the rest.
Idaho Housing and Finance Association saves $750,000 a year by replacing its IVR with Bland, which handles 4,000 inbound calls a day and cut average call time by 20%.
"We save thousands of dollars a day."
Greg Blake, Chief Information Officer, Idaho Housing and Finance Association
Frequently asked questions
Does Bland have a no-code option?
Yes. Norm, Bland's AI assistant, builds voice agents using natural language descriptions, and Bland's dashboard includes a visual builder for non-technical users.
What can I add to an AI phone agent's knowledge base on Bland?
You can add a file, a website, a block of text, or a synced Notion document or Google Doc. Bland calls each one a source, and a file upload accepts PDF, TXT, CSV, JSON, and DOCX.
Do I need a developer to give my Bland agent a knowledge base?
No. On Bland, you add sources and attach them to your agent with no code, and Norm can edit your agent's knowledge too.
Does adding a source give it to my Bland agent?
No. Adding a source on Bland does not give it to an agent. Check it on your agent's Sources tab and press Save, or pick it from the list after typing @ in your agent's prompt.
How do I see what callers asked that my Bland agent could not answer?
Open the Questions tab. Bland collects those questions with a count of how often each came up, and answering one writes the answer into a source you choose.
