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

# Voice AI Agent

Create an intelligent voice assistant that can handle calls and provide automated responses. This guide walks you through setting up your Voice AI Agent for natural, AI-powered conversations.

## 🎥 Video walkthrough

<div class="card-video">
  <video src="https://storage.googleapis.com/helpsessionvideos/Contactswing/Videos/AI-Agent/voice%20ai.mp4" autoplay playsinline controls />
</div>

## Step-by-step guide

<Steps>
  <Step title="Access the AI Agent dashboard">
    Go to the **AI Agent** tab and select **New AI Agent** to start creating your voice automation agent.

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/1ea.jpg" alt="AI Agent dashboard" />
  </Step>

  <Step title="Choose Voice agent type">
    Select **Voice** from the agent type options to build a bot for voice-based interactions and intelligent responses.

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/2.jpg" alt="AI Agent dashboard" />
  </Step>

  <Step title="Configure your agent settings">
    Name your agent and set up the following basic options:

    * **Name**: Enter a descriptive name (e.g., "My Voice AI Agent").
    * **AI Model**: Choose an AI model for generating responses.
    * **Action**: Define actions your agent can trigger during calls.

    Other basic settings include:

    * **Phone Number**: Assign a phone number for the agent.
    * **Initial Greeting**: The message played when the call connects.
    * **Idle Message**: The message played when the agent is waiting for input.
    * **Idle Time**: The duration of silence before the idle message is played.
    * **Max Message Length**: The maximum length of an agent's response.
    * **Max Turns**: The maximum number of conversational turns in a call.

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/va1.jpg" alt="AI Agent dashboard" />

    Explore the advanced configuration options to fine-tune your agent's behavior:

    **Core Configure:**

    * **Backchannel Probability**: Control the likelihood of the agent using short conversational fillers (like "uh-huh").
    * **Max Tokens**: Limit the number of tokens (words or sub-words) the AI model can generate in a response.
    * **Initial Pause (seconds)**: Set a delay before the agent speaks its initial greeting.

    **Idle Time Management:**

    * **Max Idle Duration (seconds)**: The maximum time the agent will wait for a response before ending the call.
    * **Allowed No. of Reminders**: The number of idle messages played before the call ends.
    * **Reminder Messages**: Customize the idle messages.

    **Call Duration:**

    * **Max Call Duration (seconds)**: Set the maximum length of a call.

    **Other Advanced Settings:**

    * **Custom Vocabulary**: Add specific words or phrases for better speech recognition.
    * **End Conversation on Good Bye**: Enable or disable ending the call when a "good bye" phrase is detected.
    * **Good Bye Messages**: Customize the messages played when the call ends.

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/va2.jpg" alt="AI Agent dashboard" />

    **Actions**

    Select action acc to your choice :
    Before the call
    During the call
    After the call

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/va3.jpg" alt="AI Agent dashboard" />
  </Step>

  <Step title="Add a prompt">
    Create a detailed prompt to guide your agent's behavior:

    * Define the agent's role and personality
    * Specify how to handle different scenarios
    * Include any industry-specific knowledge
    * Set response guidelines and restrictions
    * Add example conversations or templates

    <img src="https://storage.googleapis.com/helpsessionvideos/Contactswing/images/va4.jpg" alt="AI Agent dashboard" />
  </Step>

  <Step title="Test your agent">
    Make a test call to ensure your Voice AI Agent:

    * Responds appropriately to various inputs
    * Follows the defined prompt guidelines
    * Handles different scenarios correctly
    * Maintains natural conversation flow
  </Step>
</Steps>