> ## 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.

# Voice Agents

> Build intelligent AI voice agents for phone and web

Hamsa is a comprehensive platform for building, testing, deploying, and monitoring reliable AI voice agents. Our platform provides complete solutions for creating conversational AI agents that interact naturally over the phone or on the web, with advanced features for both simple and complex conversation flows.

## What are Voice Agents?

Voice agents are AI-powered conversational systems that interact with users in natural language through voice. They can be deployed over phone calls (via telephony) or embedded directly into your website or app using the [Hamsa Voice Agents SDK](/developers/sdks/voice-agents-web-sdk). They can:

* Answer questions and provide information
* Collect data from callers
* Make decisions based on conversation context
* Execute actions like transferring calls or sending SMS
* Access your company's knowledge base
* Integrate with your existing systems via tools and APIs

## Key Capabilities

### Natural Conversations

Our agents support natural, human-like conversations in multiple languages and dialects, with advanced speech recognition and synthesis capabilities.

### Intelligent Decision Making

Powered by leading LLM models (GPT-4.1, Gemini, etc.), agents can understand context, handle complex scenarios, and make intelligent decisions during conversations.

### Flexible Architecture

Choose between simple single-prompt agents for straightforward use cases, or powerful flow-based agents for complex, multi-step conversations.

### Enterprise-Ready Features

* Real-time call monitoring and testing
* Comprehensive logging and analytics
* Knowledge base integration
* Custom tool/function calling
* Webhook integrations
* Phone number management and web SDK deployment

## Two Approaches to Building Agents

Hamsa offers two distinct approaches for building voice agents, each suited to different complexity levels and use cases:

### 1. Single Prompt Agent

A single prompt agent uses one comprehensive prompt to define all agent behaviors, making it the simplest approach to get started. Perfect for simple information gathering, basic customer support, and quick prototypes.

**Explore Single Prompt Agent:**

<CardGroup cols={2}>
  <Card title="Overview" icon="house" href="./single-prompt/overview">
    Understand the basics of single prompt agents
  </Card>

  <Card title="Write Prompt" icon="pen-nib" href="./single-prompt/write-prompt">
    Learn how to write effective prompts for your agent
  </Card>

  <Card title="Call Behavior" icon="phone-flip" href="./single-prompt/call-behavior">
    Configure how your agent handles calls
  </Card>

  <Card title="Voice Settings" icon="microphone" href="./single-prompt/voice-settings">
    Customize the voice and speech characteristics
  </Card>

  <Card title="Intelligence Features" icon="brain" href="./single-prompt/intelligence-features">
    Add advanced AI features to your agent
  </Card>

  <Card title="Configure Settings" icon="gear" href="./single-prompt/configure-settings">
    Fine-tune your agent's technical configuration
  </Card>
</CardGroup>

### 2. Flow Agent

Flow agents allow you to create complex, visual conversation flows with multiple nodes and conditional transitions. Ideal for multi-step processes, advanced call routing, and integration-heavy applications.

**Explore Flow Agent:**

<CardGroup cols={2}>
  <Card title="Overview" icon="house" href="./flow-agent/overview">
    Introduction to visual conversation flows
  </Card>

  <Card title="Global Settings" icon="earth-americas" href="./flow-agent/global-settings">
    Configure settings that apply across your entire flow
  </Card>

  <Card title="Global Nodes" icon="network-wired" href="./flow-agent/global-nodes">
    Manage nodes that are accessible from anywhere in the flow
  </Card>

  <Card title="Variables" icon="brackets-curly" href="/agents/variables/introduction">
    Use and manage conversation data with variables
  </Card>

  <Card title="Transitions" icon="arrow-right-arrow-left" href="./flow-agent/transitions">
    Define the logic for moving between nodes
  </Card>

  <Card title="DTMF" icon="phone-keypad" href="./flow-agent/dtmf">
    Handle keypad input during calls
  </Card>

  <Card title="Debugging" icon="bug" href="./flow-agent/debugging">
    Tools and techniques for troubleshooting flows
  </Card>

  <Card title="Best Practices" icon="star" href="./flow-agent/best-practices">
    Tips for building reliable and effective flow agents
  </Card>
</CardGroup>

#### Nodes Reference

<CardGroup cols={3}>
  <Card title="Nodes Overview" icon="list" href="./flow-agent/nodes/overview" />

  <Card title="Start Node" icon="play" href="./flow-agent/nodes/start-node" />

  <Card title="Conversation" icon="comments" href="./flow-agent/nodes/conversation-node" />

  <Card title="Router" icon="route" href="./flow-agent/nodes/router-node" />

  <Card title="Tool" icon="wrench" href="./flow-agent/nodes/tool-node" />

  <Card title="Web Tool" icon="globe" href="./flow-agent/nodes/web-tool-node" />

  <Card title="Transfer Call" icon="phone-arrow-right" href="./flow-agent/nodes/transfer-call-node" />

  <Card title="Transfer Agent" icon="user-plus" href="./flow-agent/nodes/transfer-agent-node" />

  <Card title="End Call" icon="phone-slash" href="./flow-agent/nodes/end-call-node" />
</CardGroup>

## Getting Started

1. **Choose Your Agent Type** - Decide between Single Prompt or Flow Agent based on your use case
2. **Configure Global Settings** - Set up voice, language, LLM model, and behavior settings
3. **Design Your Conversation** - Write prompts (Single Prompt) or design flow (Flow Agent)
4. **Add Integrations** - Connect knowledge bases, tools, and webhooks
5. **Test Thoroughly** - Use our browser and phone testing capabilities
6. **Deploy** - Assign a phone number for telephony, or integrate the [Voice Agents SDK](/developers/sdks/voice-agents-web-sdk) for web

## Platform Features

Hamsa provides comprehensive features across the entire agent lifecycle:

* **Build**: Intuitive UI for creating and configuring agents
* **Test**: Real-time testing in browser or via phone call
* **Monitor**: Live call monitoring with detailed logs
* **Deploy**: Phone numbers for telephony, or the [Voice Agents SDK](/developers/sdks/voice-agents-web-sdk) for web
* **Integrate**: Knowledge bases, custom tools, webhooks, and more
* **Optimize**: LLM configuration, voice customization, and performance tuning

Ready to build your first voice agent? Let's get started!