> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://poly-ai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server.

# Home

> Learn to build, configure, and maintain production-ready voice agents through hands-on guides across three skill levels.

![PolyAcademy](/_fern-files/_img/caea9624710a5b71417c3021a987d41b3a4e07a7c179d6f7639ab0f2d3267f57.webp)

> **Info**
>
> **PolyAcademy** is a step-by-step path from a blank project to a production agent, organized by skill level.

PolyAcademy is structured for builders who are new to PolyAI and for teams refining an existing agent. If you already have a live agent, go directly to [Maintain](/academy/maintain/home).

## Before you start

#### [Design principles](/academy/poly-academy/design-principles)

Core priorities, practical guidelines, and the reasoning behind agent design decisions.

## Choose your level

#### [Level 1: Build your first agent](/academy/poly-academy/get-started)

Go from a blank project to a working agent you can talk to – no code required.

**For:** First-time users · \~30 min

#### [Level 2: Advanced configuration](/academy/poly-academy/poly-academy-level-2/add-complex-topics)

Add functions, multi-turn topics, response controls, and audio tuning.

**For:** Users who completed Level 1

#### [Level 3: Production polish](/academy/poly-academy/poly-academy-level-3/code-organization)

Organize code, build flows, write natural speech, and polish voice quality.

**For:** Developers and senior designers

## How each lesson works

Every lesson follows the same pattern so you always know what to expect:

#### Learn the concept

A short explanation with examples – just enough to get going

#### Quiz yourself

Quick questions to check you understood the key idea

#### Try it yourself

A hands-on challenge you complete in Agent Studio

#### Track your progress

Mark lessons complete as you go and pick up where you left off

## What you'll build at each level

#### Level 1: Your first working agent

By the end, you'll have a real agent that answers questions, speaks with a configured voice, and is safely versioned across environments.

* Create and configure a project
* Build simple FAQ topics
* Test in Chat and Call
* Manage environments and versions
* Review conversations to see what happened

> **Tip**
>
> No coding needed. Level 1 is designed for anyone – even if you've never used Agent Studio before.

#### Level 2: Advanced capabilities

Extend your agent with multi-turn conversations, automated actions, and fine-tuned speech.

* Complex multi-turn topics with actions
* Functions and return values
* Response controls and pronunciations
* Audio management and voice tuning
* Global ASR biasing
* Variants for multi-location agents

#### Level 3: Production-quality experience

You'll learn the techniques that make agents sound professional and scale reliably.

* Code organization with imports and shared utilities
* Flows for structured multi-turn interactions
* Flow patterns: collection, validation, handoff
* Writing natural agent speech
* Voice polish: filler, turn-taking, personalization

> **Tip**
>
> Each PolyAcademy lesson links to the relevant **reference page** in the Help Center. Look for the "Go deeper" links at the end of each section.