Langchain-Chatchat API 接口调用问题解析与解决方案

在使用Langchain-Chatchat项目进行API调用时，开发者可能会遇到接口调用错误的问题。本文将对这一问题进行深入分析，并提供正确的调用方法。

问题背景

在Langchain-Chatchat项目的API文档中，存在接口描述不一致的情况。特别是/chat/chat对话接口，其示例请求数据可能缺少必要字段，导致调用失败。后台错误信息不够明确，给开发者调试带来困难。

接口变更说明

最新版本的Langchain-Chatchat已经废弃了/chat/chat接口，转而使用新的接口设计。开发者应当注意以下两点：

1. 旧接口/chat/chat已不再推荐使用
2. 新接口/chat/chat/completions和/knowledge_base/chat/completions成为主要调用方式

正确调用方法

以下是使用Java语言调用新API接口的正确示例：

// 配置基本参数
MediaType JSON = MediaType.get("application/json; charset=utf-8");
String API_URL = "http://your-server-ip:port/chat/chat/completions";
String MODEL = "glm4_9b_chat";

// 构建HTTP客户端
OkHttpClient.Builder builder = new OkHttpClient.Builder();
builder.connectTimeout(10, TimeUnit.SECONDS);
builder.readTimeout(60, TimeUnit.SECONDS);
OkHttpClient client = builder.build();

// 构造请求体
JSONObject req = new JSONObject();
req.put("model", MODEL);
req.put("stream", false);
req.put("temperature", 0.7);

// 设置知识库查询参数
req.put("tool_choice", "search_local_knowledgebase");
JSONObject tool_input = new JSONObject();
tool_input.put("database", "samples"); // 对应本地知识库中的Database名称
tool_input.put("query", input);
req.put("tool_input", tool_input);

// 设置对话消息
JSONArray msgs = new JSONArray();
JSONObject msg = new JSONObject();
msg.put("role", "user");
msg.put("content", input);
msgs.add(msg);
req.put("messages", msgs);

// 发送请求
RequestBody body = RequestBody.create(req.toString(), JSON);
Request request = new Request.Builder().url(API_URL).post(body).build();

关键参数说明

1. model：指定使用的语言模型，如glm4_9b_chat
2. stream：是否启用流式响应
3. temperature：控制生成文本的随机性
4. tool_choice：指定使用的工具，如search_local_knowledgebase
5. database：指定查询的本地知识库名称
6. messages：对话历史记录，包含角色和内容

最佳实践建议

1. 始终使用最新的API文档作为参考
2. 对于超时设置，建议根据实际网络状况调整
3. 在开发阶段，可以先将stream设为false以便调试
4. 对于知识库查询，确保database参数与已创建的知识库名称一致
5. 合理设置temperature值，平衡生成结果的创造性和准确性

通过遵循以上指导，开发者可以避免常见的API调用错误，更高效地集成Langchain-Chatchat的功能到自己的应用中。