Create an agent
You need Contributor access to the project and an active subscription to create an agent.
Start from a template
- Open the project and choose Build → Agents.
- Choose New agent → Agent gallery.
- Search or filter the templates by category, then choose Use this template.
The agent is created with the template's prompt and settings and a voice widget channel, and opens straight away. You can change everything afterwards.
Start from scratch
- Choose Build → Agents, then New agent → Create manually.
- An agent called "Untitled agent" is created with the default voice provider and voice, and its page opens.
New agents start as Draft, so nobody can reach them until you switch them to Live.
Finish the setup checklist
The agent page shows a Finish setting up your agent checklist until the required steps are done:
| Step | Where | Required |
|---|---|---|
| Name it | Overview | Yes |
| Write the prompt | Overview | Yes |
| Pick a voice and model | Model & Voice | Yes |
| Connect tools | Tools | Optional |
| Add knowledge | Knowledge Base | Optional |
| Test it in the Playground | Playground | Optional |
| Put it on a channel | Channels or Phone | Yes |
Overview fields
| Field | Limit | What it does |
|---|---|---|
| Name | Required, up to 100 characters | The label your team sees. |
| Description | Up to 500 characters | What the agent does. Generate with AI uses it when drafting the prompt. |
| Language | The main language, whether the agent stays in it or follows the caller, and which languages it may switch to. See Language. | |
| Conversation goal | Up to 2,000 characters | What success looks like, for example "book an appointment". Each finished conversation is judged against it, and the result shows as an outcome in Analytics. |
| Initial message | Up to 2,000 characters | The first thing the agent says when a conversation starts. Leave it empty and the agent waits for the caller to speak first. |
| System prompt | Up to 20,000 characters | Who the agent is, what it does, its tone and what it must never do. See System prompt. |
| Restrict to Knowledge Base & Tools only | When on, the agent answers only from its knowledge base and tools, not from general knowledge. |
Choose Save changes to save the section.
Generate the prompt with AI
Choose Generate with AI above the system prompt. It drafts a prompt from the agent's saved name and description and from the tools and knowledge base connected to it, so save your changes first. Review the draft and edit it before you save.
Prompt versions
A version is saved every time the system prompt changes. Open Prompt Versions to read an older version, compare it with the current prompt, or choose Restore. Restoring saves the old text as a new version, so nothing is lost.