Building an AI Agent in Call: Knowledge, Voice and Testing
A step-by-step guide to creating an AI agent in Call: define its job, add knowledge, set tone and voice, test it and assign it to a phone line.
An AI agent in Call is the part that actually talks to callers. It follows instructions you write, draws on documents and answers you supply, and speaks in a voice you choose. This guide walks through building one from scratch: what to decide first, how to create it, which knowledge sources to use, how to tune its manner of speaking, and how to test it before callers do.

It is a how-to for administrators and managers. If you want the wider context, see What Is AI Phone Reception?, and to plan the hand-off cases, What AI Receptionists Cannot Do. Menu names below are those used in the app; they may be arranged slightly differently in Easy mode.
Decide the job before you build
An agent with a clear, narrow job performs better than one told to handle everything. Write one sentence that describes it, such as "Answer questions about opening hours and services for a dental clinic, take messages, and pass urgent calls to staff." Then list what it must never do.
Questions to answer on paper first
- What is its job?Answer questions, take messages, route calls. One main purpose.
- Which line will it answer?A main number, an after-hours line or overflow.
- What is in scope?Hours, services, process, location.
- What is out of scope?Prices that vary, advice, decisions, bookings.
- Who receives a hand-off?The people or team who pick up when a caller asks.
- Which language?The language callers mostly use.
Create the agent
Creating an agent
- Open the agent listGo to AI agents, then All agents, and choose New AI agent.
- Name itUse a clear internal name, such as the line it will answer.
- Choose the languagePick the main language callers speak.
- Add first instructionsOptional: who it is, how it should talk and what it may say.
- CreateThe agent is saved as a draft. It answers no line yet.
Only managers can create agents. You can also start from a ready-made prompt for your type of business in the agent library and then replace the generic wording with your own. The template contains no facts about your business; you add those yourself. Another option is Build with AI, where you describe what you need by typing or speaking, and Call writes a draft prompt for you to review. Replace every gap marker in that draft with the real value before saving.
Give it knowledge
The knowledge base is what the agent may quote. Sources belong to one agent, and the more accurate and focused they are, the better the answers. Call offers several ways to add content.
| Source | Best for |
|---|---|
| Text snippets | Opening hours, policies and exact wording you want quoted |
| Q&A | Specific questions with the exact answer you want given |
| Files | Documents such as PDF, Word, text or spreadsheets (a PDF needs selectable text) |
| Website | One page, the whole site or pages you choose |
Prefer small, clear pieces over giant documents. Write answers the way you would say them aloud, in short sentences. If two sources disagree, the agent may pick either, so keep one version of each fact. After adding content, use the check-a-question tool to see what the knowledge base finds, and re-index after large changes.
Set how it speaks
Instructions, persona and voice together decide how the agent sounds. The system prompt describes behaviour; the persona sets the name, role, tone, goals and rules; the voice sets how the words are spoken.
- Be specific about tone. "Warm, brief and calm" is more useful than "professional".
- State the rules plainly. For example: never state prices that are not in the sources; offer a person when asked; keep replies to one or two short sentences.
- List the hand-off cases. Emergencies, complaints and anything outside the sources.
- Choose a voice and listen. Play it before saving, and adjust speed if it sounds rushed.
- Decide on interruptions and silence. Callers can talk over the agent by default, and you set how long a silent call lasts before it ends.
Call applies some rules whatever your instructions say. The agent replies in the caller's language, uses one or two short spoken sentences without lists or links, never invents prices or hours, and tells a caller who asks that it is an AI assistant. It cannot book or confirm appointments, call back or send anything on a call. Your instructions cannot switch these rules off, so write your process around them. For guidance on writing the prompt itself, read Prompting an LLM Phone Agent.
Test before you go live
There are three places to test, in increasing realism. The playground lets you chat with the agent and see which knowledge notes each answer used, so you can rate a reply or teach a better answer. The test call rings your own phone and answers it the way callers are answered on that line. Practice calls and a few friendly outside callers add variety you would not think of yourself.
A test list for your first agent
- Ask each of your ten commonest questions and compare with the source
- Ask something outside the sources and check it declines honestly
- Ask for a person and check the right phones ring
- Ask it to book an appointment and check it explains what it can do instead
- Ask in another language if your callers use one
- Interrupt it mid-sentence and see how it responds
- Stay silent and see how long the call lasts
Save a restore point before any big change so you can roll back. When a reply is wrong, either fix the source or add the right answer as a Q&A entry, then ask again.
Assign it to a line and set it live
A new agent answers nothing until you choose it for a line, in the agent's Line & status section. A line left on its default is answered by the organisation's default agent, so check which one that is. When you are ready, press Set live; if you need to pause the agent, set it back to draft. Business hours decide when a caller who asks for a person can be put through, and holidays and closures are set separately.
Going live safely
- Choose the linePick the agent under Answered by for the line.
- Check hoursSet business hours and any holiday closures.
- Check the hand-offConfirm who would ring right now when a caller asks for a person.
- Set it liveSwitch the agent from draft to live.
- Listen in the first daysRead the calls and fix what you find.
Keep improving it
After launch, the calls teach you what to change. Call quality scoring rates each AI call on criteria such as whether the answer came from your sources, whether replies were short, and whether it handed over when needed. Low scores point to the calls worth reading. The agent can also learn questions and answers from conversations, with personal details removed, but nothing reaches it until you approve each item.
Review weekly at first. Add missing answers, correct wrong ones, and keep a note of what you changed. Read Call Summaries and History in Call to see how to review conversations, and Knowledge Sources in Call for more on sources.
Frequently asked questions
Can the agent book appointments?
No. It can take a request and explain what happens next, but it cannot book or confirm an appointment on the call. Appointments are managed by your team or through a booking page.
Why does my new agent not answer calls?
A new agent is a draft and answers no line until you choose it for a line and set it live. Check the Answered by setting for the line.
What if the agent does not know the answer?
It says plainly that it cannot confirm that on this call, and offers a person where the line can put callers through. Add the missing fact to a source to fix it.
How do I stop it from making things up?
Give it accurate sources and clear rules. It is designed to answer only from its instructions and sources, but you should still test with questions outside its knowledge.
Can I go back to an earlier version?
Yes. Save a restore point before big changes and roll back from the agent's page if needed.
Which language does the agent use?
The language you choose is also the main call language of the lines it answers. On a call it still replies in the language the caller uses.