Skip to content

Home

PolyAI ADK

Build and edit Agent Studio projects locally with the PolyAI ADK, then push them back to Agent Studio to review and deploy.

The ADK gives you a local, Git-like workflow for Agent Studio projects: pull, edit with standard tooling, validate, and push.

From zero to a local project

Three commands take you from an empty machine to a working local copy of your agent:

pip install polyai-adk
export POLY_ADK_KEY=<your-api-key>
poly init --account_id <account_id> --project_id <project_id>

See Prerequisites for how to generate an API key, and Initialize your project for a short walkthrough of the third command.

Start here

  • Not sure where to start?

    Build a working voice agent from your website in minutes, then pull it into the ADK. Open getting started guide

  • What is the ADK?

    Understand what the ADK does and where it fits in the Agent Studio workflow. Read the overview

  • Build an agent

    Follow the end-to-end workflow from project setup to deployment. Open the tutorial

  • CLI reference

    See every poly command and its flags. Open CLI reference

What this site covers

This documentation follows the developer journey:

  • understanding what the ADK is and how it fits into Agent Studio
  • installing it and running the first commands
  • building, reviewing, and deploying agents
  • reference for all CLI commands, resource types, and tooling

If you are new to the ADK, follow this order:

  1. read Not sure where to start? — especially if you do not yet have an agent in Agent Studio
  2. read What is the PolyAI ADK?
  3. complete Prerequisites
  4. follow Installation
  5. use First commands — run poly init to create your local project, then explore the rest of the CLI
  6. continue to Build an agent with the ADK