配置包
配置包功能可以把部署配置导出为可移植的 ZIP 文件，也可以从 ZIP 导入。它适合在环境之间迁移（预发 → 生产）、在多个客户之间复刻配置，或构建可复用的部署模板。
自 v1.0.0-rc3 起可用（WTO-1116）。
包里包含什么？
在导出向导中勾选各类别后，配置包会包含：- 收件箱 —— 已连接的渠道（仅配置，不含敏感凭据）。
- AI 智能体 —— 提示词、工具、模型设置。
- 自动化规则 ——
trigger → action规则。 - 快捷回复。
- 消息模板 —— 含已声明的变量。
- 自定义角色 —— 带权限的自定义角色。
不包含： 凭据（令牌、密码、API 密钥）、对话数据、联系人、历史记录。配置包承载的是配置，不是运营数据。
打开入口
Settings → Templates / Bundles（拥有 template_bundles.read 或 template_bundles.manage 权限时才会出现该入口）。
导出配置包
- 点击 导出配置包。
- 在向导中勾选要包含的类别。每个类别会列出可用条目，你可以导出全部，也可以只导出指定条目。
- 确认。系统会生成 ZIP 文件，内部为包结构。
- 下载该文件。
bundle-{installation}-{date}.zip，下载后可自行重命名。
预期表现
- 小的配置包（只含模板和快捷回复）生成很快。
- 大的配置包（全部智能体 + 自动化规则）可能需要几秒。
- 没有硬性体积上限，但建议保持配置包聚焦（只需要迁移一个智能体时，不要导出全部）。
导入配置包
- 点击 导入配置包。
- 选择 ZIP 文件。
- 系统会校验内容，并展示将要导入的内容预览。
- 逐条决定导入、覆盖或忽略。
- 确认。
冲突处理
当包内某个条目在目标部署中已存在（同名或同标识）时：- 作为新条目导入： 创建时加后缀以避免冲突（例如
Welcome (imported)）。 - 覆盖： 替换已有条目。在生产环境请谨慎使用。
- 忽略： 跳过该条目，其余内容继续导入。
确认导入后没有自动回滚。在生产环境导入前请先备份数据库。
使用场景
1. 预发 → 生产
在预发环境调好智能体和自动化，与团队验证后导出配置包。在生产环境中，只覆盖那些已验证的条目。2. 部署模板
维护一个“默认模板”配置包，包含每个新部署都应有的自动化和快捷回复。新建实例时直接导入即可。3. 跨客户迁移（多租户）
提供实施服务的公司可以按行业维护配置包目录（零售、医疗、教育），在启动新客户时导入对应包。权限
默认只有
account_owner 拥有 manage。授予其他角色时请谨慎——manage 允许覆盖关键配置。
已知限制
- 凭据不会随包迁移。 导入 WhatsApp 收件箱后，需要手动重新连接该渠道（实例令牌不在包内）。
- 交叉引用。 如果智能体引用了目标环境中不存在的 Knowledge Nexus 空间，智能体仍会导入，但引用会失效（界面显示“空间未找到”）。请在导入前先在目标环境配置好空间。
- Schema 版本。 在不同 WTOCRM 版本之间导出的配置包可能需要适配。请尽量让预发与生产的版本接近。