Audience
- Workspace admins and operators managing agents
- Teams maintaining multiple production and test agents
Prerequisites
- You can access platform.voqo.ai and open the Agents section.
- You have workspace access with permission to create and update agents.
- You have at least one number available for connection and testing.
The agents dashboard
Open Agents to see every agent in your workspace. On desktop each agent appears as a card; on mobile the same agents appear as a list. Each card or row shows you the agent’s status, its assigned number, and the voice it uses, so you can tell at a glance which agents are live and how callers reach them. From here you can:- Select Create Agent to add a new agent.
- Select any agent to open its configuration page.
Inside an agent
When you open an agent, the page is split into two parts: an identity panel down the left and a tabbed workspace beside it.The identity panel
The identity panel stays in view as you work and gives you the controls you reach for most often:- The agent’s name and voice.
- An Answering calls toggle to turn the agent on or off without deleting it.
- The numbers assigned to the agent.
- Outbound Call to place a one-off call, and Connect Agent to connect the agent to a number.
- Save to apply your changes, and Delete to remove the agent.
The workspace tabs
Everything you configure for the agent lives under one of five tabs:- Conversation — the agent’s name, opening sentence, and the prompt that drives how it speaks and what it says on a call.
- Capabilities — the actions and functions the agent can perform during a call.
- Behaviour — runtime settings such as voice, recording, speaking speed, interruption handling, and timezone.
- After the call — what the agent does once a call ends, such as sending messages or summaries and updating contacts.
- Evaluation — run prompt evaluations against your agent and review how it performs. See Evaluation.
On mobile
On a phone, the same settings appear as a single scrolling page. A row of tabs at the top lets you jump straight to any section — Conversation, Capabilities, Behaviour, After the call, or Evaluation — without losing your place.Common tasks
Create a new agent
- Open Agents and select Create Agent.
- Enter a clear agent name and opening sentence.
- Save the agent and confirm it appears on your agents dashboard.
Edit an agent
- Open an agent from the dashboard.
- Move through the tabs to update the agent’s conversation, capabilities, behaviour, and after-call actions.
- Select Save, then run a test call to confirm the changes.
Turn an agent on or off
- Open the agent.
- Use the Answering calls toggle in the identity panel to stop or resume call handling.
- The agent keeps all its settings while it is switched off, so you can switch it back on at any time.
Retire an agent safely
- Turn the agent off with the Answering calls toggle so it stops handling calls.
- Reassign its numbers to another active agent if needed.
- Select Delete only once you have confirmed the handover.
Troubleshooting
I can change settings but my updates do not take effect
- Confirm your role has permission to update agents in this workspace.
- Make sure you selected Save in the identity panel — changes are not applied until you save.
- Refresh the page and retry if another team member may have changed the same agent.
Prompt changes are saved but the agent behaves differently than expected
- Run a test call after each change on the Conversation tab.
- Check the agent’s Capabilities and any connected knowledge.
- Use the Evaluation tab to measure how the agent performs before relying on it.
A switched-off agent still appears to handle calls
- Confirm the Answering calls toggle is off.
- Confirm its numbers were reassigned to an active agent.
- Verify you are viewing the current workspace and not a cached view.