Downcity
AgentOperationsRunbook

Startup Checklist

The most important project and configuration checks before starting an Agent

Startup Checklist

Before you run city agent start, confirm:

  1. the project has been initialized
  2. downcity.json.execution.modelId is configured
  3. the corresponding model exists in the global model pool
  4. if chat channels are enabled, the relevant channelAccountId really exists
  5. required environment variables are ready

The two easiest things to miss are usually:

  • modelId is written, but that model does not actually exist in the global model pool
  • the variable exists in your interactive shell, but not in the runtime environment used by the agent process

Logs and Debug Files

Which logs and state files to inspect first when an Agent fails

Restart an Agent Safely

Recommended restart order after changing configuration, channels, or model binding

Table of Contents

Startup Checklist