这个决定什么时候必须做
当企业存在多环境部署需求，需将应用从开发环境同步至测试、预发布或生产环境，或跨团队共享应用配置时，该决定成为必须执行的事项。若执行过早，会增加未稳定应用的迁移成本，导致重复调整配置；若执行过晚，会导致生产环境与开发环境配置不一致，引发上线故障，甚至影响业务运行。当应用包含知识库配置、工作流节点、Agent Sandbox实例或SSO集成等依赖特定环境的功能时，需提前规划迁移步骤，避免遗漏关键配置。当团队需要统一多环境的应用标准，确保不同环境的功能一致性时，也必须完成该决定，否则会出现测试环境验证通过但生产环境无法运行的情况。此外，当应用完成版本迭代，需将新版本部署至全环境时，迁移决定需及时执行，以确保所有环境同步更新功能。
判据矩阵
| 候选迁移方案 | 迁移覆盖资源范围 | 配置保留完整性 | 依赖同步能力 | 数据迁移范围 | 操作复杂度 | 环境兼容性 | 回滚可行性 |
|---|---|---|---|---|---|---|---|
| 配置导出迁移 | 仅应用核心配置（Prompt、开场白、知识库关联、工作流基础配置） | 保留自定义metadata、分块参数、知识库关联配置，不包含Agent Sandbox启动脚本、技能绑定 | 需手动配置关联模型、外部服务地址 | 不包含知识库分块、会话历史、文件存储数据 | 低，通过内置导出功能完成 | 需手动适配目标环境环境变量 | 保留导出文件，可快速导入回原环境 |
| 模板化迁移 | 应用模板定义（工作流结构、知识库关联规则、Prompt模板） | 保留模板化配置项，支持导入时自定义参数，不包含实时会话数据 | 需在导入时配置目标环境依赖，支持模板变量替换 | 不包含知识库分块、会话历史，需手动导入知识库文件 | 中等，需创建模板并配置变量 | 模板变量可适配不同环境，需支持模板导入功能 | 保留模板文件，可重新导入原环境 |
| 完整实例复制迁移 | 应用全部配置、知识库分块、会话历史（可选）、Agent Sandbox配置、技能绑定 | 完整保留所有配置，包括metadata、启动脚本、技能绑定、SSO配置 | 自动同步部分依赖，需手动更新目标环境独有变量 | 包含全部存储数据，需额外处理对象存储文件 | 高，需执行迁移API脚本，处理跨环境文件同步 | 需目标环境版本与原环境一致，需执行版本迁移步骤 | 需保留原实例完整备份，回滚耗时较长 |
每个判据为什么重要
迁移覆盖资源范围是核心判据，直接决定迁移后应用的功能完整性。当应用需要保留会话历史或知识库分块数据时，需选择覆盖全量数据的迁移方案；若仅需同步配置变更，轻量的配置导出迁移即可满足需求。若企业有合规要求，需留存全部操作记录，那么覆盖会话历史的迁移方案是必要的。配置保留完整性决定了迁移后应用的功能是否与原环境一致。当应用包含自定义metadata、分块参数或特定的Prompt配置时，需确保迁移方案能完整保留这些配置，否则会导致应用功能异常。依赖同步能力影响迁移后的环境适配效率，若目标环境与原环境存在差异，需选择支持自动同步或变量替换的方案，减少手动配置的工作量。数据迁移范围决定了迁移后的数据完整性，对于包含大量知识库或用户会话数据的应用，需确保迁移方案能覆盖核心数据，避免数据丢失。操作复杂度影响迁移的实施成本，对于小型团队或资源有限的场景，低复杂度的配置导出迁移更合适；对于大型应用或复杂环境，需选择操作复杂度可控的方案。环境兼容性决定了迁移是否能顺利完成，若目标环境与原环境版本不一致，需选择支持版本迁移的方案，避免出现配置不兼容的问题。回滚可行性影响故障恢复的效率，当迁移出现问题时，可快速回滚到原环境的方案能减少业务中断的时间。
换的代价
已选定的迁移方案切换至其他方案时，需承担额外的成本。从配置导出迁移切换至完整实例复制迁移时，需重新迁移知识库分块、会话历史及Agent Sandbox配置，需执行专用的迁移API脚本，可能需要停机窗口以确保数据一致性，验证工作量包括检查所有配置项、同步对象存储文件，耗时较长。从模板化迁移切换至配置导出迁移时，需重新配置所有模板变量，丢失此前预设的参数配置，需手动调整每个应用的基础设置，可能导致配置不一致。从完整实例复制迁移切换至配置导出迁移时，需删除不必要的会话历史和文件存储数据，需执行数据清理脚本，存在数据误删的风险，需提前完成完整备份。此外，切换迁移方案可能涉及版本兼容性问题，例如需执行工具JSON Schema迁移步骤，若未按官方文档的版本顺序执行，可能导致配置损坏，需额外的排查与修复时间。
什么情况下这个决定可以先不做
当应用仅在单一环境运行，无跨环境部署或共享需求时，可暂不执行该决定。当应用处于快速迭代的测试阶段，配置频繁变更，频繁迁移会增加工作量，可待应用功能稳定后再统一执行迁移。当目标环境与原环境完全一致，且应用配置不会发生变更时，可暂时复用原环境的配置，无需额外迁移。当团队暂无足够的人力或资源执行迁移操作时，可先暂缓该决定，待资源到位后再规划迁移步骤。若应用未启用过Agent Sandbox，且无关联技能或SSO集成，可跳过专用的迁移步骤，暂不执行完整的环境迁移流程。
继续阅读
参考资料
需要进一步确认时
上述判据可依据公开文档与部署实测逐项核对。若需要结合具体业务规模、数据边界与运维条件确定选型，可通过商务咨询获取评估支持；云服务形态可直接开始使用，先验证业务可行性再决定部署形态。
- 商务咨询：结合业务条件做选型评估
- 立即开始：先用云服务验证可行性
- 定价：对比不同形态的适用范围
判据取自开源仓库文档与社区线程，核验日 2026-09-28。