Quickstart: your first voice agent
Create a voice agent, give it a prompt and talk to it from the browser. About ten minutes, no phone number needed.
By the end of this page you have a voice agent that answers as the receptionist of a dental clinic, and you have spoken to it from your browser. Attaching it to a phone number comes later, in Deploy.
Create the agent
Open the wizard
In the sidebar choose AI Agents, then Create Agent at the top right.
Choose voice, then a single prompt
Pick Voice Agent, then Single Prompt Agent. A single prompt is one brief the agent follows for the whole call; a Conversation Flow is a graph of steps, covered in Flow agents.
Start from scratch
The templates are worth a look later. For now choose Start from scratch so every field on the next screens is yours.
Name it and pick a language
Type a name and leave Language on English (US). The language decides which voices are offered and how the caller’s speech is transcribed.
Pick a voice
Tap a voice to hear a sample, then Create Agent. You can change the voice at any time from the agent’s settings.
The agent opens in its workspace: the sidebar on the left lists its sections in four groups, Build, Testing, Improve and Release. You are on Settings.
Write the prompt
The prompt has three fields. Fill them in plain language; the agent reads them as instructions, not as a script.
Agent Identity
Who the agent is and how it sounds.
You are Nora, the receptionist at Riverside Dental. You are warm, brief and
professional. Callers are patients who want to book, move or cancel an
appointment.Tasks
What it should achieve on every call.
1. Greet the caller and ask how you can help.
2. Confirm the caller's full name and date of birth before changing any booking.
3. Offer the next three available slots and read the chosen one back.
4. Before ending, summarise what was agreed.Guardrails
What it must never do.
- Never give medical advice. Offer to book a consultation instead.
- Do not discuss prices beyond what is on the website.
- If the caller asks for a person, say a colleague will call back within the hour.First message
Under Conversation, leave Who talks first on Agent speaks first and set First message to the opening line:
Hi, this is Nora at Riverside Dental. How can I help you today?Save
Choose Save at the top right. The version counter under the agent’s name
moves to v0.2.
Talk to it
Open the call test
In the workspace sidebar, under Testing, choose Call.
Start the call
Choose Call. Your browser asks for the microphone the first time. The agent speaks its first messageFirst messageWhat the agent says when it speaks first.See the glossary; answer it out loud. The transcript appears at the top of the panel as you talk.
End the call
Choose End call when you are done. A minute or two of browser testing is enough to hear whether the identity and first message feel right.
Call is the only way to talk to a voice agent from the browser; there is no typed chat for voice agents. To check the same wording repeatedly without speaking, write it as a scenario under Evaluation. See Evaluations.
Verify
- Call Logs in the main sidebar lists the test call within a few seconds, with WEB as both numbers, its duration and a recording.
- Open the call. The transcript, a summary, a quality assessment and the outcome (task status, sentiment, disconnect reason) are on the call’s page.
Troubleshooting
- The agent does not speak first. Who talks first is set to the caller. Switch it to Agent speaks first and save.
- The microphone never activates. The browser blocked the permission. Reload the page and allow the microphone when asked, or check the site permissions in the address bar.
- The agent answers in the wrong language. The agent’s Language decides transcription. Change it under Settings and pick a voice for that language.