Agent Development Kit（ADK）：Python CLI + Git 工作流的本地构建方式
为什么需要 ADK
Agent Studio 的可视化界面适合产品经理和运营团队配置话题、Flow 和基础参数。但对于需要写 Python 函数、做复杂逻辑、或者希望用 Git 做版本管理和协作的开发团队来说，纯可视化界面就不够用了。
ADK（Agent Development Kit）解决这个问题——它把 Agent Studio 项目的完整配置拉成人类可读的 YAML 文件和 Python 文件，你在本地 IDE 里编辑、用 Git 做版本控制，然后 push 回去。整个工作流和传统的代码项目开发体验一致。
核心价值
| 方面 | Agent Studio 界面 | ADK |
|---|---|---|
| 适合谁 | 产品、运营、客服 | 开发者 |
| 编辑方式 | 浏览器可视化界面 | IDE（VS Code / Cursor / 任意编辑器） |
| 版本管理 | PolyAI 内部版本历史 | Git + 完整提交历史 |
| 协作 | 多人在同一个 Branch 上改、冲突时手动解决 | 标准 Git 分支协作（PR / Code Review） |
| Python 函数 | Studio 界面里写（适合简单函数） | 本地 IDE 里完整开发（调试、测试、依赖管理） |
| AI 协作 | Agent Builder 对话框 | 直接用 AI coding assistant 驱动（Claude / Copilot） |
三个构建界面的统一关系
Agent Studio（可视化） ──┐
Agent Builder（AI 对话） ──┼── 指向同一个底层项目配置（YAML + Python）
ADK（Python CLI + Git） ──┘这三种方式指向同一份数据——你在 Studio 里配好的 Flow，pull 下来就是一个 YAML 文件；你在本地 IDE 里用 ADK 改完 push，Studio 界面里的内容实时更新。团队里每个人可以用自己最熟悉的界面，互相之间无缝接力。
ADK 工作流七步
init → pull → branch → edit → validate → push → review/merge- init：把本地目录和 Agent Studio 项目关联
- pull：把当前项目的所有配置拉成本地 YAML / Python 文件
- branch：创建本地分支（和 Studio 的 Branch 机制一致）
- edit：在 IDE 里编辑任意文件
- validate：本地校验配置（发现错误比 push 之后才报快）
- push：diff 本地改动 vs 远端，然后发送更新
- review / merge：可以在 ADK 里用
poly review生成 GitHub Gist 做 PR 式 review，或直接 push 到已有的 Studio Branch 上
适合团队的哪些工作
ADK 最适合以下场景：
- 写 Python 转场函数：需要复杂逻辑、API 调用、条件判断的场景
- Flow 的精细化调整：Studio 可视化界面能搭建 Flow，但细节调整（Step Prompt 精确措辞、Edge 条件标签）在 YAML 里改更高效
- 批量重构：比如"把所有 FAQ 话题的欢迎语里加一句免责声明"，用脚本批量改 YAML 比在 Studio 里一个个点快得多
- Git 驱动的协作：开发团队用 PR + Code Review 的方式改智能体配置
不适合的场景
ADK 不替代 Studio——以下情况仍然应该在 Studio 里操作：
- 第一次创建项目和基本配置
- 快速添加单个 FAQ 话题（在 Studio 里填比写 YAML 快）
- Sandbox 里的快速测试
- 非技术成员（产品 / 运营 / 客服）的日常维护
ADK 和 Studio 的组合才是完整的团队协作方案。