将 Dify 知识库连接到 QQ、微信、飞书、钉钉机器人上使用

RockChinQ
232 阅读4分钟

LangBot 是一个开源的即时通信机器人开发平台，支持 QQ、微信、飞书、钉钉、Slack等平台，4.6.0 版本引入了外部知识库功能，允许用户将 Dify、RAGFlow 等外部知识检索服务集成到对话流水线中。本教程将详细介绍如何使用 Dify 知识库与 LangBot 结合，实现基于特定领域知识的智能对话。

功能概述

外部知识库功能使 LangBot 能够：

  • 接入多种外部知识检索服务（Dify、RAGFlow 等）
  • 基于特定领域知识提供专业回答
  • 通过插件系统灵活扩展知识检索能力
  • 在 WebUI 中便捷配置，无需手动编辑配置文件

准备工作

在开始之前，您需要：

  1. Python 3.10 或更高版本
  2. Dify 账号（可在 cloud.dify.ai 注册）
  3. 对话模型 API 访问权限

步骤一：部署 LangBot

使用 uvx langbot 命令快速启动 LangBot：

cd /tmp
uvx langbot

启动后，访问 http://127.0.0.1:5300 进行初始化。填写邮箱和密码完成注册，然后登录。成功登录后，您将看到 LangBot 的 WebUI 控制面板。

03-langbot-init.png

步骤二：配置对话模型

在使用知识库之前，需要先配置对话模型。

点击左侧导航栏的"Models"进入模型配置页面，点击"+"按钮打开模型配置对话框。

填写以下信息：

  • Model Name: claude-opus-4-1-20250805
  • Model Provider: New API
  • Request URL: newapi.rockchin.top/v1
  • API Key: 您的 API Key
  • Abilities: 勾选 Vision Ability 和 Function Call

07-langbot-add-model-dialog.png

点击"Submit"保存配置。模型创建成功后，会在列表中显示。

步骤三：在 Dify 创建知识库

访问 cloud.dify.ai 并登录您的账号。点击顶部导航栏的"Knowledge"进入知识库管理页面，点击"Create Knowledge"开始创建知识库。

11-dify-knowledge-page.png

选择"Import from file"，并上传准备好的 LangBot 文档。上传文档后，系统会显示文件信息。

14-dify-file-uploaded.png

点击"Next"进入下一步。在文档处理页面，可以配置分块设置、索引方法和检索设置：

默认配置通常即可满足需求：

  • Chunk Settings: General模式，最大分块长度1024字符
  • Index Method: High Quality（使用嵌入模型）
  • Retrieval Setting: Vector Search（向量搜索）

点击"Save & Process"开始处理文档。处理完成后，知识库即可使用。

16-dify-knowledge-processing.png

步骤四：获取 Dify API 信息

点击右下角的"Service API"按钮。

记录以下信息：

重要提示：这里需要使用的是 Service API Secret Key（格式为 dataset-xxx）。

32-dify-service-api-key-revealed.png

步骤五：安装 Dify 知识检索器插件

在 LangBot WebUI 中，点击左侧导航栏的"Extensions"，然后选择"Plugins"标签。

点击"Market"标签进入插件市场，在搜索框中输入"Knowledge Retriever"进行筛选。

找到"DifyKnowledgeBaseRetriever"插件，点击"Install"按钮进行安装。

26-dify-plugin-marketplace.png

步骤六：配置外部知识库

点击左侧导航栏的"Knowledge"，点击"External"标签页切换到外部知识库。

点击"+"按钮打开添加外部知识库对话框。

填写以下信息：

  • Knowledge Base Name: LangBot Documentation KB
  • Knowledge Base Description: LangBot documentation stored in Dify knowledge base
  • Retriever: 选择"Dify Knowledge Base"

29-dify-retriever-config.png

在"Retriever Configuration"部分填写：

  • API Base URL: api.dify.ai/v1
  • Dify API Key: 从 Dify 获取的 Service API Secret Key
  • Dataset ID: 您的Dataset ID
  • Top K: 5
  • Score Threshold: 0.3
  • Search Method: Hybrid Search

点击"Save"保存配置。

步骤七：测试知识检索

配置完成后，点击外部知识库卡片重新打开编辑对话框，然后点击"Retrieve Test"标签。

输入查询，点击"Query"按钮。系统会从 Dify 知识库检索相关内容。

34-successful-retrieval.png

步骤八：配置流水线

进入"Pipelines"页面，在"AI"标签下，找到"Knowledge Bases"部分，点击"Add Knowledge Base"，勾选您创建的知识库。

步骤九：测试效果

配置完成后，可以通过"Debug Chat"功能测试对话效果。现在即可接入到各个即时通信平台，具体方式可以查看：docs.langbot.app/zh/deploy/p…

技术细节说明

API 密钥类型

Dify 提供两种类型的 API 密钥：

  1. Service API Secret Key：用于访问知识库检索 API，格式为 dataset-xxx
  2. 其他类型的API Key：用于其他用途

检索参数说明

  • Top K: 返回的最相关结果数量，建议设置为 3-10
  • Score Threshold: 相关度阈值（0-1）
  • Search Method: Hybrid Search / Semantic Search / Keyword Search

知识库工作原理

这种方式称为 RAG（Retrieval-Augmented Generation，检索增强生成）。

总结

通过本教程，您学习了如何配置 LangBot 外部知识库功能，结合 Dify 平台实现 RAG 功能。

相关资源

avatar
文章
阅读
粉丝