迭代智能体配置时，通过分支隔离修改与验证、通过版本保存发布快照，再按审核与部署流程稳定切换上线配置，避免影响正在运行的呼叫。
概述
分支与版本将「正在验证的修改」和「稳定对外运行的配置」分开管理。分支决定哪一套配置处于上线状态，版本决定该分支对外使用哪一个经过发布和审核的配置快照。
呼叫任务创建时，只需选择智能体。系统会在调度每条呼叫明细时，自动路由到该智能体当前上线分支的最新线上版本，不会使用未生效分支、草稿、审核中、审核驳回或历史版本。
一个智能体可以有多个分支，但任一时刻只有一个处于生效中的分支。每个分支可以有多个版本，但默认呼叫只使用生效中分支的最新线上版本。
基本概念
对象 | 说明 |
默认分支 | 智能体创建时的默认入口，不等同于永久上线分支。 |
调试分支 | 从已有配置复制或新建的隔离分支，用于复现问题、试验改动和回归验证。 |
生效中分支 | 当前标记为「生效中」的唯一分支。 |
未生效分支 | 不承接默认呼叫的分支，可以继续编辑、调试和测试。 |
草稿版本 | 当前分支中尚未发布的最新修改，可继续编辑和用于调试或测试。 |
历史版本 | 某次发布形成的完整配置快照，可查看、对比和回溯。 |
最新线上版本 | 生效中分支内最新、可用于呼叫的已发布且审核通过版本。 |
分支管理
分支是隔离修改和验证的容器。一个智能体可以按业务场景、优化方向或问题修复创建多个分支，但呼叫入口始终只有一个。
核心规则
任一时刻，一个智能体只允许一个分支处于生效中状态。
在分支管理中对其他分支执行部署上线后，该分支成为新的上线分支，原上线分支自动切换为未生效。
未生效分支及其草稿不会影响默认呼叫，可以用于独立调试、测试和回归。
切换上线分支会改变后续新调度呼叫的默认路由。切换前建议完成文本测试、通话测试和关联回归。
什么时候新建分支
需要复现线上问题，且不希望影响当前稳定配置。
需要进行较大范围的提示词、对话流、变量或工具改造。
需要并行验证不同业务策略或优化方案。
新建分支时，会将源分支中的配置克隆到新分支。小范围修复可以在当前分支完成；影响范围较大或需要多轮试验时，优先在调试分支中进行。
版本管理与话术审核
版本是同一分支在某次发布时形成的完整配置快照。
发布流程
在当前分支编辑草稿，并完成文本测试、通话测试或回归验证。
点击发布，选择语音服务已审核通过的资质信息（仅首次发布需要选择，审核通过后不可修改）。系统将创建版本快照，并根据版本提示词生成话术示例提交审核。
审核中或审核驳回的版本不会用于呼叫。如被驳回，应根据原因修改草稿后重新发布。
审核通过后，版本成为该分支的最新线上版本。原线上版本仍保留在历史版本中，可用于查看、对比和回溯。
只有该分支本身处于生效中时，它的最新线上版本才会承接默认呼叫。非生效中分支即使已有审核通过版本，也需要先执行分支的部署上线。
发布不等于部署。发布版本用于生成配置快照并触发话术审核，部署上线用于切换唯一的上线分支。
版本的呼叫边界
新建或修改草稿不会立即影响呼叫。
生效中分支发布新的审核通过版本后，后续新调度的呼叫会使用该分支的新最新线上版本。
历史版本用于复盘、对比和回溯，不会被默认呼叫自动选用。
与呼叫任务的关系
呼叫任务不需要手动选择分支和版本。每条明细在进入调度时自动解析当时的上线分支和最新线上版本。
场景 | 路由与版本处理 |
创建任务或导入号码 | 仅关联智能体，不会为全部号码预先固化版本。 |
某条明细被调度呼叫 | 自动取当时上线分支的最新线上版本，并将实际分支和版本写入执行记录。 |
通话已经进行中 | 继续使用启动时确认的配置。之后发布新版本或切换上线分支，不会改变正在进行的通话。 |
任务已暂停，明细仍为待呼叫 | 暂停不会改写待呼叫明细。恢复后，该明细重新进入调度时，再确认当时的上线分支和最新线上版本。 |
推荐迭代流程
从失败用例或问题通话开始，写清问题现象与预期行为。
在当前分支做最小修复。影响较大或需要多轮试验时，新建调试分支。
每次只改动最小范围，例如一个节点条件、一段提示词或一个变量规则。
先运行原失败用例，再运行关联回归集，对比变更前后的配置、通过率和关键通话表现。
通过后发布版本，等待话术审核结果。审核通过后，确认该版本是否位于生效中分支。
需要将调试分支用于呼叫时，对该分支执行部署上线。无效尝试则放弃调试分支，并保留问题记录。
发布或切换上线分支后，先用小样本任务验证，再扩大任务规模。
使用注意
测试重试或 AI 自迭代通常使用当前分支的最新草稿，这是测试行为。真实呼叫使用上线分支的最新线上版本，两者不要混淆。
不要把「默认分支」直接等同于「生效中分支」，以分支管理页的生效状态为准。
版本对比关注的不只是一段提示词，还包括对话流、变量、小记、知识库、工具和通话配置的差异。
复盘线上问题时，先确认该通电话实际使用的分支和版本，再定位配置差异。
后续操作
完成发布和部署后，使用小样本呼叫任务验证真实呼叫效果。详见呼叫任务：创建、执行与分析。