必须正确配置JanAI与本地知识库的连接参数：一、启动本地知识库服务并验证健康状态；二、修改配置文件中的knowledge_base地址为本地URL或路径；三、设置文档加载路径与支持格式；四、重启JanAI并手动同步知识库；五、通过查询和开发者工具验证连接与检索功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望JanAI能够访问并利用本地存储的知识文档，必须正确配置其与本地知识库的连接参数。以下是完成该配置的具体步骤：
一、确认本地知识库服务已启动
JanAI需通过HTTP或本地文件协议访问知识库索引服务，因此必须确保后端知识库服务（如ChromaDB、Weaviate或LlamaIndex本地实例）已在本机运行并监听指定端口。未启动服务将导致连接超时或拒绝连接错误。
1、打开终端或命令提示符窗口。
2、执行知识库服务启动命令，例如：docker run -d -p 8000:8000 --name chroma chromadb/chroma。
3、使用curl或浏览器访问http://localhost:8000/health，确认返回JSON格式的健康状态响应。
二、修改JanAI配置文件中的知识库地址
JanAI通过读取config.yaml或settings.json中的knowledge_base字段确定接入点，需将默认远程地址替换为本地服务的实际URL或路径。
1、定位JanAI安装目录下的配置文件，通常为/config/config.yaml或~/.janai/settings.json。
2、用文本编辑器打开该文件，查找包含knowledge_base或vector_db的配置段。
3、将原值如https://api.janai.ai/v1/kb替换为http://localhost:8000（对应ChromaDB）或./data/local_kb（对应本地嵌入式SQLite+文件索引）。
三、配置本地文档加载路径与格式支持
JanAI需明确指定哪些本地目录作为知识源，并启用对应解析器以处理PDF、Markdown、TXT等格式。路径未纳入扫描范围或格式不被识别将导致文档无法入库。
1、在配置文件中找到document_sources字段，将其值设为绝对路径，例如：["/Users/john/docs", "/home/janai/knowledge"]。
2、检查supported_formats列表，确保包含所需扩展名，如["pdf", "md", "txt", "docx"]。
3、若使用PDF解析，确认系统已安装pymupdf或pdfplumber依赖，可通过pip list | grep pdf验证。
四、重启JanAI并触发知识库同步
配置变更仅在服务重启后生效，且首次连接需手动触发向量索引构建流程，否则界面中仍显示空知识库状态。
1、关闭正在运行的JanAI进程，可使用killall janai（macOS/Linux）或任务管理器结束进程（Windows）。
2、重新执行启动命令，例如：janai --config /config/config.yaml。
3、在JanAI Web界面左下角点击“同步知识库”按钮，等待进度条完成且状态变为“就绪”。
五、验证连接与检索功能
最终需通过实际查询验证本地知识库是否被正确加载和响应，避免因嵌入模型不匹配或索引损坏导致静默失败。
1、在JanAI聊天输入框中键入明确基于本地文档内容的问题，例如：“项目A的交付周期是多少？”（假设该句存在于已同步的PDF中）。
2、观察响应末尾是否出现引用标记，如[source: /docs/project_plan.pdf, page: 5]。
3、打开开发者工具（F12），切换至Network标签页，筛选请求URL含/query的条目，确认响应体中"results"字段非空且包含chunk文本与score值。
