AgentOperationsRunbook

启动前检查清单

在启动 Agent 之前，优先确认的项目和配置项

启动前检查清单

在执行 town agent start 之前，建议先确认：

  1. 项目已经初始化
  2. downcity.json.execution.modelId 已配置
  3. Town 已连接 City
  4. City AIService 中存在对应模型
  5. 如果启用了聊天渠道，对应 channelAccountId 确实存在
  6. 需要的环境变量已经准备好

其中最容易被忽略的通常是：

  • modelId 虽然写了，但 City AIService 里并不存在
  • 环境变量虽然在本地 shell 有，但没有真正出现在运行时环境里

日志与调试文件

Agent 出问题时，优先看哪些日志和状态文件

安全重启 Agent

在修改配置、渠道或模型绑定后，推荐的重启顺序

目录

启动前检查清单