common_agent/数据库设计/3.模型与路由数据库设计.md

模型与路由数据库设计

1. 表关系

表	说明
model_provider	模型服务商配置
model_config	服务商下具体模型
model_route_rule	任务路由规则
rag_store_model_config	知识库 Embedding 与切片配置
model_call_log	模型调用日志

2. 关键约束

• model_provider.provider_code 全局唯一。
• model_config 使用 (provider_id, model_code) 唯一。
• model_route_rule.route_code 全局唯一。
• rag_store_model_config 使用 (store_id, active) 约束一个知识库只有一个生效配置。
• model_call_log.request_id 全局唯一。

3. 枚举组

catalog	type
model_provider	provider_type
model_provider	protocol_type
model_provider	model_type
model_provider	task_type
model_provider	route_strategy
model_provider	call_status
model_provider	health_status

4. 脚本

• docs/MODEL_PROVIDER_SCHEMA.sql 是完整 schema 快照。
• script/sql/model_provider.sql 是后续执行入口。
• 若模型枚举变更，需要同步 Java 枚举、初始化测试和 SQL 枚举脚本。