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

# Creating an Agent

> Step-by-step guide to creating a new voice agent.

## Create a new agent

<Steps>
  <Step title="Navigate to Agents">
    From the dashboard sidebar, click **Agents**. You'll see a list of all your existing agents.
  </Step>

  <Step title="Click Create Agent">
    Click the **Create Agent** button in the top-right corner.
  </Step>

  <Step title="Fill in agent details">
    In the creation dialog, provide:

    * **Name**  - A descriptive name for your agent (e.g., "Customer Support", "Sales Qualifier")
    * **Description**  - A brief summary of what this agent does

    Click **Create** to proceed.
  </Step>

  <Step title="Configure your agent">
    You'll be taken to the agent configuration page. From here, you can set up:

    * [Instructions](/agents/instructions)  - System prompt and welcome message
    * [Voice](/agents/configuring-voice)  - Voice provider and selection
    * [LLM](/agents/configuring-llm)  - Language model settings
    * [Tools](/agents/tools-and-functions)  - Built-in and custom functions
    * And more
  </Step>
</Steps>

## Agent details

Once created, each agent has:

* **Agent ID**  - A unique identifier, auto-generated and copyable. Use this for API calls and integrations.
* **Name**  - Editable at any time from the agent settings.
* **Status**  - Shows whether the agent is published and ready for deployment.

## Managing agents

From the Agents list page, you can:

* **Search** agents by name
* **Click** an agent to open its configuration
* **Delete** an agent (this action is permanent)

<Warning>
  Deleting an agent removes all its configuration, linked knowledge bases, and deployment settings. This cannot be undone.
</Warning>