Technology AI

Writing the knowledge base an AI phone agent needs

What a plumbing company should document for an AI phone agent: services, ZIP codes, fees, urgency rules, safety lines and policies, with an entry template.

AssistCall research teamPublished Reviewed by Faruque Amin, VP of Sales and Marketing6 min read

On this page
  1. What the knowledge base is for
  2. The ten sections to write
  3. Services, exclusions and service area
  4. Fees: write the exact words
  5. Urgency rules and safety lines
  6. Policies and the useful facts
  7. How to write a single entry
  8. Example: one finished entry
  9. Testing what you wrote
  10. Keeping it current
  11. Frequently asked questions
  12. References
Technology AI: Writing the knowledge base an AI phone agent needsArticle coverTECHNOLOGY AIWriting the knowledgebase an AI phone agentneedsAva for PlumbersInsightsTechnology AI: Writing the knowledge base an AI phone agent needsArticle coverTECHNOLOGY AIWriting the knowledgebase an AI phoneagent needsAva for Plumbers

Key takeaways

  • An AI phone agent can only be as accurate as what you write down; every gap becomes a guess or a handover.
  • Cover ten areas: services, exclusions, service area, hours, fees, urgency, safety lines, booking rules, policies and handover.
  • Write each entry as caller questions, one approved answer, words to avoid and when to hand over.
  • Urgency rules matter most: the average homeowners claim for water damage and freezing was $15,400[1].

What the knowledge base is for

An AI phone agent does not know your business. It knows what you give it. The knowledge base is the written reference it uses to answer callers: what you do, where you go, when you work, what you charge for a visit, what counts as urgent, and what to do when a question is not covered. A well-written knowledge base is the difference between an agent that sounds like your best CSR and one that sounds like a stranger reading a brochure.

Treat it as a living document with an owner, not a one-off setup form. Most problems in the first months of AI call handling trace back to a missing or outdated entry: a ZIP code added to the service area but not to the list, a new diagnostic fee nobody updated, a holiday closure forgotten. The agent will repeat whatever is written, so the writing deserves the same care as a price book.

Write in the same plain language your best CSR uses on the phone. Short sentences, no internal jargon, and one fact per sentence. An entry that reads well aloud will usually be spoken well by the agent.

The ten sections to write

Ten knowledge base sections for a plumbing company, with one illustrative line each.
SectionWhat to writeExample of a line
ServicesEvery job type you do, in the words callers useClogged drains, including kitchen, bath and main line
ExclusionsWork you do not do, and where to point callersWe don't service septic tanks; we can recommend a local pumping company
Service areaZIP codes, towns and any job-type limits by areaFull service in 30301 to 30318; estimates only in 30319
HoursOffice hours, on-call hours, holidaysOffice 7 to 5 weekdays; emergency service every night
Fees you shareExact wording for the fees you allow on the phoneOur service-call fee is quoted on booking and credited to approved repairs
UrgencySituations that are urgent and what to doWater actively leaking and cannot be shut off: urgent
Safety linesWhat to tell callers in a hazardSmell gas: leave the home and call the gas utility from outside
Booking rulesBookable job types, windows and limitsDrain cleanings bookable in standard windows
PoliciesWarranty, payment methods, cancellations, licensingWe accept card and check; we never change bank details by email
HandoverWhen to stop and pass to a personComplaints, billing disputes, commercial accounts

Services, exclusions and service area

List services in the language callers use, not your internal codes. Callers say my toilet keeps running, not toilet fill valve replacement. Include common variants: backed-up, clogged, slow, gurgling. For each service, add one line on whether it is bookable or needs an estimate visit.

Exclusions are as important as services. If you do not do septic work, well pumps or appliance hookups, say so, and give an approved next step. A caller told kindly that you do not do something, with a suggestion, often calls you back for the work you do.

For the service area, a ZIP code list beats a radius. Callers name towns, neighborhoods and landmarks, so add the town names inside each ZIP code and note the edge cases: areas you serve only for estimates, only on certain days, or only for existing customers.

Fees: write the exact words

Decide which fees can be spoken on the phone and write the exact sentence for each. Most shops share the service-call or diagnostic fee and whether it is credited toward the repair. Very few share repair prices, because they depend on what the technician finds. Add a firm instruction: never estimate a repair price, and offer a visit or estimate instead. Our guide on diagnostic fees and free estimates covers the policy decision behind the wording.

Urgency rules and safety lines

Urgency is the section that protects your customers and your reputation. Water damage is expensive: the average homeowners insurance claim for water damage and freezing was $15,400 over 2019 to 2023[1], and about 1.6% of insured homes had a water damage or freezing loss each year from 2018 to 2022, second only to wind and hail[1]. A caller describing an active leak needs to reach a person quickly, and needs to be told how to limit the damage while they wait.

Share of insured US homes with a loss each year, 2018 to 2022
Share of insured US homes with a loss each year, 2018 to 2022Comparison. Wind and hail: 2.8%; Water damage and freezing: 1.6%.2.8%Wind and hailWind and hail: 2.8%1.6%Water damage and freezingWater damage and freezing: 1.6%Share of insured US homes with a loss each year, 2018 to 2022Comparison. Wind and hail: 2.8%; Water damage and freezing: 1.6%.2.8%Wind and hailWind and hail: 2.8%1.6%Water damage and freezingWater damage and freezing: 1.6%

