创建第一个 Agent

前置条件

开始前，你至少需要：

• 已安装 town
• 已有一个项目目录
• 已连接的 City AIService 里至少有一个可用模型

如果你还没有准备好 City 模型目录，建议先在 city 里完成模型配置，再回到这里创建项目。

初始化命令

在项目根目录运行：

town agent create .

交互过程中，CLI 会让你选择：

• Agent id
• 主模型 ID
• 需要接入的聊天渠道

这几个选择里，最重要的是主模型 ID，因为它直接决定项目后续是否能正确启动。

创建后会生成什么

最小结构通常包括：

• PROFILE.md
• SOUL.md
• downcity.json
• .downcity/
• downcity.schema.json

根据当前实现，如果目标目录里已经存在 downcity.json，CLI 会在必要时询问你是否允许覆盖。

创建后优先检查这三件事

1. downcity.json.execution.modelId 是否是你想绑定的模型
2. PROFILE.md 是否写清楚 agent 角色
3. 你是否真的需要启用聊天渠道

如果你只是先验证本地执行链路，完全可以先不启用任何聊天渠道，先把最小 CLI 路径跑通。

一个最小可运行配置

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

这个最小配置之所以值得先跑一遍，是因为它依赖最少、排障最简单，也最容易让你明确问题到底出在模型绑定、项目结构还是运行状态。

下一步

创建完成后，继续看：

• 启动和停止 Agent
• 和 Agent 对话

常见误区

1. 以为 create 会自动配好所有外部资源

不会。

它只负责生成项目骨架和最小运行配置。

2. 以为创建时勾选了聊天渠道，就已经能正常收发消息

也不会。

聊天渠道真正能工作，还依赖：

• 全局 channel account 已存在
• 项目绑定了正确的 channelAccountId
• agent 已经重启并处于运行状态