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

# Quick Start

> Build your first voice agent in 10 minutes

# Build Your First Voice Agent

Get started with Hamsa by creating a simple customer support agent. This guide will have you up and running in about 10 minutes.

<Steps>
  <Step title="Choose Agent Type">
    For this quickstart, we'll create a **Single Prompt Agent** - the fastest way to get started.

    Navigate to **Agents** → **Create New Agent** → **Single Prompt**
  </Step>

  <Step title="Name Your Agent">
    Give your agent a descriptive name:

    ```
    Agent Name: Customer Support Bot
    ```
  </Step>

  <Step title="Write the Greeting">
    Set the first message callers will hear:

    ```
    Greeting: "Thank you for calling! I'm here to help. How can I assist you today?"
    ```

    Choose **Static** for greeting type.
  </Step>

  <Step title="Write the Preamble">
    This is your agent's core instructions. Copy and paste this template:

    ```
    ## Identity
    You are a helpful customer support assistant for Acme Corporation.

    ## Style Guardrails
    - Be concise (keep responses under 2 sentences unless explaining complex topics)
    - Be conversational and friendly
    - Use natural language and contractions
    - Be empathetic and patient

    ## Response Guidelines
    - Ask only one question at a time
    - Confirm understanding by paraphrasing
    - If you don't know something, be honest

    ## Task
    Your goal is to help customers with:
    1. General product questions
    2. Account inquiries
    3. Technical support issues

    If the issue requires human assistance, politely inform the caller
    that you'll connect them with a specialist.
    ```
  </Step>

  <Step title="Select Voice & Language">
    * **Language**: English (US)
    * **Voice**: Choose any voice - try `aura-asteria-en` for a friendly female voice

    <Tip>
      Preview voices before selecting to find the perfect match for your brand
    </Tip>
  </Step>

  <Step title="Configure Call Settings">
    Use these recommended settings for natural conversation:

    * **Response Delay**: 400ms (default)
    * **Allow Interruptions**: ON
    * **User Inactivity Timeout**: 15 seconds
    * **Max Call Duration**: 300 seconds (5 minutes)
  </Step>

  <Step title="Test Your Agent">
    Click **Test Agent** in the top right.

    **Browser Test:**

    1. Click "Start Test" in browser
    2. Allow microphone access
    3. Have a conversation with your agent
    4. Check real-time logs in the sidebar

    **Phone Test (Optional):**

    1. Click "Test via Phone"
    2. Enter your phone number
    3. Receive a call from your agent
  </Step>

  <Step title="Deploy (Optional)">
    To make your agent live:

    1. Go to **Phone Numbers** tab
    2. Purchase or connect a phone number
    3. Assign it to your agent
    4. Save changes

    Your agent is now live and ready to take calls!
  </Step>
</Steps>

## What You Built

Congratulations! You just created a functional voice agent that can:

* Greet callers professionally
* Handle general inquiries
* Maintain natural conversation flow
* Handle interruptions and silence appropriately

## Next Steps

<CardGroup cols={2}>
  <Card title="Add Knowledge Base" icon="book" href="/overview/features/knowledge-base">
    Upload company FAQs and documentation
  </Card>

  <Card title="Add Custom Tools" icon="wrench" href="/overview/features/tools">
    Integrate with your APIs and systems
  </Card>

  <Card title="Advanced Settings" icon="sliders" href="/agents/single-prompt/configure-settings">
    Fine-tune voice, timing, and behavior
  </Card>

  <Card title="Build Flow Agent" icon="diagram-nodes" href="/agents/flow-agent/overview">
    Create complex conversation workflows
  </Card>
</CardGroup>

## Common Next Steps

### Add a Knowledge Base

Give your agent access to company information:

1. Navigate to **Knowledge Bases** → **Create New**
2. Upload documents (PDF, DOC, TXT) or add web URLs
3. Return to your agent settings
4. Select the knowledge base in **Knowledge Base** tab
5. Test with questions about your content

### Add Custom Tools

Integrate with your systems:

1. Go to **Tools** → **Create New Tool**
2. Configure your API endpoint
3. Define parameters
4. Add the tool to your agent
5. Update the preamble to mention when to use the tool

### Enable Smart Features

Enhance your agent's capabilities:

* **Smart Call End**: Automatically end when conversation concludes
* **Gender Detection**: Personalize responses based on caller gender
* **Agentic RAG**: Advanced knowledge retrieval with reasoning

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent not responding">
    * Check microphone permissions
    * Verify voice is selected
    * Ensure preamble is not empty
    * Try refreshing the page
  </Accordion>

  <Accordion title="Voice sounds robotic">
    * Try a different voice from the voice library
    * Adjust response delay (lower = more responsive)
    * Enable "Thinking Voice" for natural pauses
  </Accordion>

  <Accordion title="Agent interrupts too quickly">
    * Increase response delay to 600-800ms
    * This gives users more time to complete thoughts
  </Accordion>

  <Accordion title="Test call not connecting">
    * Verify phone number format (+1XXXXXXXXXX)
    * Check your workspace has calling credits
    * Try browser test first to verify agent works
  </Accordion>
</AccordionGroup>

## Video Tutorial

<iframe width="560" height="315" src="https://www.youtube.com/embed/YOUR_VIDEO_ID" title="Quick Start Tutorial" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

## Need Help?

<Card title="Join Our Discord Server Community" icon="discord" href="https://discord.gg/gDNwSD3E2V">
  Ask questions, share experiences, and get help from the Hamsa community
</Card>

***

**Ready to build something more complex?** Check out our **[Flow Agent Guide](/agents/flow-agent/overview)** to learn about visual conversation design.