Source: Insurance Information Institute, 2023[1]

Show the data
ItemValue
Wind and hail2.8%
Water damage and freezing1.6%

Write urgency as situations, not keywords, because frightened callers rarely say emergency:

  • Water leaking that cannot be stopped, or leaking near electrics or through a ceiling.
  • No water to the whole home.
  • Sewage coming up into a tub, shower or floor drain.
  • A frozen pipe that has burst or is likely to. The Red Cross notes pipes freeze most often when exposed to severe cold, in unheated interior spaces such as basements, crawl spaces, attics and garages, or along uninsulated exterior walls[2].
  • Water heater leaking from the tank or pressure relief valve.

Then write the safety lines for each: where the main shut-off usually is, to switch off power to a water heater before touching it, and to leave the home and call the gas utility from outside if they smell gas. Keep each line short and factual.

Policies and the useful facts

Callers ask about warranties, payment, cancellations and whether you are licensed. Most states and some localities require plumbers to be licensed[3], so put your license numbers and the states or cities they cover in the knowledge base, ready to give when asked.

A few carefully sourced facts help with routine calls. For a caller unsure whether a dripping faucet is worth fixing, the EPA says household leaks can waste more than 9,300 gallons of water a year, and 9% of homes have leaks wasting 50 gallons or more a day[4]. Keep any fact like this tied to its source and never let the agent improvise statistics.

How to write a single entry

  1. Caller questions

    List three to five ways callers ask it: Do you come out on Sundays? Are you open this weekend? Can someone come tomorrow, it's Sunday?

  2. Approved answer

    One or two sentences, in your voice, that a CSR would be happy to say.

  3. Do not say

    Words and promises to avoid, such as arrival times, guarantees or anything about price beyond the approved fee.

  4. Handover rule

    When the question goes beyond the answer, what to do: book, record a request or pass to the office.

  5. Owner and date

    Who wrote it and when it was last checked, so stale entries are easy to find.

Ava answers callers' usual questions from approved entries like these and says so when she does not know, which is why the handover rule on each entry matters as much as the answer.

Example: one finished entry

Example entry, weekend service. Caller questions: Are you open Saturday? Can you come out this weekend? Do you charge more on Sundays? Approved answer: Our office is closed at weekends, but we handle urgent plumbing problems every day. For routine work, I can take your details and our office will confirm a weekday time on Monday morning. Do not say: any weekend surcharge amount unless it is in the fees section; any arrival time. Handover: if the caller describes an active leak, no water or sewage backup, follow the urgent path. Owner: office manager, checked on the first Monday of the month.

Testing what you wrote

Before the agent takes a live call, test the knowledge base the way a caller would. Give a staff member who did not write it a list of twenty questions drawn from real calls, and have them call in and ask each one in their own words. Score every answer as correct, correct but clumsy, wrong or handed over. Anything wrong is a writing problem to fix first; anything clumsy usually means the approved answer is too long or uses office jargon.

Include the awkward cases on purpose. Ask about a town on the edge of the service area, a job you do not do, a fee you have not approved for the phone, and a weekend emergency described without the word emergency. Ask the same question twice in different words and check the answers match. Repeat the full test after every large change, such as a new service area, new fees or a new on-call rota, because a change in one section often exposes gaps in another.

Keeping it current

  • Name one owner, usually the office manager, and one backup.
  • Change the knowledge base the same day you change a fee, hours or the service area.
  • Review the whole document monthly and before each holiday and freeze season.
  • Read call records for questions the agent could not answer, and add entries for any that come up twice.
  • Keep old versions, so you can see what the agent was told on any date.

Frequently asked questions

How long should a plumbing knowledge base be?

Long enough to cover the ten sections and your most common questions. For most shops that is a few pages, plus a ZIP code list and the on-call rota.

Should the AI quote repair prices?

Most plumbing companies allow only the service-call or diagnostic fee to be shared, word for word. Repair prices depend on what the technician finds, so the agent should offer a visit or estimate.

What happens when a caller asks something that isn't covered?

A good agent says it does not know and follows the handover rule, usually recording the question for the office. Add an entry for any question that comes up repeatedly.

How often should we update it?

Immediately when a fee, hours or service area changes, plus a full monthly review and checks before holidays and the freeze season.

References

  1. Insurance Information Institute (2023). Facts + Statistics: Homeowners and renters insurance (opens in a new tab) โ†‘

  2. American Red Cross (2026). Frozen Pipes (opens in a new tab) โ†‘

  3. U.S. Bureau of Labor Statistics (2025). Occupational Outlook Handbook: Plumbers, Pipefitters, and Steamfitters (opens in a new tab) โ†‘

  4. U.S. Environmental Protection Agency, WaterSense (2026). Fix a Leak Week (opens in a new tab) โ†‘

Book a demo

See Ava handle your calls.

Book a short demo. Weโ€™ll walk through your calls and workflow, and agree what Ava should take care of.

Book a demo