此为预览文档,正式版本尚未发布。
.env 中配置;Kubernetes 将敏感项放入已有 Secret,通过 Chart values 配置入口与存储。
统一服务调用的配置
Session / Turn 在控制面保存调用、事件、命令和 Webhook 状态,使用持久 Store 后可跨进程恢复。以下属于控制面进程配置,与后面的 Managed Dataplane 配置分别生效:
Application 的并发和 token 预算通过 Application API 管理;Session 的超时、单次任务预算和输入输出契约在创建会话时确定。公共 Session Webhook 使用控制面的 HTTPS 目标校验和签名投递,数据面原生 Webhook 的 allowed-hosts 配置不控制这条公共调用路径。
Managed 原生会话 API 配置
这些是 Dataplane 的 Spring 配置项。通过实际加载的 application.yml、启动参数或传入进程的环境配置设置;仅往 Compose 的.env 加一行不会自动传给容器,需要在服务定义中映射并重建 data 容器。
在 Dataplane 实际加载的 YAML 中,例如:
文件与组件地址
发布配置统一挂载/data/workspaces。控制面使用 CONTROL_PLANE_WORKSPACE_ROOT,Java 使用 BUILDER_WORKSPACE_ROOT。产物目录由 CONTROL_PLANE_ARTIFACT_ROOT 指定。
BUILDER_CONTROL_URL、BUILDER_DATA_URL、BUILDER_SCHEDULER_URL 是组件内部可达地址。不要用浏览器里的 localhost 替代它们。
版本与迁移
Dataplane/Scheduler 默认使用 Hibernateupdate,Go 在启动时执行迁移。BUILDER_JPA_DDL_AUTO=validate 只校验已有表,不初始化新数据库;仅在已自行完成 schema 管理时使用。升级前按运维指南备份和演练。
修改后如何确认生效
先区分部署配置和 Agent 配置,按下面的范围验证:
例如修改默认模型凭据后,在安装目录按部署准备的 Compose 流程重新创建服务,检查健康状态,再通过 API 创建新 Managed 会话并提交简单请求。模型请求成功后,再执行CRM 方案交付案例的固定输入检查;如果进一步接入 Memory,再验证资源读取,可以分别定位模型配置和资源绑定问题。
验收记录保留修改项名称、应用版本、重建时间和新 Session ID;不记录密钥原文。修改 bootstrap 配置不会覆盖数据库中已存在的管理员密码,处理方式见账号参考。