配置参考

本地配置

muotai-ai-biz/src/main/resources/application.yml 定义服务端口、Nacos 地址、multipart 限制、Hikari 连接池和会话持久化开关；环境配置通常通过 Nacos 的 application-{profile}.yml 与 ${spring.application.name}-{profile}.yml 覆盖。

server:
  port: 6062
spring:
  cloud:
    nacos:
      discovery:
        server-addr: ${NACOS_HOST:wds-register}:${NACOS_PORT:8848}
  servlet:
    multipart:
      max-file-size: 16MB
      max-request-size: 32MB
agent:
  session:
    persistence:
      enabled: ${AGENT_SESSION_PERSISTENCE_ENABLED:true}

配置分组

配置前缀	作用
agent.session.persistence	会话事件账本、检查点和恢复
ai.feign-tool.auto-registration	Feign 工具启动扫描
ai.mcp.nacos-discovery	Nacos MCP 服务发现、同步和健康检查
mcp.tool	@Tool 扫描包和调试日志
spring.servlet.multipart	文件上传和分片请求大小
fs.* / sandbox.*	Agent 文件系统、沙箱和使用量同步
spring.datasource.hikari	数据库连接池

密钥管理

Nacos、LLM、外部 IM、MCP API Key 和对象存储凭据都应通过密钥管理或环境变量注入。日志中不得打印完整 token；数据库初始化脚本里的占位 Key 在投产前必须替换或删除。

配置变更验证

变更配置后至少验证：服务注册、数据库连接、文件上传、模型连接、MCP 工具同步、SSE 心跳和会话恢复。配置键名以 @ConfigurationProperties 类为准，不能仅依据历史 Markdown 中的示例。

配置加载优先级

AI 模块先读取打包的 application.yml，再通过 spring.config.import 导入 application-<profile>.yml 和 <spring.application.name>-<profile>.yml。Nacos 公共配置应放连接池、数据库、Redis、对象存储和公共安全策略，服务专属配置再放 Agent 持久化、Sandbox、MCP、Web Search 和渠道参数。相同键的覆盖结果必须在启动日志和配置审计中可追溯。

关键运行时配置

配置	影响	发布验证
agent.session.persistence.*	JSONL、checkpoint、恢复和保留数	容器重启后恢复一个 session
agent.sandbox.* / fs.*	workspace Provider、挂载和文件权限	读写、撤权和回收
ai.mcp.nacos-discovery.*	MCP 发现、同步和健康检查	tools/list、实例下线补偿
ai.feign-tool.auto-registration.*	Feign 工具扫描和 ai_tool 写入	Schema、重复注册和禁用
spring.servlet.multipart.*	普通/分片上传上限	16MB 文件和 8MB 分片

密钥通过 Secret、环境变量或加密配置注入；发布前检查 Nacos 导出的配置、启动日志和错误日志都不包含 API Key、Bearer Token 或完整 prompt。