Skip to main content

Agents

An agent is an AI assistant that talks to your customers by voice and by text. You build agents in a project, test them in the Playground and put them on channels such as a phone number or your website.

To see your agents, open a project and choose Build → Agents. The list shows each agent's status, model, voice, calls in the last 24 hours, tool success rate and connections. You can search, filter by status or channel, sort, switch between table and card view and export the list as CSV.

Draft and Live​

Every agent is either Draft or Live:

  • Draft: callers and visitors can't reach the agent. New agents start as drafts.
  • Live: the agent answers on every channel connected to it.

Switch the status with the Live toggle at the top of the agent page. Switching a live agent back to Draft takes it off its channels straight away.

The agent page​

Open an agent to see its settings. The sections are listed on the left:

SectionWhat you set there
OverviewName, description, language (main language, stay or follow the caller), conversation goal, initial message, system prompt and Restrict to Knowledge Base & Tools only. See Create an agent and System prompt.
Model & VoiceChat provider and model, voice provider, voice model, transcription model and voice. See Models and voices.
Call SettingsLive transfer number, barge-in, silence and call-length limits, end-call phrases, recording notice and keypad input. See Call settings.
ChannelsThe voice widget, WhatsApp and web form channels this agent answers on.
PhonePhone numbers from Twilio or Plivo, and numbers on your own SIP trunk. See Phone numbers.
Prompt VersionsEvery saved version of the system prompt. Compare and restore.
Escalation PolicyWhen the agent should hand a conversation to a person. See Call settings.
Knowledge BaseThe one knowledge base this agent answers from. See Knowledge base.
ToolsThe project's tools and integrations this agent can call.
MCP ServersThe project's MCP servers this agent can use tools from.
Data ExtractionStructured fields pulled out of each finished conversation. See Data extraction.
MemoryRemember customers across conversations. See Agent memory.
SkillsReusable instructions attached to this agent. See Skills.
Analytics & LogsSessions, usage and logs for this agent only.

Most sections have a Save changes button. Some, such as Tools, Skills and Escalation Policy, save as soon as you change them.

Tools​

The Tools section lists every tool in the project. Tick a tool to connect all of its actions to this agent. To connect only some actions, open the integration and pick them. To add a new tool, choose Add tool.

To tell the agent when to use a tool, name it in the system prompt. The Insert tool ref button in the prompt editor inserts a connected tool's name at the cursor. See Integrations.

MCP servers​

If your project has MCP servers in its registry (Connect → MCP servers), you can assign them to an agent here. The agent discovers the tools on each server when a conversation starts, so changes apply from the next conversation.

  • Only servers in the project's registry can be assigned.
  • A server that is disabled in the project is skipped, even when assigned.
  • The order matters: if two servers offer a tool with the same name, the higher one wins.

Knowledge base​

You can attach one knowledge base to each agent. The agent searches it during the conversation to ground its answers. Turn on Restrict to Knowledge Base & Tools only on the Overview section if the agent must not answer from general knowledge.

Analytics & Logs​

This section shows sessions, average duration, error rate, cost and tokens for the agent, plus its session list and event log. Filter by date range and channel. For all calls in the project, open Observe → Calls & transcripts.

Duplicate or delete an agent​

From the agents list, use the row actions to duplicate or delete an agent. Duplicating creates a copy named "(copy)". Deleting an agent can't be undone: its sessions, configuration and memories are removed, and callers on its channels stop reaching it.

Who can change agents​

Creating, editing, testing and deleting agents needs Contributor access or higher on the project. Viewers can see agents but not change them. Creating an agent also needs an active subscription. See Organizations, projects and members.

Was this page helpful?