Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.poly.ai/llms.txt

Use this file to discover all available pages before exploring further.

PolyAcademy
PolyAcademy is a step-by-step path from a blank project to a production agent, organised 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.

​
Before you start

Design principles

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

​
Choose your level

Level 1: Build your first agent

Go from a blank project to a working agent you can talk to – no code required.For: First-time users · ~30 min

Level 2: Make it smarter

Add functions, multi-turn topics, response controls, and audio tuning.For: Users who completed Level 1

Level 3: Production polish

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:
1

Learn the concept

A short explanation with examples – just enough to get going
2

Quiz yourself

Quick questions to check you understood the key idea
3

Try it yourself

A hands-on challenge you complete in Agent Studio
4

Track your progress

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

​
What you’ll build at each level

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
No coding needed. Level 1 is designed for anyone – even if you’ve never used Agent Studio before.
You’ll add real power to your agent – 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
  • Variant management for multi-location agents
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
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.
Last modified on May 19, 2026