Langchain-Chatchat项目中Ollama模型接入配置指南

背景介绍

Langchain-Chatchat作为一款基于大语言模型的对话系统，在0.3.0版本后对模型加载方式进行了重大调整。新版本要求所有LLM和embedding模型必须通过模型部署框架进行加载，这为系统集成带来了新的配置挑战。

核心问题分析

在项目升级过程中，用户常遇到embedding模型无法加载的问题。这主要是因为：

1. 新版本改变了模型加载机制
2. 中文embedding模型资源相对稀缺
3. 配置方式与旧版本有显著差异

Ollama模型接入解决方案

准备工作

首先需要拉取必要的模型文件：

1. 基础语言模型：ollama pull qwen2:72b
2. 中文embedding模型：ollama pull quentinz/bge-large-zh-v1.5:latest

详细配置步骤

通过以下命令完成系统配置：

chatchat-config model --set_model_platforms "[{
    \"platform_name\": \"ollama\",
    \"platform_type\": \"ollama\",
    \"api_base_url\": \"http://127.0.0.1:11434/v1\",
    \"api_key\": \"sk-key\",
    \"api_concurrencies\": 5,
    \"llm_models\": [
        \"qwen2:72b\"
    ],
    \"embed_models\": [
        \"quentinz/bge-large-zh-v1.5:latest\"
    ],
    \"image_models\": [],
    \"reranking_models\": [],
    \"speech2text_models\": [],
    \"tts_models\": []
}]"

chatchat-config model --default_llm_model qwen2:72b

chatchat-config model --default_embedding_model quentinz/bge-large-zh-v1.5:latest

配置说明

1. 平台设置：明确指定使用Ollama作为模型平台
2. API配置：设置本地Ollama服务的访问地址和端口
3. 模型分配：分别配置LLM和embedding模型
4. 默认模型：设置系统默认使用的语言模型和embedding模型

注意事项

1. 中文embedding模型在Ollama上可选范围有限，quentinz/bge-large-zh-v1.5是目前较好的选择
2. 确保Ollama服务已正确启动并监听指定端口
3. 0.3.1版本后配置方式进一步优化，建议升级到最新版本

最佳实践建议

对于生产环境部署，建议：

1. 定期检查Ollama上的模型更新
2. 考虑搭建私有模型仓库确保稳定性
3. 对不同业务场景进行embedding效果测试
4. 监控模型加载和使用情况

通过以上配置，用户可以顺利完成Langchain-Chatchat与Ollama的集成，充分利用本地部署的大语言模型能力。