PolyAI 中文文档 下载 App

ADK 安装与认证：uv、poly setup 和 API Key

前置：安装 uv

ADK 使用 uv（一个超快的 Python 包管理器）来管理 Python 环境和虚拟环境。安装 uv：

安装完 uv 后，poly 命令在你第一次使用时自动创建虚拟环境并安装 ADK——不需要手动 pip install。

认证：两种方式

PolyAI 有两种账户类型，认证方式略有不同：

自助注册账户（Self-serve）

运行：

poly start

浏览器会自动弹出 studio.poly.ai 的登录页（Google SSO 或邮箱密码），登录后 PolyAI 自动为你的用户创建 API Key 并保存在本地配置文件里。完成后回到终端，ADK 已准备就绪。

企业账户（Enterprise）

运行：

poly login --region <region>

企业账户需要指定区域（us-east / eu-west 等，取决于你的账户部署在哪里）。或者直接导出 API Key：

export POLY_ADK_KEY=<你的 API Key>

API Key 从 studio.poly.ai → 用户设置 → API Keys 页面生成。

完整的一条命令 setup

poly setup

这条命令会依次完成四个步骤：认证 → 区域配置 → API Key 保存 → 验证连接。每步如果已经做过就跳过，所以可以安全地多次运行。

用 API Key 认证的好处

API Key 认证的好处是可程序化——你可以在 CI / CD 流水线里直接设置环境变量，不需要交互式登录：

# GitHub Actions 示例
- name: Build agent
  env:
    POLY_ADK_KEY: ${{ secrets.POLY_ADK_KEY }}
  run: |
    poly init --region us-east --project my-project
    poly pull
    poly validate
    poly push

这让把智能体构建流程纳入自动化部署管道成为可能。

本地配置文件位置

认证信息和 API Key 存储在：

这个文件不要提交到 Git——里面有你的 API Key，泄露等于账号被盗。.gitignore 里应该包含这个路径。