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

# Vibe-Code Your Agent

> Tell Vaani what your agent should do in plain English and see magic happen with AI-assisted agent generation

**Vibe-Coding** allows you to describe your desired voice agent in everyday conversational English, and let Vaani's generative AI engine architect the complete agent specification for you.

Instead of manually drafting system prompts, picking language pipeline providers, and specifying JSON schemas, you simply type your requirements and let Vaani synthesize the agent in seconds.

<Frame>
  <img src="https://mintcdn.com/vaaniai/1z97x591P_yo5Lyb/images/screenshots/vibe-code-agnet.png?fit=max&auto=format&n=1z97x591P_yo5Lyb&q=85&s=cbd39eca440d7622cba9b566bac0ef71" alt="Vaani Create Agent Menu showing Vibe-Code Your Agent" width="1917" height="982" data-path="images/screenshots/vibe-code-agnet.png" />
</Frame>

## Why Vibe-Code?

<CardGroup cols={3}>
  <Card title="Zero to Live in 30 Seconds" icon="bolt">
    Describe a scenario and get a ready-to-call voice agent instantly without writing boilerplate rules.
  </Card>

  <Card title="AI-Optimized Prompts" icon="sparkles">
    Vaani applies speech-specific prompt engineering best practices (latency cues, interruption handling, conversational pauses).
  </Card>

  <Card title="Iterative Refinement" icon="arrows-rotate">
    Chat back and forth with the AI architect to refine tone, add constraints, or introduce external API tools.
  </Card>
</CardGroup>

***

## How to Vibe-Code Your Agent

<Steps>
  <Step title="Select 'Vibe-Code Your Agent'">
    Click **+ New Agent** in the dashboard and choose **Vibe-Code Your Agent**.
  </Step>

  <Step title="Describe Your Agent in Plain English">
    Enter a prompt detailing your business, target audience, and the tasks the voice agent should handle.

    > **Example Prompt:**
    > *"Create an inbound customer support agent for 'Zippy Logistics'. The agent should speak in English and Hindi, answer delivery status questions, ask for the 8-digit tracking number, apologize warmly if a package is delayed, and offer to create an escalation ticket with our team."*
  </Step>

  <Step title="Review the Generated Agent Architecture">
    Vaani's engine immediately generates:

    * **System Prompt**: A production-ready markdown prompt with role definitions, boundary constraints, and fallback dialog.
    * **Greeting Message**: A conversational, welcoming opening script.
    * **Language Pipeline**: Auto-selected STT (Deepgram Nova-2), Brain (LLM), and TTS voice (e.g., Sarvam Ritu for Hindi/English).
    * **Dynamic Metadata Variables**: Placeholders such as `{tracking_number}` and `{customer_name}`.
  </Step>

  <Step title="Refine through Conversational Feedback">
    Use the prompt chat interface to iterate on the fly:

    * *"Make the greeting sound more energetic and welcoming."*
    * *"Add a rule to never disclose internal warehouse hub addresses."*
    * *"Switch the voice to a calm, professional male tone."*
  </Step>

  <Step title="Test and Deploy">
    Click the in-browser **Test Audio** button to have a test conversation with your synthesized agent. Once satisfied, click **Save Agent** to get your `agent_id`.
  </Step>
</Steps>

***

## Tips for Great Vibe-Coding Prompts

To get the most accurate and high-performing agent from the generator, include these four elements in your description:

| Element | What to Include | Example |
| - | - | - |
| **Role & Persona** | Business name, agent persona, and vocal personality | *"Friendly front-desk assistant for Apex Dental Clinic"* |
| **Languages** | Primary languages and dialect requirements | *"Multilingual in English and Hinglish (Hindi + English)"* |
| **Objectives** | Concrete actions the agent should achieve on the call | *"Qualify patient urgency, collect phone number, and book appointment"* |
| **Guardrails** | What the agent must NOT do | *"Never provide medical diagnosis or commit to prices above ₹2,000 without doctor review"* |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Agent Experience" icon="sliders" href="/getting-started/agent-config/experience">
    Fine-tune interruption sensitivity, ambient sound, and conversational delays
  </Card>

  <Card title="Connect Knowledge Base" icon="book-open" href="/getting-started/agent-config/training">
    Upload FAQ documents and product manuals for your vibe-coded agent to reference
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.