JeecgBoot项目中AI模块向量模型地址配置问题解析

问题背景

在JeecgBoot项目的3.8.0版本中，AI模块的向量模型配置存在一个需要注意的技术细节。当用户在使用jeecg-boot-starter-chatgpt组件时，可能会遇到向量模型地址配置不当导致知识库构建失败的问题。

问题现象

用户反馈在配置知识库时，向量模型的请求地址被自动添加了"v1"后缀，而实际上用户的向量模型API地址并不需要这个后缀。这导致系统生成的最终请求地址格式不正确，无法正常构建知识库。

技术分析

通过分析代码发现，问题源于AiModelFactory类中的ensureApiUrlEnd方法。该方法设计初衷是为了确保标准API地址格式正确，会自动为baseUrl添加"v1"后缀。然而：

1. 对于标准API，地址通常以"v1"结尾
2. 但对于某些自定义或第三方API服务，地址格式可能不同
3. 特别是向量模型API可能有其特定的路径结构

解决方案

经过技术验证，正确的配置方式应该是：

1. 向量模型地址只需配置基础域名部分，如"https://api.example.top"
2. 不需要自行添加"embeddings"等路径后缀
3. 系统会自动处理后续的路径拼接

最佳实践建议

1. 对于标准服务：保持默认配置即可

2. 对于自定义API服务：

   • 仅配置基础域名
   • 避免在配置中包含任何路径部分
   • 确保API服务与标准接口规范兼容

3. 在最新版本中，该问题已得到优化，建议用户及时更新

总结

JeecgBoot的AI模块在设计时考虑了标准API规范，但在实际应用中需要根据不同的API服务提供商进行适当调整。理解这一配置细节可以帮助开发者更高效地构建知识库系统，避免因地址格式问题导致的功能异常。