downcity.json 基础

downcity.json 是 agent 项目的配置入口。

一个最小示例

{
  "name": "my-agent",
  "version": "1.0.0",
  "execution": {
    "type": "api",
    "modelId": "quality"
  },
  "plugins": {}
}

最常改的字段

• name
• execution.modelId
• plugins.chat.channels.*

如果你只维护这几个字段，已经足够覆盖大多数日常 Agent 项目使用场景。

配置职责

它主要负责这些事：

• 声明项目名称
• 声明项目要用哪个 City AIService 模型
• 配置项目级 plugin
• 绑定渠道账号

从用户角度看，downcity.json 最重要的职责不是“保存一切”，而是“声明这个项目运行时应该如何被装配”。

不应该把什么塞进这里

• 完整的 City AIService 模型定义
• 全局 bot 凭据
• Console 控制面配置

这些不属于单项目 agent 配置。

一旦把这些东西混进来，后续很容易分不清：

• 什么该跟项目走
• 什么该跟全局资源走

继续阅读

• 执行绑定
• Plugin 配置