此为预览文档，正式版本尚未发布。
.env 中配置；Kubernetes 将敏感项放入已有 Secret，通过 Chart values 配置入口与存储。
文件与组件地址
发布配置统一挂载/data/workspaces。控制面使用 AISTIO_WORKSPACE_ROOT，Java 使用 BUILDER_WORKSPACE_ROOT。产物目录由 AISTIO_ARTIFACT_ROOT 指定。
BUILDER_CONTROL_URL、BUILDER_DATA_URL、BUILDER_SCHEDULER_URL 是组件内部可达地址。不要用浏览器里的 localhost 替代它们。
版本与迁移
Dataplane/Scheduler 默认使用 Hibernateupdate，Go 在启动时执行迁移。BUILDER_JPA_DDL_AUTO=validate 只校验已有表，不初始化新数据库；仅在已自行完成 schema 管理时使用。升级前按运维指南备份和演练。
修改后如何确认生效
先区分部署配置和 Agent 配置，按下面的范围验证：
例如修改默认模型凭据后，在安装目录按本地安装的 Compose 流程重新创建服务，检查健康状态，再新建 Managed Chat 提交一句简单请求。模型请求成功后，再执行售前方案团队的知识读取检查，可以分别定位模型配置和资源绑定问题。
验收记录保留修改项名称、应用版本、重建时间和新 Session ID；不记录密钥原文。修改 bootstrap 配置不会覆盖数据库中已存在的管理员密码，处理方式见账号参考。