> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Agent Lifecycle

> Create, configure, test, and retire agents from the redesigned agent page and agents dashboard.

## Audience

* Workspace admins and operators managing agents
* Teams maintaining multiple production and test agents

## Prerequisites

* You can access [platform.voqo.ai](https://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.

Your changes are not live until you select **Save**, so you can adjust several tabs and commit them together.

### 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](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

1. Open **Agents** and select **Create Agent**.
2. Enter a clear agent name and opening sentence.
3. Save the agent and confirm it appears on your agents dashboard.

### Edit an agent

1. Open an agent from the dashboard.
2. Move through the tabs to update the agent's conversation, capabilities, behaviour, and after-call actions.
3. Select **Save**, then run a test call to confirm the changes.

### Turn an agent on or off

1. Open the agent.
2. Use the **Answering calls** toggle in the identity panel to stop or resume call handling.
3. 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

1. Turn the agent off with the **Answering calls** toggle so it stops handling calls.
2. Reassign its numbers to another active agent if needed.
3. 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.

If unresolved, contact <a href="mailto:support@voqo.ai?subject=Agent%20settings%20issue">support</a> with your workspace ID, the agent name, the change timestamp, and a screenshot.

## Related docs

* [Customise Your Agent](overview-customisation)
* [Conversation Prompts](conversation-prompts)
* [Agent Advanced Settings](agent-advanced-settings)
* [Evaluation](evaluation)
* [Knowledge Base Integrations](../integrations/knowledge-base-integrations)
* [Removing Your AI Agent](../getting-started/remove-agent)