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

# Conversational AI Quickstart

> Deploy conversational AI with the Voice.ai Voice Agents API. Learn how to create agents, configure LLM prompts, assign phone numbers, and go live in minutes

Create and deploy a voice agent in minutes.

<Info>
  **Prerequisites**: [API key](/docs/guides/authentication), phone number (see [Phone Number Management](/docs/guides/voice-agents/phone-numbers) to select one)
</Info>

<Steps>
  <Step title="Create Your Agent">
    ```python theme={null}
    import requests

    response = requests.post(
        'https://dev.voice.ai/api/v1/agent/',
        headers={'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'},
        json={
            'name': 'My First Agent',
            'config': {
                'prompt': 'You are a helpful call center agent. Help customers with billing, returns, and questions.',
                'greeting': 'Thank you for calling. How can I help you?',
                'llm_model': 'gemini-2.5-flash-lite',
                'allow_interruptions': True,
                'min_interruption_words': 1,
                'auto_noise_reduction': True
            }
        }
    )

    agent_id = response.json()['agent_id']
    print(f'Agent ID: {agent_id}')
    ```
  </Step>

  <Step title="Assign a Phone Number">
    Assign your phone number to the agent:

    ```python theme={null}
    import requests

    headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}

    # Pause agent to update
    requests.post(f'https://dev.voice.ai/api/v1/agent/{agent_id}/pause', headers=headers)

    # Update agent with phone number
    requests.put(
        f'https://dev.voice.ai/api/v1/agent/{agent_id}',
        headers=headers,
        json={'config': {'phone_number': '+14155551234'}}
    )

    print('Phone number assigned!')
    ```
  </Step>

  <Step title="Deploy">
    Deploy your agent to make it active:

    ```python theme={null}
    import requests

    requests.post(
        f'https://dev.voice.ai/api/v1/agent/{agent_id}/deploy',
        headers={'Authorization': 'Bearer YOUR_API_KEY'}
    )

    print('Agent deployed!')
    ```
  </Step>
</Steps>

## Test Your Agent

Call your assigned phone number to test your agent. The agent will answer with your configured greeting and handle conversations based on your prompt.

<CardGroup cols={3}>
  <Card title="Web SDK" icon="code" href="/docs/guides/voice-agents/web">
    Connect from JavaScript/TypeScript with real-time voice, TTS, and more
  </Card>

  <Card title="Phone Number Management" icon="phone" href="/docs/guides/voice-agents/phone-numbers">
    Search, select, and assign phone numbers
  </Card>

  <Card title="Agent Configuration" icon="sliders" href="/docs/guides/voice-agents/configuration">
    Complete reference for all configuration parameters
  </Card>

  <Card title="API Reference" icon="book" href="/docs/api-reference">
    Complete API documentation
  </Card>
</CardGroup>