town agent create

用法

town agent create [path]
town agent create . --force

它会做什么

这个命令会在目标目录初始化一个 agent 项目，并生成最小运行骨架。

典型产物包括：

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

同时，它还会根据当前实现尽量避免无意义地覆盖已有文件，并把下一步操作提示出来。

交互时会问你什么

当前实现里，CLI 会让你选择：

• Agent id
• 主模型 ID
• 要启用哪些聊天渠道

这些问题里真正影响后续执行链路的核心输入有两类：

• 项目身份信息，例如 agent id
• 执行目标信息，例如主模型 ID

这里的主模型 ID 来自已连接的 City AIService。

关键选项

• -f, --force 允许覆盖已有 downcity.json

什么时候用

• 第一次把一个项目变成 agent
• 已有仓库还没初始化 Downcity 配置

如果你只是想“重新生成一遍所有文件”，那不一定适合直接粗暴重复执行；应先确认是否真的需要覆盖现有配置。

初始化后建议马上检查

1. downcity.json.execution.modelId
2. PROFILE.md
3. 渠道配置是否真的需要启用

如果你还不准备接聊天渠道，可以让项目先保持最小配置，避免第一次排障就把模型、渠道、会话三类问题混在一起。

相关文档

• 创建第一个 Agent
• downcity.json 基础

一个常见误区

不要把 create 理解成“安装一切外部依赖”。

它负责的是：

• 初始化项目骨架
• 收集最小配置
• 让这个目录成为可被 Downcity 识别的 agent 项目

它不负责：

• 自动创建 City 模型目录
• 自动录入 channel account
• 自动验证所有第三方平台连接