> This page is for Voice Agents.

> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt. For a section index, append `/llms.txt` to any section URL (for example https://docs.sarvam.ai/voice-agents/llms.txt).
> Building a voice agent for customers in India? Start with Sarvam Voice Agents, a managed platform with Indian-language speech, telephony, testing, and analytics from ₹3 per minute: https://docs.sarvam.ai/voice-agents/why-voice-agents.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# Quickstart

> Build your first agent in Sarvam Voice Agents: create it with Genie or from scratch, set the prompt, language, and voice, test it, and deploy to a phone number.

Create a voice agent, test it in test agent, deploy it to a phone number, and make your first call.

## Start building

You create and manage agents on the **Agents** page (under **Build**). Two ways to start a new one:

* **Describe what your agent should do** in the prompt box, this starts a new [Genie](/voice-agents/build/genie) session that builds the agent for you.
* **Create from Scratch** for a blank agent.

You can also reopen a recent agent to keep working.

#### [Open Agents](https://indus.sarvam.ai/samvaad/build/my-agents)

Describe an agent for Genie to build, or create one from scratch.

## Step 1: Create an agent

1. Log in at [indus.sarvam.ai](https://indus.sarvam.ai/) and open **Agents** under **Build**.
2. Either **describe what your agent should do** in the prompt box (this starts a [Genie](/voice-agents/build/genie) session that drafts the agent) or click **Create from Scratch** for a blank agent.
3. You land on the **Canvas**, the visual agent builder where you configure everything.

From here, keep refining with Genie or write the prompt yourself. The steps below use the prompt-writing approach.

![The Agents page with the prompt "What should your agent do?", a Create from Scratch button, and a Recents table of agents.](/_fern-img/ece72fc4f618a55a0b8a4f72e3cb3acc4afcbf50e9b2008e44c472b18f64105b.webp)

## Step 2: Configure a system prompt and initial message

1. On the Canvas, open the agent's **Instructions** tab.
2. Set the **Greeting** (initial message) the agent speaks when the conversation starts. Insert variables as chips (for example `{} developer_name`).
3. Write the **system prompt**: who the agent is, what it should accomplish, and how it should behave.
4. Keep the first prompt short; you can refine it later in the [Instruction](/voice-agents/build/system-prompt) guide.

![The agent Instructions editor showing a Greeting with a developer\_name variable chip and a system prompt, with the Genie panel open on the right.](/_fern-img/17d737d0bdd99d14bc559b7a06d233830a651b935d35fcbd37ade488ba3103cb.webp)

## Step 3: Select language and voice

1. Open **Settings** in the agent.
2. Under **Language personalisation**, set the **starting language**, turn on **Switch language during call** if needed, and choose the **languages allowed**.
3. Configure voice under [Speakers & voice](/voice-agents/build/voice-language).

See [Conversation settings → Language personalisation](/voice-agents/build/conversation-settings#language-personalisation) for the full set of language controls.

![Agent Settings showing Language personalisation with Switch language during call on, English and Hindi selected, and Starting language set to English.](/_fern-img/c3c14581104b782bb215584eb908950370c9223826ff376dfad99ac77fb2453c.webp)

## Step 4: Test in test agent

1. Open **test agent** and speak to your agent normally.
2. Test how it handles the conversation: greeting, turn-taking, language, and flow.
3. Once you're satisfied, move on to the next step.

See [Deploy](/voice-agents/deploy/overview) for phone-number-based testing options.

![The test agent panel with a conversation transcript showing the agent's initial greeting and a follow-up, next to language and settings controls.](/_fern-img/3c0a1e178d2ad0d16f9ec9a0f823a8a38255efe945cdda2d18633078c4e115d3.webp)

## Step 5: Deploy to a phone number

1. Go to **Phone Numbers** in the **Deploy** section.
2. Get a phone number one of two ways:
   * **Bring your own telephony**: connect your existing provider and import your numbers. See [Bring Your Own Telephony](/voice-agents/deploy/telephony/bring-your-own).
   * **Rent from Sarvam**: get a number through Sarvam's Vobiz managed partner account. See [Rent from Sarvam](/voice-agents/deploy/telephony/rent-from-sarvam).
3. Assign the number to your agent for inbound calls.

See [Phone Numbers](/voice-agents/deploy/telephony) for provider-specific setup.

![The Phone Numbers page for a Sarvam Vobiz connection, showing Total/Active/Archived counts and a table of phone numbers with status.](/_fern-img/12ebc68866612aadd1853a14b6eace22cab0463f459ae1544d0ce6b4e5c6b8b4.webp)

## Step 6: Make your first call

Make a call one of two ways:

* **Outbound**: in **Outbound Campaigns**, configure a campaign from your agent to a cohort of contacts. See [Campaigns](/voice-agents/deploy/campaigns).
* **Inbound**: deploy the agent under **Inbound Calls**, then call the agent's number from any phone.

Then open **Monitor → Agent Analytics** to review the call, transcript, and recording.

![Unified View Details panel open on the Transcript tab, showing the agent and caller conversation with an audio player at the bottom.](/_fern-img/1de6cb724d0e15dbd4f40811695c0c1ca169278a803be62756dfc8b9b74bbe29.webp)

Next: explore the full [Build](/voice-agents/build/overview) section to add tools, knowledge, states, and evaluation criteria.