Early-bird bonus: 30% extra credits.

AI voice agent knowledge base in 2027: answer calls and email from your documents

An AI voice agent knowledge base is the set of documents your agent answers from. You give it your manuals, FAQs, product sheets, and spreadsheets. Customers get the right answer at any hour, and your team stops answering the same questions.

View .md

Your team answers the same questions every day. What does the warranty cover? Which filter fits my model? Is my serial number on the recall list? The answers are already in your documents. An AI phone agent can read them and answer for you, on calls and by email.

This guide shows which documents to give your agent and how to keep them up to date. It also shows how to test the agent with real questions, and when it should pass the call to a person.

What is an AI agent knowledge base?

A knowledge base is the set of documents an AI agent reads before it answers. Think of it as the agent's reference shelf. With a voice agent, the shelf holds your manuals, product sheets, FAQs, price lists, and spreadsheets.

The agent does not guess from the open internet. It answers from the files you give it. When a fact changes, you replace the file. The next call uses the new answer.

This is different from the agent's instructions. Instructions say how the agent behaves: be brief, ask one question at a time, pass angry callers to a person. The knowledge base says what the agent knows: the facts about your products and your rules.

How an AI phone agent answers from your documents

Here is what happens when a customer calls your number:

  1. A customer calls and asks a question

  2. The agent finds the part of your documents that answers it

    • Found: it answers in plain words
    • Not found: it says so and offers a person
    • Hard or upset: it passes the call to your team
  3. You read the call in Activity and fix any gap in your documents

An email works the same way. The agent reads the question, finds the answer in the same documents, and replies in the same thread.

Say a caller from Toronto asks if the Example Heaters HX-40 works on a 120-volt line. The agent finds the voltage in the HX-40 product sheet and answers in one sentence. No hold music, no callback.

What documents to give your AI agent

Start with the documents your team opens most often to answer customers. This table shows good first picks:

DocumentWhat customers askHow to prepare it
FAQ pageHours, returns, shipping, warrantyKeep one question and one answer per item. Remove old answers.
Product sheetsSizes, voltage, parts that fit, what is in the boxOne product per sheet. Put the model name at the top.
User manualsHow to set up, reset, or clean a productKeep the steps numbered. Remove pages that are only pictures.
Price listWhat a product or a service costsAdd the date and the currency, such as USD or GBP.
Product or serial number spreadsheetIs my unit on the recall list? Which version do I have?One row per item and one header row. Use the same ID format as your labels.
PoliciesRefunds, warranty claims, delivery areasWrite what the agent may promise and what needs a person.

Spreadsheets are where the agent saves your team the most time. A caller reads out a serial number, and the agent finds the exact row. It then reads out the facts in that row: the model, the version, or the recall status.

Save spreadsheets as CSV files. CSV is a plain spreadsheet file that any spreadsheet app can export. Save manuals and product sheets as PDF files.

Leave out anything you would not tell a stranger on the phone. Caller ID can be faked, and anyone can read a serial number off a label. So keep product facts only. Leave out names, addresses, purchase dates, passwords, and private notes.

How to create a knowledge base for an AI agent

You can set this up in the Hail console without code. Or connect Hail MCP to your AI assistant. Then ask it to build the agent and add your files.

  1. List the top 20 questions. Ask your team, or read your last month of support email. These questions decide which documents matter.
  2. Gather the documents that answer them. Use the table above. Skip a document if no customer question needs it.
  3. Clean them up. Remove old prices and products you no longer sell. Put each fact in one place, so two files never disagree.
  4. Create the agent. Start from the customer support template or follow the console walkthrough.
  5. Add your documents to the agent. Upload each PDF and CSV file to the agent you just made.
  6. Tell the agent how to use them. Add rules like the template below to its instructions.
  7. Add a person to call. Pick who takes the calls the agent cannot answer. See when to pass the call to a person.
  8. Connect a phone number and an email address. Turn on calls and email for the agent, and pick its number. Then choose the agent for your email address under Email domains, in Agent replies.
  9. Test it. Use the test checklist before you share the number.

In a hurry? Paste your short FAQ straight into the agent's instructions. Upload the longer files after your first test.

Copy these rules into the agent's instructions. Replace the capitalized words with your details. PERSON is your handover contact. SUPPORT NUMBER is the phone number where email customers can reach your team. Use a number that a person answers, not the agent's own number.

You answer calls and email for BUSINESS NAME. Answer only from the documents you were given. If the documents do not answer the question, say so. On a call, offer to pass the caller to a person. When the answer depends on a serial number or product code, ask for it. On a call, read it back before you look it up. Give the answer in one or two short sentences. Offer more detail if the customer wants it. Never share private notes, account details, or anything that is not in the documents. On a call, pass the caller to PERSON when they are upset, ask for a refund, or ask for a person. By email, when you have no answer or the customer needs a person, give them SUPPORT NUMBER.

