附录 B：配置速查

这里只列“配置影响哪条运行链”，不替代官方 schema。完整字段和注释见上游 config.example.yaml。

配置段	影响	常见重载边界
models	provider、能力、默认模型	新 run 可见；底层 client 可能缓存
sandbox	provider、路径、资源与 host bash	provider 类型通常需重启
tools/tool_groups	配置工具与 Agent 能力组	新 Agent 构建可见
skills	目录、延迟发现、投影路径	缓存可刷新
tool_search	MCP schema 延迟暴露	新 Agent 构建可见
memory	模式、manager、检索与写入	backend 变更通常需重启
summarization	触发器、模型、裁剪预算	新 Agent 构建可见
subagents	类型、模型、工具、并发/总量	新 run 可见
token_budget	每 run token 硬限制	新 run 可见
loop_detection	重复调用检测	新 Agent 构建可见
guardrails	工具执行策略	provider 相关设置需谨慎重载
authorization	RBAC/provider 与默认角色	安全配置应失败关闭
database	run/thread 持久化与 checkpoint mode	需重启；mode 会冻结
checkpointer	LangGraph 状态后端	需重启
run_events	事件持久化	后端类型通常需重启
stream_bridge	memory/Redis SSE bridge	需重启，且须匹配 worker 数
auth	local/OIDC/session	多数需重启
scheduler	定时任务 poller	服务开关通常需重启
channel_connections	IM 连接能力	连接实例需重建

两个配置文件

config.yaml                 主运行时配置
extensions_config.json      MCP servers + Skills 启用状态

后者单独存在是为了让 Gateway 在线管理扩展，而不必重写庞大的主配置。

部署组合建议

场景	Database	Checkpointer	StreamBridge	Sandbox
本地试用	memory/SQLite	SQLite	memory	Local（谨慎 bash）
单机长期	SQLite	SQLite	memory/Redis	容器型 provider
多 worker	Postgres	Postgres	Redis	共享/远程沙箱
K8s	Postgres	Postgres	Redis	Provisioner/K8s

WARNING

多 worker 下不要把 memory store、memory stream bridge 或仅本机可见的 workspace 当作共享组件。服务能启动不代表重连、取消和文件访问能跨 worker 工作。