AgentConfigurationEnvironment
环境变量加载
项目 Agent 启动时如何组合宿主 env 与项目 .env
环境变量加载
项目 agent 启动时,只会组合两层用户 env:
- 宿主显式传入的
new Agent({ env }) - 项目根目录
.env
常见场景
- 你希望 city 或其他宿主统一注入共享密钥
- 你希望某个项目用自己的
.env覆盖宿主值
推荐做法
- 共享密钥由宿主显式传给
Agent - 项目私有覆盖写到
.env downcity.json只保留结构化配置,不再写${VAR}
这样做的直接好处是:
- env 来源更直接
- 配置文件更稳定
- 不会再出现“配置里字符串被偷偷替换”的隐式行为
修改后要做什么
通常需要重启 agent:
town agent restart因为 agent 启动时会读取这份 env 快照,单纯改 .env 或宿主注入值不会自动刷新当前运行中的进程。