Dify 知识库实战:上传文档、检索与引用

更新于

用一份可核对的示例文档跑通 Dify 知识库,逐步验证文本嵌入、检索、重排和带引用的回答。

先创建 QuickRouter 令牌,确认当前令牌可以调用示例模型。需要换模型时,先查找模型 ID和对应接口。

添加对话与嵌入模型;上传文档并试检索;接入聊天应用
本篇操作路径示意。

1. 添加模型与凭证

在 Dify 工作区打开「设置 → 模型供应商」,选 OpenAI-API-compatible。按已有的 Dify 模型配置教程 先验证普通对话,再添加文本嵌入模型。

字段填写内容
LLM / Chatgpt-4o-mini,地址 https://api.quickrouter.ai/v1
Text Embeddingtext-embedding-3-small,地址 https://api.quickrouter.ai(适用于自动补 API 版本的插件版本)
Rerank(可选)BAAI/bge-reranker-v2-m3,地址 https://api.quickrouter.ai(适用于自动补 API 版本的插件版本)

以插件版本实际发出的路径为准。最终请求应分别为 /v1/chat/completions、/v1/embeddings 和 /v1/rerank。Rerank 可以等首次问答成功后再启用。

2. 建库并验证检索

进入「知识库」新建一个测试库,上传 示例文档,选高质量索引并指定前面添加的 Embedding 模型。等索引完成,在「检索测试」输入「蓝鹭仓库当天发货几点截止?」先确认返回的文本里有 16:40。

如已成功配置 Rerank,可以在检索设置中启用后再问一次,检查带正确时间的分段仍能返回。这个小样本只用于验证接入。

3. 连接聊天应用并核对引用

在「工作室」创建 Chatbot 类型的聊天应用。在「编排 → 上下文」添加刚才的知识库,选择对话模型,在「添加功能」中开启「引用和归属」。预览里问同一个问题,检查答案是否为 16:40,并打开引用核对文档名与内容。在QuickRouter 使用日志核对对话和嵌入请求。

再问「退款需要几天?」示例没有退款信息。可在应用提示中要求仅使用检索内容,缺少依据时直接说明。

遇到问题时检查什么

  • 上传后索引失败。单独检查 Embedding 的令牌权限和路径。出现 /v1/v1/embeddings 时,去掉插件已自动添加的版本段。
  • 有回答但缺少引用。先在知识库检索测试中确认命中,再检查应用上下文是否关联该知识库、是否打开引用。
  • 启用重排后找不到结果。确认 Rerank 模型权限和请求路径,暂时关闭重排或降低过高的分数阈值,再对照同一个问题。

相关文档

使用 FastGPT 搭建知识库?查看FastGPT 配置教程。

在线客服