Test your AI agent with real questions

Test with questions your customers really ask, in the words they use. Call from another phone, and send a few emails too.

When an answer is wrong, fix the document, not the instructions. Then ask the same question again.

Keep your knowledge base up to date

An agent is only as current as its files. Old files give old answers, and customers trust them.

  • Name one owner. One person on your team keeps the files current.
  • Replace a file the day a fact changes. A new price, a new product, or a new policy means a new file. Remove the old one.
  • Add updates to your launch steps. Before a product goes on sale, its product sheet goes to the agent.
  • Read the calls each week. Look for questions the agent could not answer. Each one is a gap to fill.
  • Export the spreadsheet again. When you add serial numbers or products, upload the new CSV file in place of the old one.

When to pass the call to a person

Some calls need a person. Set this up before you go live, so no customer gets stuck with the agent.

Pass the call when:

  • the caller is upset, or asks for a person;
  • the answer needs a decision, such as a refund or a repair outside warranty;
  • the documents do not have the answer, and the caller needs it now;
  • the caller wants to change an order or an account.

In Hail, you can list up to 10 people for the agent to call. Each one gets a short note that says when to call them. While their phone rings, the person gets a text and an email with the caller's number and the reason. They have 30 seconds to answer. If nobody answers, the agent comes back and offers to take a message.

The text alert from a US number to a US number needs US texting registration. The email alert needs a verified email domain and an email address for the person you call. The warm transfer guide explains the handover step by step.

Answer email from the same documents

The same agent can answer your support email inbox from the same documents. You keep one set of files for calls and email.

  • Start with your team. A new email route answers only verified members of your workspace. Test with your own team first.
  • Then open it to customers. Choose "Anyone who emails this address" when the replies look right. Any sender can then make the agent use its tools. Before you switch, open the agent in Agents. Under Actions and limits, in Tools, turn off what a stranger should not trigger. For example, turn off Send an email to a team member and Send a text to the caller. The same tools apply to calls.
  • Replies stay in the thread. The agent answers the sender once, in the same email thread.
  • It skips the noise. It never answers spam, auto-replies, mailing lists, or no-reply senders.
  • It has a limit. The agent sends at most 20 messages to one sender in any 24 hours.
  • The sender must be real. The email must pass a DMARC check. DMARC is the check that proves an email came from the domain it claims.

The email inbox template guide shows each email setting with screenshots.

AI agent knowledge base best practices

  • One fact, one place. Two files that disagree give two different answers.
  • Write for the ear. Short sentences read well on a call. Long tables do not.
  • Exact IDs in spreadsheets. Use one column for the serial number or product code, in the same format as the label.
  • Dates on everything. Put the date at the top of price lists and policies.
  • Public facts only. Leave out passwords, private notes, and customer records.
  • Test after each change. Ask the question again after you replace a file.

Want more ideas for the calls an agent can take? Read the AI phone agent guide and the call center automation guide. To see what else Hail does on calls and email, read the voice and email pages.

AI voice agent knowledge base FAQ

Do I need to train the AI on my documents?

No. You do not train a model. You add your documents to the agent, and it reads the right part when a question comes in. When you replace a file, the next call uses the new version.

Which file types can I add?

Use PDF files for manuals, product sheets, and policies. Use CSV files for spreadsheets, such as a product list or a serial number list. Most spreadsheet apps can save a sheet as a CSV file.

Can the agent look up a serial number in a spreadsheet?

Yes. Give it a CSV file with one row per item and a header row. When the answer depends on a serial number, the agent asks for it and finds the exact row. On a call, it reads the number back first. If the number is not in the file, it says so.

Will the agent make up answers?

Sometimes, if you let it. Tell it to answer only from your documents. When it has no answer on a call, it should offer a person. By email, it should give your support number. Then test it with questions your documents do not cover.

Can I paste my FAQ into the instructions instead?

Yes. Pasting a short FAQ into the agent's instructions is the fastest way to start. Move longer manuals and spreadsheets into documents, so the instructions stay short.

How often should I update the knowledge base?

Update a file on the day its fact changes. Read the agent's calls each week to find questions it could not answer.

Can callers in other countries use it?

Yes. Hail supports 39 call languages, and each agent uses one language. For callers in Germany, add a German agent and number next to your English one. Give the German agent your German documents when you have them.

Does it replace my support team?

No. It answers the repeat questions at any hour, so your team has time for the hard ones. Calls that need a decision still go to a person.

How much does it cost?

You pay for call minutes, phone numbers, and messages. See the current rates on the pricing page.

Make your first call.

Connect your assistant and start calling.