AgentConfigurationEnvironment

内置环境变量

city / agent 运行时会注入哪些与当前 Agent 上下文相关的环境变量

内置环境变量

CLI 在运行 agent 相关命令时,会推导当前 agent 上下文,并注入一些环境变量。

最常见的是:

  • DC_CITY_HOST
  • DC_CITY_PORT
  • DC_AGENT_ID
  • DC_AGENT_PATH
  • DC_SESSION_ID

DC_CITY_HOST / DC_CITY_PORT

当前 Town runtime 的回连地址。

它主要用于 agent shell 或 tool 再次拉起 town 子命令时,让子进程知道应该回连当前哪个 runtime。

DC_AGENT_ID

当前 agent runtime id。

当前 Town runtime 会把传给 new Agent({ id }) 的同一份 id 注入到这里。

DC_AGENT_PATH

当前 agent 项目的绝对路径。

它在脚本、日志和一些调试场景里都很有价值。

DC_SESSION_ID

当前执行 session 的 id。

它主要用于 runtime 工具执行阶段,让子进程仍然能关联到当前 session。

这些变量是命令执行时按当前上下文注入的,不等于它们会永久回写到你当前 shell 里。