常见问题

1. 如何查看日志？

docker compose logs -f app docreader postgres

2. 如何启动和停止服务？

# 启动服务
./scripts/start_all.sh

# 停止服务
./scripts/start_all.sh --stop

# 清空数据库
./scripts/start_all.sh --stop && make clean-db

3. 服务启动后无法正常上传文档？

通常是Embedding模型和对话模型没有正确被设置导致。按照以下步骤进行排查

查看.env配置中的模型信息是否配置完整，其中如果使用ollama访问本地模型，需要确保本地ollama服务正常运行，同时在.env中的如下环境变量需要正确设置:

# LLM Model
INIT_LLM_MODEL_NAME=your_llm_model
# Embedding Model
INIT_EMBEDDING_MODEL_NAME=your_embedding_model
# Embedding模型向量维度
INIT_EMBEDDING_MODEL_DIMENSION=your_embedding_model_dimension
# Embedding模型的ID，通常是一个字符串
INIT_EMBEDDING_MODEL_ID=your_embedding_model_id

如果是通过remote api访问模型，则需要额外提供对应的BASE_URL和API_KEY:

# LLM模型的访问地址
INIT_LLM_MODEL_BASE_URL=your_llm_model_base_url
# LLM模型的API密钥，如果需要身份验证，可以设置
INIT_LLM_MODEL_API_KEY=your_llm_model_api_key
# Embedding模型的访问地址
INIT_EMBEDDING_MODEL_BASE_URL=your_embedding_model_base_url
# Embedding模型的API密钥，如果需要身份验证，可以设置
INIT_EMBEDDING_MODEL_API_KEY=your_embedding_model_api_key

当需要重排序功能时，需要额外配置Rerank模型，具体配置如下：

# 使用的Rerank模型名称
INIT_RERANK_MODEL_NAME=your_rerank_model_name
# Rerank模型的访问地址
INIT_RERANK_MODEL_BASE_URL=your_rerank_model_base_url
# Rerank模型的API密钥，如果需要身份验证，可以设置
INIT_RERANK_MODEL_API_KEY=your_rerank_model_api_key

查看主服务日志，是否有ERROR日志输出

4. 如何开启多模态功能？

确保 .env 如下配置被正确设置:

# VLM_MODEL_NAME 使用的多模态模型名称
VLM_MODEL_NAME=your_vlm_model_name

# VLM_MODEL_BASE_URL 使用的多模态模型访问地址
VLM_MODEL_BASE_URL=your_vlm_model_base_url

# VLM_MODEL_API_KEY 使用的多模态模型API密钥
VLM_MODEL_API_KEY=your_vlm_model_api_key

注：多模态大模型当前仅支持remote api访问，固需要提供VLM_MODEL_BASE_URL和VLM_MODEL_API_KEY

解析后的文件需要上传到COS中，确保 .env 中 COS 信息正确设置：

# 腾讯云COS的访问密钥ID
COS_SECRET_ID=your_cos_secret_id

# 腾讯云COS的密钥
COS_SECRET_KEY=your_cos_secret_key

# 腾讯云COS的区域，例如 ap-guangzhou
COS_REGION=your_cos_region

# 腾讯云COS的桶名称
COS_BUCKET_NAME=your_cos_bucket_name

# 腾讯云COS的应用ID
COS_APP_ID=your_cos_app_id

# 腾讯云COS的路径前缀，用于存储文件
COS_PATH_PREFIX=your_cos_path_prefix

重要：务必将COS中文件的权限设置为公有读，否则文档解析模块无法正常解析文件

查看文档解析模块日志，查看OCR和Caption是否正确解析和打印

5. 如何使用数据分析功能？

在使用数据分析功能前，请确保智能体已配置相关工具：

智能推理：需在工具配置中勾选以下两个工具：
- 查看数据元信息
- 数据分析
快速问答智能体：无需手动选择工具，即可直接进行简单的数据查询操作。

注意事项与使用规范

支持的文件格式
- 目前仅支持 CSV (.csv) 和 Excel (.xlsx, .xls) 格式的文件。
- 对于复杂的 Excel 文件，如果读取失败，建议将其转换为标准的 CSV 格式后重新上传。
查询限制
- 仅支持 只读查询，包括 SELECT, SHOW, DESCRIBE, EXPLAIN, PRAGMA 等语句。
- 禁止执行任何修改数据的操作，如 INSERT, UPDATE, DELETE, CREATE, DROP 等。

P.S.

如果以上方式未解决问题，请在issue中描述您的问题，并提供必要的日志信息辅助我们进行问题排查

4.0 KiB Raw Blame History