PolyAI
에이전트 개발 키트 (Agent Development Kit, ADK)
PyPI version
Python 3.14
License: Apache 2.0
Ruff
Develop with Claude Code
PolyAI 음성 및 채팅 에이전트를 구축, 테스트 및 배포하기 위한 CLI입니다.
PolyAI가 처음이신가요? studio.poly.ai에서 가입하고 무료로 시작하세요.
문서(Documentation)
설치 방법 (Installation)
UV를 통해:
uv tool install polyai-adk
Pip을 통해:
음성 통화(poly call)에는 추가적인 오디오 및 WebRTC 종속성이 필요하며, 이는 CI 환경에서 용량을 작게 유지하기 위해 기본 설치에서 제외됩니다. call extra를 사용하여 설치하세요:
pip install "polyai-adk[call]"
uv tool install "polyai-adk[call]"
그런 다음 계정, API key, AI 스킬 및 프로젝트를 설정합니다:
설정이 완료되면 poly 명령어를 사용하여 프로젝트를 관리하세요:
poly setup
poly apikey
poly init
...
사용 방법 (Usage)
PyPI에서 ADK를 설치합니다:
설치되면 poly CLI 명령어를 사용할 수 있게 됩니다.
poly init
poly pull
poly push
...
사용 가능한 모든 명령어를 보려면 다음을 실행하세요:
각 명령어는 상세한 구문을 위해 --help도 지원합니다:
명령어 (Commands)
사용 가능한 모든 명령어와 옵션을 보려면 poly --help를 실행하세요. 각 명령어는 상세한 구문(예: poly push --help)을 위해 --help도 지원합니다.
poly init
로컬에서 새로운 Agent Studio 프로젝트를 초기화합니다. 기본적으로 대화형(interactive)으로 실행되며, 리전(region), 계정(account), 프로젝트에 대한 입력을 요청합니다. 또한 이 값들을 직접 전달할 수도 있습니다:
poly init
poly init --region us --account_id 123 --project_id my_project
poly init --base-path /path/to/projects
...
poly pull
Agent Studio에서 최신 프로젝트 구성을 가져옵니다(pull):
poly pull
poly pull --force
poly pull --format
poly push
로컬 변경 사항을 Agent Studio로 푸시합니다(push):
poly push
poly push --dry-run # 푸시될 내용을 미리 보여줍니다
poly push --skip-validation # 푸시 전 로컬 유효성 검사를 건너뜁니다
...
poly status
프로젝트에서 변경되거나(changed), 새로 추가되었거나(new), 삭제된(deleted) 파일을 확인합니다:
poly diff
로컬 프로젝트와 원격 버전 간의 차이점(diff) 또는 두 개의 이름 지정된 버전 간의 차이점을 보여줍니다:
poly diff
poly diff --files file1.yaml
poly diff abc1234
...
poly revert
로컬 변경 사항을 되돌립니다(revert):
poly revert
poly revert file1.yaml file2.yaml
poly branch
브랜치(branch)를 관리합니다 (기본 브랜치는 main):
poly branch list
poly branch list --archived
poly branch current
...
간소화된 배포(simplified deployments)를 사용하는 프로젝트의 경우, 브랜치를 스테이징(stage)할 수도 있습니다:
poly branch tag
poly branch untag
poly branch sync, tag, 및 untag는 간소화된 배포가 활성화된 프로젝트에서만 사용할 수 있으며, 그렇지 않은 경우에는 오류와 함께 종료됩니다.
프로젝트 리소스 포맷팅 (ruff를 통한 Python, 인프로세스 포맷팅을 통한 YAML/JSON). 변경될 파일만 보고하려면 --check를 사용하고, 타입 검사(type checking)도 실행하려면 --ty를 사용합니다.
poly format
poly format --files file1.py
poly format --check
poly validate
프로젝트 구성을 로컬에서 검증합니다:
poly review
풀 리퀘스트(pull request)와 유사하게 변경 사항을 검토하기 위한 GitHub gist를 생성합니다:
poly review create
poly review create abc1234
poly review create --before hash1 --after hash2
...
poly deployments
프로젝트의 배포 기록 목록을 보여줍니다:
poly deployments
poly deployments --env live
poly deployments --limit 20 --offset 10
...
poly chat
에이전트와 상호작용하는 채팅 세션을 시작합니다:
poly chat
poly chat --environment live
poly chat --channel webchat
...
--sip-header NAME=VALUE는 반복 가능하며, conv.sip_headers를 통해 프로젝트 함수에 노출되는 헤더를 시뮬레이션합니다. 이는 SIP 호출을 생성하거나 통신사 수준의 SIP 동작을 재현하지 않습니다.
poly docs
ADK 문서를 출력합니다
poly docs
poly docs -all
poly docs {문서 주제 (예: topics)}
...
버그 및 기능 요청
버그나 기능을 요청하려면 GitHub Issues 페이지를 이용해 주십시오.
기여하기
개발 설정, 코드 스타일 및 기여 가이드라인은 CONTRIBUTING.md를 참조하십시오.
라이선스
본 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참고하십시오.
