Skip to main content
此为预览文档,正式版本尚未发布。
Docker 在 .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 中,例如:
替换为你的通知主机和模型标识。示例价格只用于展示格式,实际价格由部署方维护。未配置价格时费用显示不完整,不能按零费用处理。SSE 消息与工具增量默认持久保存,无需开启 preview。 多副本共享 Data Plane 数据库及支持条件写入的 BaseStore;工作文件的 Filesystem 也可使用分布式后端。日志位置见存储说明。代理应关闭 SSE 缓冲、及时转发并配置足够的读取超时;15 秒心跳只保持连接,不表示模型有输出。

文件与组件地址

发布配置统一挂载 /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 默认使用 Hibernate update,Go 在启动时执行迁移。BUILDER_JPA_DDL_AUTO=validate 只校验已有表,不初始化新数据库;仅在已自行完成 schema 管理时使用。升级前按运维指南备份和演练。

修改后如何确认生效

先区分部署配置和 Agent 配置,按下面的范围验证: 例如修改默认模型凭据后,在安装目录按部署准备的 Compose 流程重新创建服务,检查健康状态,再通过 API 创建新 Managed 会话并提交简单请求。模型请求成功后,再执行CRM 方案交付案例的固定输入检查;如果进一步接入 Memory,再验证资源读取,可以分别定位模型配置和资源绑定问题。 验收记录保留修改项名称、应用版本、重建时间和新 Session ID;不记录密钥原文。修改 bootstrap 配置不会覆盖数据库中已存在的管理员密码,处理方式见账号参考。