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

# Create Agent

> Easily create a custom AI agent that can handle conversations, qualify leads, book appointments, and automate client workflows.

## **Create a New Agent**

**Steps:**

<Steps>
  <Step title="Login as Client Account" stepNumber={1} titleSize="p">
    * Go to the **“Agents”** menu under **Agent Hub.**
    * Click **“AddAgent.”**
    * Tap the **⚙️gear icon** to edit, clone, or delete agents

          <img src="https://mintcdn.com/voicemetrics-47a09903/0a3gnBcxpCwhVipt/images/agent3.png?fit=max&auto=format&n=0a3gnBcxpCwhVipt&q=85&s=42e3897aaf5fc67089198d287b7f02e5" alt="Agent3 Pn" width="1920" height="1080" data-path="images/agent3.png" />
  </Step>

  <Step title="Choose from Agent Library" stepNumber={2} titleSize="p">
    * **Option 1:** Use a **predefined template** from the library. (e.g., Appointment Booking).
    * **Option 2:** Start from a **blank template** to build your custom agent.

          <img src="https://mintcdn.com/voicemetrics-47a09903/4sNeGmPz80pnlMOz/images/template.png?fit=max&auto=format&n=4sNeGmPz80pnlMOz&q=85&s=95a4eef4e756b421ea16f93655a256da" alt="Template Pn" width="1920" height="1080" data-path="images/template.png" />
  </Step>
</Steps>

## **Agent Settings**

### **Basic Information**

* Agent Name
* Select Voice & Language
* Assign Knowledge Base (for answering queries with uploaded docs, URLs, etc.)

<img src="https://mintcdn.com/voicemetrics-47a09903/0a3gnBcxpCwhVipt/images/info.png?fit=max&auto=format&n=0a3gnBcxpCwhVipt&q=85&s=df021cf872885aee1379ae9fdd4dc0a8" alt="Info Pn" width="1920" height="1080" data-path="images/info.png" />

### **Settings**

1. **Speech Settings**
   * Control how the AI agent speaks and interacts during calls. Adjust the responsiveness, tone, and naturalness of the conversation for a better caller experience.
   * Add the Inactivity Reminder Messages - Messages to play when the user is inactive for a specified duration.
2. **Call Settings**
   * Configure call behavior, including max call duration, max ring duration. These settings help tailor the overall call flow.
   * Set the LLM model and temperature to control the AI’s creativity and consistency during conversations.

     <Note>
       This section is visible only if "Agency View" is enabled in the client account menu footer.
     </Note>

<img src="https://mintcdn.com/voicemetrics-47a09903/0a3gnBcxpCwhVipt/images/callsettings.png?fit=max&auto=format&n=0a3gnBcxpCwhVipt&q=85&s=90d256eb55da6651a11bbb5d73318d9d" alt="Callsettings Pn" width="1920" height="1080" data-path="images/callsettings.png" />

### **Prompt**

1. **Design how your AI speaks and behaves:**
   * First Message: The greeting or intro message is played when a call connects
   * Task Prompt: Core instruction to guide the AI on what to say or do
2. **Using Variables**
   * Use dynamic fields in the prompt using \$
   * Example: Hi \$Lead\_Name, I see you're interested in \$Service\_Type.
3. **Using Tools (Actions)**
   * Trigger actions with simple commands in the prompt.
   * Example: Use tool #Book\_Calendar to schedule an appointment.

<img src="https://mintcdn.com/voicemetrics-47a09903/4sNeGmPz80pnlMOz/images/prompt.png?fit=max&auto=format&n=4sNeGmPz80pnlMOz&q=85&s=56e96c091164de844038aa7dbfbb5f68" alt="Prompt Pn" width="1920" height="1080" data-path="images/prompt.png" />

### **Actions**

1. **On-Call Actions**
   * **Transfer Call** – Redirect to another number or a human
   * **End Call** – Terminate conversation with a polite message
   * **Book Calendar** – Check availability and schedule appointments
   * **Custom Action** – Fetch or send data via APIs (Make, N8N, Zapier)
2. **Post-Call Actions**
   * **Send Email** – Send conversation summary to inbox
   * **Send SMS** – Notify client or lead via text
   * **Extract Info** – Capture lead details (e.g., name, phone, intent)
   * **Send to Server (Webhook)** – Push call data to CRMs, Sheets, or other tools

<img src="https://mintcdn.com/voicemetrics-47a09903/0a3gnBcxpCwhVipt/images/actions.png?fit=max&auto=format&n=0a3gnBcxpCwhVipt&q=85&s=6faa0e358b1b2ff2a2067f73745c3985" alt="Actions Pn" width="1920" height="1080" data-path="images/actions.png" />

### **Deploy the Agent**

Once the agent is configured, connect it to inbound/outbound channels:

1. **Assign Outbound Phone Numbers**
   * Used to place outbound calls
   * Go to Deploy Tab → Outbound Numbers → Select a number
2. **Assign Inbound Phone Numbers**
   * Used to handle incoming calls
   * Go to Deploy Tab → Inbound Numbers → Select a number
3. **Assign Web Widgets**
   * Used for web-based voice conversations (e.g., website live chat)
   * Go to Deploy Tab → Web Widgets → Connect widget

<img src="https://mintcdn.com/voicemetrics-47a09903/0a3gnBcxpCwhVipt/images/deploy.png?fit=max&auto=format&n=0a3gnBcxpCwhVipt&q=85&s=62add0446ab89a6859e3f713aa64e6e4" alt="Deploy Pn" width="1920" height="1080" data-path="images/deploy.png" />
