Lesson 5 of 10 · 10 min

AI training: knowledge base, FAQs, brand voice

Teach the AI the business: knowledge base, FAQs and brand voice.

Read the lesson

Goal: Teach the voice agent the business's facts, approved answers and voice. Then prove it with a scored test.

You need: The workshop sheet (lesson 2). Services built (lesson 4). The owner's written prices and emergency wording. Any plan; testing in the browser is free.

Why this matters

The agent can only say what it knows. If the knowledge is thin, it either says "I'm not sure" too often or fills the gap with a guess. A guess about price, hours or service area costs the owner money and trust.

Good training does three things. It gives the agent the facts. It gives it the exact words for sensitive answers. And it tells it how to sound like this business, not like a call center.

Most of the quality of an AI receptionist is decided here, not in the voice settings. Plan to spend more time on this lesson's work than on any other setup step.

The four layers of what the agent knows

Think of the agent's knowledge in four layers: identity and voice, rules, exact answers and background facts. Each layer has its own place in Voice Agents.

Fig 1

Four layers of agent knowledge

LayerWhat goes inWhere it lives
Identity and voiceName, greeting, tone, words to use and avoidBasics: Initial greeting, voice instructions, Voice
RulesWhat to book, transfer and never sayVoice instructions, Advanced instructions
Exact answersApproved prices, policies, emergency wordingKnowledge: Quick answers, Add FAQ
Background factsService details, areas, warranties, about usKnowledge: Knowledge sources, Manage sources
Use Quick answers when the words must be exact. Use Knowledge sources for facts.

Use Quick answers when the words must be exact. Use Knowledge sources when the agent needs facts but may phrase them freely.

Identity and brand voice

Start with the Initial greeting. It is the first thing every caller hears. Keep it to one or two short sentences. There is no separate AI-disclosure setting, so put the disclosure here if the client wants one. For example: "Thanks for calling Northside Plumbing. This is Sam, the virtual assistant. How can I help?"

Then write the voice instructions. The box takes up to 32,000 characters, but long is not better. Clear is better. Write in plain lines:

  • Who the business is and who it serves.
  • How the team talks. Friendly and short? Formal? Do they say "folks" or "customers"?
  • What the agent should do first on most calls.
  • What the agent must never do.

Listen to two or three real calls by the office, if the client has them. Copy the phrases the best person on the phone uses. That is the brand voice. Do not invent a personality the owner does not have. Callers can tell.

Pick the Language and the Voice. Eight languages are available: English (US, UK, Australia, India), Spanish (Spain, Mexico), French and Hindi. If many callers speak Spanish, ask the owner whether to offer it.

Rules: what to book, transfer and refuse

Write each rule as one plain line. Number them. Rules the agent can follow look like this:

  1. Book these services: the active list in Services.
  2. Do not book outside these towns: list them.
  3. If the caller describes a case on the owner's emergency list, read the owner's safety line, then transfer.
  4. Quote only prices in Quick answers. For anything else, say a tech will give the price on site.
  5. Never give repair steps or safety advice beyond the owner's approved line.
  6. Never agree to a discount.

There is no price-guard switch in the app. Rules 4 and 6 are the guard. Test them hard.

Emergency wording comes from the client. Each client writes its own, with its own advisors. You paste it in exactly. You do not edit it, and you do not supply your own.

Exact answers and background facts

In Quick answers, click Add FAQ for each question that needs exact words. Common ones:

  • What is your service call or diagnostic fee?
  • What areas do you serve?
  • What are your hours?
  • Do you offer financing?
  • Do you work on weekends?

In Knowledge sources, use Manage sources to add documents and the website. Uploads can be PDF, Word, Excel or text files, up to 10MB each. Good sources are the service descriptions, warranty terms and the "about us" page. Remove old price sheets first. An old PDF with last year's prices will cause wrong answers.

Use Website knowledge & answer testing to check what the agent learned from the site. Use Pronunciation help for town names and brand names the agent says wrong.

Fig 2

The Knowledge tab

What the agent knows

Quick answersExact words: fees, areas, hours, financing
Knowledge sourcesPDF, Word, Excel or text, up to 10MB each
Website knowledge & answer testingCheck what it learned from the site
Pronunciation helpTown and brand names
Add FAQ
Remove old price sheets before you add sources. An old PDF causes wrong answers.

Build it in ServiceAgent

  1. Open Voice Agents. Open the client's agent, or create one. Use template gives a starting point.
  2. In Basics, set Agent name, Language, Initial greeting and Voice.
  3. Paste the voice instructions. Add the numbered rules.
  4. In Knowledge, add each Quick answers entry with Add FAQ.
  5. In Knowledge sources, add the approved documents and the website. Remove anything out of date.
  6. Add Pronunciation help entries for local names.
  7. Open Test & publish. Use Practice conversation for typed tests. It makes no call and changes no records.
  8. Use Talk in browser for spoken tests. It is free and does not change customer records.
  9. Click Publish only when the scored test passes. Publishing updates live calls.
  10. Check it works. Run the 20-question test below and record the score.

The 20-question test

Write 20 test questions before you test. Use real call reasons from the workshop. Include:

  • 8 normal booking requests across the top services.
  • 4 price questions, 2 with approved prices and 2 without.
  • 3 questions about hours, area and policies.
  • 2 emergency cases from the owner's list.
  • 2 out-of-area or out-of-scope requests.
  • 1 discount request.
Fig 3Example numbers

The 20-question test mix

  • Booking requests8
  • Price questions4
  • Hours, area, policy3
  • Emergency cases2
  • Out of area or scope2
  • Discount request1

