Agent Development Kit (ADK)
A CLI and Python package for managing Agent Studio projects locally. It provides a Git-like workflow for synchronizing project configurations between your local filesystem and the Agent Studio platform.
Installation
pip install polyai-adk
Once installed, use the poly command to manage your projects:
poly start # Create an account, access token and new project
poly init # Initialize a project
poly project # Manage poly projects
poly pull # Pull latest configuration
poly push # Push local changes
poly status # View project status
poly diff # View local changes
poly branch # Manage branches
poly format # Format resources
poly validate # Validate configuration
poly review # Create a review gist
poly deployments # Manage deployments
poly docs # Output reference documentation
Usage
Install the ADK from PyPI:
pip install polyai-adk
Once installed, the poly CLI command becomes available.
poly init # Initialize a project (interactive)
poly pull # Pull latest configuration
poly push # Push local changes
poly status # View project status
poly diff # View local changes
poly branch # Manage branches
poly format # Format resources
poly validate # Validate configuration
poly review # Create a review gist
poly deployments # List deployment history
Run:
poly --help
to see all available commands.
Each command also supports --help for detailed syntax:
poly push --help
Commands
Run poly --help to see all available commands and options. Each command also supports --help for detailed syntax (e.g. poly push --help).
poly init
Initialize a new Agent Studio project locally. Runs interactively by default, prompting for region, account, and project. You can also pass these directly:
poly init
poly init --region us-1 --account_id 123 --project_id my_project
poly init --base-path /path/to/projects
poly init --format # format resources after init
poly pull
Pull the latest project configuration from Agent Studio:
poly pull
poly pull --force # overwrite all local changes
poly pull --format # format resources after pulling
poly push
Push local changes to Agent Studio:
poly push
poly push --dry-run # preview what would be pushed
poly push --skip-validation # skip local validation before pushing
poly push --force # overwrite remote changes
poly push --format # format resources before pushing
poly status
View changed, new, and deleted files in your project:
poly status
poly diff
Show diffs between your local project and the remote version, or between two named versions:
poly diff # local vs remote (all changes)
poly diff --files file1.yaml # specific files only
poly diff abc1234 # version hash vs its predecessor
poly diff --before hash1 --after hash2 # compare two specific versions
poly revert
Revert local changes:
poly revert # revert all changes
poly revert file1.yaml file2.yaml # revert specific files
poly branch
Manage branches (default branch is main):
poly branch list
poly branch current
poly branch create my-feature
poly branch switch my-feature
poly branch switch my-feature --force # discard uncommitted changes
poly format
Format project resources (Python via ruff, YAML/JSON via in-process formatting). Use --check to only report files that would change; use --ty to also run type checking.
poly format # all resources
poly format --files file1.py # specific files
poly format --check # check only, no writes
poly validate
Validate project configuration locally:
poly validate
poly review
Create a GitHub gist for reviewing changes, similar to a pull request:
poly review create # local vs remote
poly review create abc1234 # version hash vs its predecessor
poly review create --before hash1 --after hash2 # compare two specific versions
poly review create --before main --after feature-branch # compare branches
poly review list # list existing review gists
poly review delete # delete all review gists
poly deployments
List deployment history for the project:
poly deployments # last 10 sandbox deployments
poly deployments --env live # live environment
poly deployments --limit 20 --offset 10 # pagination
poly deployments --hash abc1234 # start from a specific version
poly deployments --details # full metadata per deployment
poly chat
Start an interactive chat session with your agent:
poly chat
poly chat --environment live
poly chat --channel webchat
poly chat --metadata # show functions, flows, and state each turn
# Simulate one SIP header
poly chat --sip-header X-Customer-ID=12345
# Simulate multiple SIP headers
poly chat --sip-header X-Customer-ID=12345 --sip-header X-Language=en-GB
--sip-header NAME=VALUE is repeatable and simulates headers exposed to project
functions through conv.sip_headers. It does not create a SIP call or reproduce
carrier-level SIP behaviour.
poly docs
Output ADK documentation
poly docs
poly docs -all
poly docs {documentation (e.g topics)}
poly docs --output doc_file.md
Bugs & Feature Requests
Please report bugs or request features via the GitHub Issues page.
Contributing
See CONTRIBUTING.md for development setup, code style, and contribution guidelines.
License
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file polyai_adk-0.39.0.tar.gz.
File metadata
- Download URL: polyai_adk-0.39.0.tar.gz
- Upload date:
- Size: 347.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df224f1f843486c474f7246bec7efb6e35ea4c1ceb6ea1f1c7f50f5bb2eeb652
|
|
| MD5 |
8a7033a2b5299bc689cba7700015d76b
|
|
| BLAKE2b-256 |
ad4bca32aaa64fdb40d8744ca0ad4fa5e7aa5074a9ae97b2b5ff7a70ae57777d
|
Provenance
The following attestation bundles were made for polyai_adk-0.39.0.tar.gz:
Publisher:
release.yaml on polyai/adk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
polyai_adk-0.39.0.tar.gz -
Subject digest:
df224f1f843486c474f7246bec7efb6e35ea4c1ceb6ea1f1c7f50f5bb2eeb652 - Sigstore transparency entry: 2409826717
- Sigstore integration time:
-
Permalink:
polyai/adk@2f7fed19f163f9ac7f803dffc558d9916b78925b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/polyai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@2f7fed19f163f9ac7f803dffc558d9916b78925b -
Trigger Event:
push
-
Statement type:
File details
Details for the file polyai_adk-0.39.0-py3-none-any.whl.
File metadata
- Download URL: polyai_adk-0.39.0-py3-none-any.whl
- Upload date:
- Size: 445.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c3c021aef66649f6b9500d6af98f6aac299147577236de13daf8408f8aa354cc
|
|
| MD5 |
cf48fa215ef57b6958bf8fa304652c93
|
|
| BLAKE2b-256 |
70750c4c12064950de71a1ccee8a72cfb2bc1fc679d8ed45042cea0efef0095f
|
Provenance
The following attestation bundles were made for polyai_adk-0.39.0-py3-none-any.whl:
Publisher:
release.yaml on polyai/adk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
polyai_adk-0.39.0-py3-none-any.whl -
Subject digest:
c3c021aef66649f6b9500d6af98f6aac299147577236de13daf8408f8aa354cc - Sigstore transparency entry: 2409826888
- Sigstore integration time:
-
Permalink:
polyai/adk@2f7fed19f163f9ac7f803dffc558d9916b78925b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/polyai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@2f7fed19f163f9ac7f803dffc558d9916b78925b -
Trigger Event:
push
-
Statement type:
