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.

The Agent Development Kit (ADK) is a Python CLI (polyai-adk on PyPI) for building PolyAI agents locally. Pull your Agent Studio project as YAML and Python files, edit in your IDE (or with a coding assistant like Claude), version with Git, and push from the command line. API keys are self-serve — sign up at studio.poly.ai and generate one from your account.
For installation, authentication, and usage instructions, see the ADK documentation.

​
How it works

ADK uses a pull-edit-push workflow:
1

Initialize

Link a local directory to an Agent Studio project with poly init.
2

Pull

Run poly pull to download your project as structured YAML files organized by resource type: topics, flows, entities, and agent settings.
3

Edit

Edit with any tool: IDE, scripts, or AI coding assistants. YAML handles configuration, Python handles functions.
4

Push

Run poly push to diff your local changes against the remote state and send updates to Agent Studio. Your agent updates immediately in the target environment.
ADK is fully compatible with Agent Studio and the APIs. Switch between surfaces at any time.

​
CLI commands

CommandDescription
poly initLink a local directory to an Agent Studio project
poly pullDownload the current project state as YAML files
poly pushDiff local changes against remote and send updates
poly docsPrint documentation for any ADK resource type

​
Project structure

After pulling, your local directory contains human-readable YAML files organized by resource type: 
topics/
  Frequently Asked Questions.yaml
  Billing Issues.yaml
flows/
  greeting/
    flow_config.yaml
    flow_step_welcome.yaml
    flow_step_billing_check.yaml
entities/
  billing_amount.yaml
agent_settings/
  role.yaml
  personality.yaml
  rules.yaml
Each YAML file represents a single resource. For example, a topic file: 
enabled: true
actions: ""
content: |
  We accept Visa, Mastercard, and PayPal.
  Refunds take 3–5 business days.
example_queries:
  - What payment methods do you accept?
  - How long do refunds take?
  - Can I pay with PayPal?
Cross-references between resources use human-readable name tags like {{fn:check_billing}} rather than raw IDs. ADK resolves these automatically at push time.

​
Get started

Installation, authentication, and usage instructions:

ADK documentation

Guides, CLI reference, and examples.

Extend with code

Write Python functions and connect APIs in Agent Studio

API reference

Update and configure agents with PolyAI’s REST APIs
Last modified on May 18, 2026