Questions20

Build hard cases into the test on purpose. A second person plays some callers.

Ask a second person to play some callers. You know the answers too well to test your own work fairly. Score each answer right or wrong. Right means the agent said what the owner would say, and did what the rule says. Fix every wrong answer at the cause, then retest that question and its neighbors.

When an answer is wrong, find which layer failed. Wrong fact: fix the knowledge source. Wrong words: add a Quick answers entry. Wrong action: fix the rule. Wrong service name: fix the service or the knowledge article, then test again.

Fig 4

Find the layer that failed

  1. An answer is wrong
  2. Was a fact wrong?YesFix the knowledge sourceNoNext question
  3. Were the words wrong?YesAdd a Quick answers entryNoNext question
  4. Was the action wrong?YesFix the ruleNoWrong service name: fix the service or article
  5. Retest in Practice conversation
Fix the cause, then retest that question and its neighbors.

The target before go-live is 20 out of 20. A receptionist who gets 1 call in 20 wrong is not ready either.

Worked example: Northside Plumbing

You train Northside Plumbing's agent and run the 20-question test in Practice conversation.

First run: 16 right, 4 wrong. Score: 16 / 20 = 80%.

QuestionWhat went wrongLayerFix
Drain clearing priceQuoted an old priceBackground factsRemoved the 2024 price PDF
Water heater flushCalled it a "tank repair"Exact answersAdded the service name to Quick answers
Caller in a town across the riverBooked itRulesListed served towns in the rules
Asked for 10% offSaid "I can check"RulesAdded rule 6 and a polite reply

Second run: 19 right, or 95%. The out-of-area caller was refused, but the agent did not offer a referral. You add the owner's referral line. Third run: 20 / 20 = 100%.

Fig 5Example numbers

Northside's test score by run

Run 116 of 20
Run 219 of 20
Run 320 of 20
Each run fixed causes, not answers. Every test cost 0 credits.

Cost of all this testing: 0 credits. Every test ran in Practice conversation and Talk in browser. The real-number calls wait for go-live day, where five planned calls prove the phone path as well as the answers.

One brain, many channels

The same knowledge helps more than the phone. Website chat can answer from the knowledge base too. On Growth and Franchise, the chat replies with AI. On Launch and Core, chat replies stay manual, so the office answers them.

So write knowledge once, in a form that works for both voice and text. Short sentences help both. A caller cannot scroll back, and a chat visitor will not read a wall of text.

Fig 6

Website chat by plan

Launch and Core
  • Chat replies stay manual
  • The office answers
Growth and Franchise
  • Chat replies with AI
  • Answers from the same knowledge
  • Growth: $95 billed yearly, $119 monthly
Write knowledge once, in short sentences that work for voice and text.

A Core client may want AI chat at night. That is a plan question, not a training question. AI website chat starts on Growth, at $95 a month billed yearly or $119 month to month.

Keep it current

Knowledge goes stale. Prices change in spring. A new tech joins. The business stops serving a town. Each change must reach the agent the same week.

Set a monthly knowledge check in your service rhythm. Put it on the same day as the monthly report, so it never gets skipped. It takes 15 minutes:

  1. Ask the owner: "Did any price, area, hour or service change?"
  2. Read five recent call transcripts. Look for "I'm not sure" and for answers you did not expect.
  3. Update Quick answers and Knowledge sources.
  4. Rerun the questions that touch what you changed.

Size changes the load. An owner-operator changes little, so the check is short. A fleet adds services and staff more often. A multi-location business may have a different price or area per location. Then each location's rules need their own lines, and the test needs questions for each location.

Common mistakes

  • Uploading everything. Old price sheets leak wrong answers. Fix: add only current, approved documents.
  • Writing the emergency script yourself. Fix: use the client's own words exactly.
  • Testing only easy calls. Fix: build the 20-question test with hard cases on purpose.
  • Fixing one answer, not the cause. Fix: find the layer that failed and fix it there.
  • Publishing before the test passes. Fix: publish only at 20 out of 20.

Do this now

Write the 20 test questions for one real or practice client. Train a practice agent on the free Launch plan. Run the test in Practice conversation. Record the first score, the fixes and the final score.

Practice the conversation

  1. Operator I need three things from you before the AI talks to anyone.
  2. Owner Go ahead.
  3. Operator Your current prices, your emergency wording, and the towns you serve.
  4. Owner Can't the AI work out emergencies on its own?
  5. Operator No. It matches what callers say against cases you write down.
  6. Owner Okay. What else?
  7. Operator I'll run 20 test calls. You'll see the score before it goes live.
  8. Owner What if it says something dumb?
  9. Operator Then I fix the cause and test again. It goes live at 20 out of 20.

Quick check

  1. In a test, the agent calls a drain clearing a "pipe repair". What do you do?
    • Go live, because callers will understand
    • Run the same test again
    • Fix the service name and the knowledge, then test again
    • Ask techs to correct callers on site
  2. The owner wants the agent to say the exact $89 diagnostic fee every time. Where does it go?
    • `Quick answers`, with `Add FAQ`
    • A long PDF in `Knowledge sources`
    • `Pronunciation help`
    • `Voice`
  3. Your first test run scores 17 of 20. What percent is that, and is the agent ready?
    • 85%, ready to publish
    • 85%, not ready until it scores 20 of 20
    • 17%, not ready
    • 90%, ready to publish

ServiceAgent UniversityLearn to run a service business on autopilot. Free courses, Blueprints and certification for Service Operators.

Learn

Get certified

Community