Skip to main content
Build Agents with VAW Native

Manage Agents: Avatar, Agent ID, Delete

Find agents in the list, read the agent header at a glance, change an agent's avatar, copy its ID for webhooks, and delete it.

Written By voiceaiwrapper

Last updated 26 days ago

As you build more agents, you'll want to find them quickly, see at a glance how each one is set up, and tidy up the ones you no longer need. This article covers the agents list, the information at the top of every agent's page, and three agent-level actions: changing the avatar, copying the agent ID, and deleting an agent.

Applies to: agents in a VAW Native Pod (an engine or provider connection). For Vapi, Retell AI and ElevenLabs agents, see How Provider Agents Appear in VoiceAIWrapper.

The agents list

In the sidebar, open Agents. Each row shows:

ColumnWhat it shows
Agent nameThe agent's avatar and name.
ModelThe AI model the agent uses.
VoiceThe voice it speaks with.
Created / UpdatedWhen the agent was created and last changed.
ActionsA bin icon to delete the agent.

To find an agent, type in Search agents..., or filter by Model or Created. The Model filter matches a model name or its provider, such as anthropic. Click a row to open the agent.

To add an agent, click New agent. See Create an Agent with the AI Agent Builder or Create an Agent from Scratch.

The agent page header

Every agent's page starts with the same header. Use All agents above it to go back to the list.

The top of an agent's page: the All agents back link, the avatar, the agent name, the row of pills (green "Answers 1 number", model, voice, language), and on the right the "…" menu clicked open showing Copy agent ID and Delete, next to Test agent and Saved.

Under the agent's name, a row of pills sums up its setup:

PillWhat it shows
ReachAnswers {N} numbers (green): calls to that many numbers reach this agent. Not reachable by phone (amber): numbers are connected, but none can reach the agent right now. No number assigned (grey): no number rings this agent. Click the pill to open Deploy β†’ Inbound.
ModelThe AI model. See Choose an AI Model.
VoiceThe voice. See Choose a Voice for Your Agent.
LanguageThe language, or Auto-detect. See Choose the Agent's Language.

The model, voice and language pills update as soon as you change those settings, even before you save.

On the right are the agent's actions:

If you click All agents (or another link on the agent's page) with unsaved changes, you'll see Discard unsaved changes? Click Leave page to leave without saving, or cancel and save first. Links in the sidebar don't warn you, so save before you move to another page.

Change the avatar

The avatar is the face shown for the agent in the agents list, on its page and in the Test sheet.

  1. On the agent's page, click the avatar next to the name.
  2. Browse the avatars, or narrow them down with Search avatars or a personality: Confident, Friendly, Expert, Modern, Warm or Sophisticated.
  3. Click the avatar you want. To show the agent's initials instead, click Remove avatar.
  4. Click Save changes.
The avatar picker open from an agent's page header: the Search avatars box, the personality chips (All, Confident, Friendly, Expert, Modern, Warm, Sophisticated), the grid of avatars with the current one highlighted, and Remove avatar at the bottom.

To rename the agent, change Agent name on the Agent Settings tab, then click Save changes.

Copy the agent ID

Each agent has a unique ID. You need it when your own systems refer to a specific agent.

  1. On the agent's page, click ….
  2. Click Copy agent ID. You'll see Agent ID copied, and the ID is on your clipboard.

Where you use it:

Delete an agent

You can delete an agent from the list (the bin icon in Actions) or from its page (… β†’ Delete).

  1. Click Delete.
  2. In Delete {agent}?, click Delete agent.

You'll see Agent deleted. If you deleted it from its page, you're taken back to the agents list.

Deleting an agent can't be undone. The agent stops taking calls immediately. Any number it answered is left without an agent, so callers hear whatever the Pod plays for numbers with no agent (a message or a busy tone, set under When a number has no assistant yet in the Pod settings). Its website widget is deleted too, so it disappears from every page that embeds it.

What happens to everything connected to the agent:

ItemAfter you delete the agent
Past calls and chatsKept in Call Logs and Chat Logs, still showing the agent's name.
Phone numbers it answeredStay in the Pod, with no agent. Connect another agent from that agent's Deploy β†’ Inbound tab.
Its widgetDeleted.
Tools, knowledge bases and Call Data ExtractionsStay in the Pod for other agents. Only the link to this agent is removed.
Client workspacesThe agent is removed from any client workspace it was assigned to.
Outbound phone campaigns that use itThe next time the campaign tries to call a lead, it pauses itself. The lead shows "The campaign agent no longer exists. Pick a new agent to continue."
Inbound phone campaigns that use itCallers to the campaign's number hear a busy tone until you pick a new agent for the campaign.

Want to keep the agent but stop it answering a number? Disconnect the number on the agent's Deploy β†’ Inbound tab instead. See Put Your Agent to Work: The Deploy Tab.

Before you delete an agent, open Campaigns and pick a new agent for any campaign that uses it, so no calls are missed.

Frequently asked questions

Not yet. To make a similar agent, create a new one and copy the prompt and settings across, or use the AI Agent Builder to build one from your answers.

No. Deleted agents can't be restored. Its past calls and chats are still in the logs, so you can read its transcripts while you rebuild it.