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

# Voice agent quick start guide

> Build and launch your first voice agent in 3 minutes or less.

Create, configure, and call your first voice agent on Voiceflow. No coding required.

**1. Create a new project**

From the [Dashboard](https://creator.voiceflow.com), go to **Projects** → **New project**. Name your project, set the type to **Voice**, and select **Start from scratch**.

<video autoPlay loop muted playsInline src="https://mintcdn.com/voiceflow-009a8802/s3P1FU2SwfLb9qjL/videos/voice.mp4?fit=max&auto=format&n=s3P1FU2SwfLb9qjL&q=85&s=3d69d4aa621e0b7323ab975c3ce502b5" />

This opens the global agent view, where you'll configure your agent's high-level behavior.

**2. Set up your agent's persona**

In the **Global agent** description, click **generate** and describe your agent's actions, goals, and personality. You can also customize the agent's tone, speed, and how long it waits for a user to reply. Voiceflow will automatically create a detailed prompt in seconds.

For example:

```text theme={null}
You are Alex, a calm and friendly voice support agent for AcmeCorp.
Help customers with orders, returns, billing, and product questions.
Speak naturally in short, conversational sentences — avoid long
lists or complex phrasing. Stay warm, patient, and reassuring.
If you can't resolve an issue, offer to create a support ticket.
```

**3. Add a knowledge base (optional)**

To give your agent real information to reference, click the **Knowledge Base** icon in the left sidebar. You can add context by:

* **Uploading documents** - PDFs, text files, or CSVs (e.g., your FAQ, product catalog, or return policy).
* **Pasting a URL** - Your agent will index the content directly from the page.
* **Adding text manually** - Paste in key information directly.

Your agent will use this knowledge to answer questions accurately.

**4. Publish and call your agent**

Back in the **Agent** tab, click **Publish** in the top-right corner. To receive a call from your agent, click **Call** in the top-right, enter your phone number, and start speaking with your agent!

<video autoPlay loop muted playsInline src="https://mintcdn.com/voiceflow-009a8802/s3P1FU2SwfLb9qjL/videos/voice-publish.mp4?fit=max&auto=format&n=s3P1FU2SwfLb9qjL&q=85&s=fe31604a35124eb048e4a3ae58885953" />

That's it! Your agent is now deployed and available to use.

## Tips for refining your voice agent

* **Start simple.** Get a basic agent working first, then layer on complexity. You can add deterministic [Workflows](https://www.voiceflow.com/docs/documentation/build/workflows.md) and agentic [Playbooks](https://www.voiceflow.com/docs/documentation/build/playbooks.md) to get the most out of your agent.
* **Use your knowledge base.** The more relevant content you upload, the more accurate your agent's responses will be.
* **Iterate on your prompt.** Small tweaks to the system prompt can make a big difference in response quality.
* **Set up a phone number.** [Configure a dedicated number](https://www.voiceflow.com/docs/documentation/deploy/phone/connect-a-phone-number.md) so your agent can be reached by simply dialing in.

## What's next?

You've built your first voice agent on Voiceflow. Now learn how to build production-grade agents with our documentation.

> **[Playbooks](https://www.voiceflow.com/docs/documentation/build/playbooks.md)**
>
> Complete specialized tasks using AI.

> **[Workflows](https://www.voiceflow.com/docs/documentation/build/workflows.md)**
>
> Add logic and determinism to your agent.


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