外部服务依赖
本系统需要以下外部服务支持。请在部署前确保已准备好相关资源。
1. MongoDB 数据库
用于存储系统元数据(如用户信息、配置、Schema 定义等),资源消耗较小。
版本要求
- MongoDB 4.4 以上,建议 6.x 或 7.x
配置建议
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 4 核 | 8 核 |
| 内存 | 4 GB | 8 GB |
| 硬盘 | 10 GB | 20 GB |
注:MongoDB 仅存储元数据,不存储业务数据,因此资源需求较低。上述配置适用于大多数场景。
部署方式
- 可通过 Docker 安装(推荐)
- 也可使用云服务商提供的 MongoDB 服务(如阿里云 MongoDB、腾讯云 MongoDB 等)
- 如没有 MongoDB 资源,我方也能提供
2. AI 大模型资源
系统需要大语言模型 API 来实现智能问答功能。
2.1 对话大模型 API(必需)
| 要求项 | 说明 |
|---|---|
| 接口规范 | 兼容 OpenAI /chat/completions 接口格式 |
| 模型类型 | 非推理类模型,需支持 工具调用 (Function Calling / Tool Use) |
| 参数量 | 建议不小于 72B,参数量越大效果越好 |
| 返回格式 | 需与 OpenAI 返回风格一致 |
推荐服务商
| 服务商 | 推荐模型 | API 地址 |
|---|---|---|
| DeepSeek | deepseek-chat (V3/V3.2) | https://platform.deepseek.com/ |
| 阿里通义千问 | qwen-max / qwen3-max | https://dashscope.aliyuncs.com/ |
| 智谱 AI | GLM-4-Plus | https://open.bigmodel.cn/ |
| 其他 | 任何兼容 OpenAI 接口的服务 | - |
注意事项
- 必须是支持工具调用的对话模型
- 不推荐使用带思考模式的模型(如 DeepSeek-R1 等推理模型)
- 如果是独立部署的开源模型,需保证通信格式和参数与官方 API 一致
- 推荐使用最新版本的模型
2.2 推理大模型 API(可选)
如需更强的复杂问题分析能力,可额外配置一个推理大模型:
| 服务商 | 推荐模型 | 说明 |
|---|---|---|
| DeepSeek | DeepSeek-R1 | 深度推理能力强 |
| 阿里通义千问 | qwen3-235b-a22b(开启思考) | 需开启思考模式 |
| OpenAI | o1 / o3 系列 | 需要 OpenAI API 访问权限 |
注:推理模型通常响应较慢、成本较高,适用于需要深度分析的场景。
2.3 向量化模型 API(Nora 功能必需)
如果启用 Nora 智能问答功能,还需要向量化模型:
| 要求项 | 说明 |
|---|---|
| 接口规范 | 兼容 OpenAI /embeddings 接口格式 |
| 用途 | 文本向量化,用于知识库检索 |
推荐服务商
| 服务商 | 推荐模型 | API 地址 |
|---|---|---|
| 智谱 AI | embedding-3 | https://open.bigmodel.cn/ |
| OpenAI | text-embedding-3-small | https://platform.openai.com/ |
| 本地部署 | BGE-M3(通过 Ollama) | - |
3. 语音转文字 API(可选)
如需使用语音输入功能,需配置语音转文字服务。目前支持以下服务商:
| 服务商 | 推荐指数 | 说明 |
|---|---|---|
| 火山引擎(字节) | ⭐⭐⭐ 推荐 | 基于大模型,识别准确率更高 |
| 阿里云智能语音 | ⭐⭐ | 默认选项,稳定可靠 |
| 科大讯飞 | ⭐⭐ | 老牌语音服务商 |
前置要求
- 系统需配置 HTTPS 域名(语音服务要求)
- 服务器需能访问对应语音服务 API
各服务商配置
火山引擎(推荐)
- 访问 火山引擎控制台
- 开通豆包语音服务
- 创建应用,获取
appKey和accessKey
详细配置见:配置语音转文字服务
阿里云智能语音
- 在阿里云智能语音交互中新建项目,获取
appkey - 开启阿里云 API 服务,获取
accessKeyId和accessKeySecret
科大讯飞
联系技术支持获取配置信息。
服务清单汇总
| 服务类型 | 必需性 | 用途 |
|---|---|---|
| MongoDB | 必需 | 元数据存储 |
| 对话大模型 API | 必需 | 智能问答核心能力 |
| 向量化模型 API | Nora 必需 | 知识库检索 |
| 推理大模型 API | 可选 | 复杂问题深度分析 |
| 语音转文字 API | 可选 | 语音输入功能 |