Skip to main content

Create an agent

You need Contributor access to the project and an active subscription to create an agent.

Start from a template​

  1. Open the project and choose Build → Agents.
  2. Choose New agent → Agent gallery.
  3. 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​

  1. Choose Build → Agents, then New agent → Create manually.
  2. 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:

StepWhereRequired
Name itOverviewYes
Write the promptOverviewYes
Pick a voice and modelModel & VoiceYes
Connect toolsToolsOptional
Add knowledgeKnowledge BaseOptional
Test it in the PlaygroundPlaygroundOptional
Put it on a channelChannels or PhoneYes

Overview fields​

FieldLimitWhat it does
NameRequired, up to 100 charactersThe label your team sees.
DescriptionUp to 500 charactersWhat the agent does. Generate with AI uses it when drafting the prompt.
LanguageThe main language, whether the agent stays in it or follows the caller, and which languages it may switch to. See Language.
Conversation goalUp to 2,000 charactersWhat 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 messageUp to 2,000 charactersThe first thing the agent says when a conversation starts. Leave it empty and the agent waits for the caller to speak first.
System promptUp to 20,000 charactersWho the agent is, what it does, its tone and what it must never do. See System prompt.
Restrict to Knowledge Base & Tools onlyWhen 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.

Next steps​

Was this page helpful?