PolyAI 中文文档 下载 App

三种部署模式:Simple、Branches、Sub-branches

为什么需要多种模式

一个人维护一个智能体时,一个 Branch 就够用了。但如果团队有 5 个人同时改这个智能体——产品改 Flow、运营改话题、开发改 Python 函数——每个人都在同一个 Branch 上改就会冲突。PolyAI 提供三种模式,让你根据团队规模选择合适的协作方式。

Simple 模式(默认,单人维护)

属性说明
分支数量固定一个(叫 Main)
适合单人维护、改动量小的项目
发布方式在唯一的 Branch 上改 → 测试 → Publish
优点简单、零学习成本
缺点多个人同时改会互相覆盖

新建的项目默认都是 Simple 模式,大多数小企业或单人维护的智能体一直用这个模式就够了。

Branches 模式(小团队并行开发)

属性说明
分支数量每个协作者一个独立 Branch
适合3-10 人团队,各自做独立改动
发布方式每个人在自己的 Branch 上改完 → 测试 → Publish
冲突不同人改了同一个地方时会弹窗让你选保留哪个版本
优点互不阻塞,各自推进各自的改动

这是最常用的团队协作模式。典型使用方式:

Main(生产环境对应)
├── Branch: feature-refund(产品改退款 Flow)
├── Branch: fix-billing-topics(运营改账单 FAQ)
├── Branch: add-crm-integration(开发接 CRM)
└── Branch: optimize-voice(优化语音参数)

每个人在自己的 Branch 上改好、测好后各自 Publish——因为发布是合并不是替换,互不覆盖。只有当两个人改了同一个配置项(比如都改了欢迎语)时,才会弹出冲突提示让你手动选。

Sub-branches 模式(多人协作一个大需求)

属性说明
分支数量一个主 Branch 下可以有多个 Sub-branch
适合多人协作一个大需求、需要一起发布的场景
发布方式Sub-branch 先合并回主 Branch → 主 Branch Publish 到 Live
优点团队可以把大需求拆成小块并行做、最后一起发布

一个例子:团队要做一个"升级会员"大功能,涉及 Flow 改造、CRM 集成、知识话题补充、通知短信模板四个部分。在 Sub-branches 模式里:

Main
└── Branch: feature-upgrade(主 Branch)
    ├── Sub-branch: flows(改 Flow)
    ├── Sub-branch: crm(接 CRM)
    ├── Sub-branch: topics(补话题)
    └── Sub-branch: sms(写短信模板)

四个 Sub-branch 各自推进,全部完成后依次合并回主 Branch,再主 Branch Publish 到 Live——一个大需求一次性上线。

模式切换

在 Deployments 面板 → Settings 里切换模式,不会丢失任何已有的工作。切换动作是即时的,切换后立刻按新模式工作。

什么时候从 Simple 切到 Branches什么时候从 Branches 切到 Sub-branches
团队增加到 3+ 人有一个大需求需要多人拆分子任务一起做
发现简单模式下偶尔有人覆盖别人的改动同一个发布窗口里要推多个互相关联的改动

模式选择的简单建议

个人或 1-2 人小团队 → Simple
3-10 人团队并行推进独立改动 → Branches
多人协作一个大版本 → Sub-branches

实际项目里这三种模式可以共存——不同智能体用不同模式,甚至同一个智能体在不同时期切不同模式。