common_agent/docs/后端实现文档/3.模型与路由模块后端实现.md

模型与路由模块后端实现

1. 当前实现落点

当前实现位于 com.bruce.modelprovider，包含服务商、模型、路由、网关、客户端和调用日志。

2. Controller

• ModelProviderController
• ModelConfigController
• ModelRouteRuleController
• RagStoreModelConfigController
• ModelCallLogController

3. Service

Service	职责
IModelProviderService	服务商 CRUD 和健康检查
IModelConfigService	模型配置 CRUD
IModelRouteRuleService	路由规则 CRUD
IModelRouteService	根据任务上下文选择模型
IRagStoreModelConfigService	知识库模型绑定
IModelCallLogService	调用日志写入与查询

4. 网关

业务模块只能依赖：

• ChatModelGateway
• EmbeddingModelGateway

不得直接依赖具体上游客户端。

5. 校验规则

• 服务商编码唯一。
• 同一服务商下模型编码唯一。
• 路由主模型必须启用。
• 路由任务类型必须来自枚举。
• 知识库 Embedding 维度必须与模型配置一致。