Configuration

Model Configuration (Console + Agent)

Responsibility boundary between model pool and project binding

Model Configuration (Console + Agent)

Model setup is split into two responsibilities:

Console manages the model pool (provider/model metadata, keys, endpoints).
Agent project chooses model.primary in ship.json.

Workflow

Configure provider/model in console.
Set model.primary in project.
Restart agent and validate one real invocation.

Commands

city console model list
city console model use default --path .
city console config set model.primary default
city agent restart .

Failure cases

missing model.primary target: agent startup fails.
invalid provider/key: model invocation fails with auth/network errors.

Model Config Reference

Env and ship.db Database Design

Detailed schema, encryption model, and load/write flow for global_env, agent_env, channel_accounts, and runtime config resolution

Configuration Checklist

Production/readiness checks before rollout

Table of Contents

Model Configuration (Console + Agent)Workflow Commands Failure cases Related docs