feat(plugins): consolidate official plugins with independent releases (LANG-180) (#2797)

Co-authored-by: multica-agent <[email protected]>
This commit is contained in:
RockChinQ
2026-10-28 17:32:24 +08:00
committed by GitHub
co-authored by multica-agent
parent d099033d79
commit 3a77306c3c
1144 changed files with 142049 additions and 130 deletions
@@ -0,0 +1,58 @@
# DifyDatasetsConnector
Recupere conocimientos o almacene archivos en las bases de conocimientos de Dify utilizando la API de Dify.
## Configuración
Agregue una base de conocimientos externa en LangBot y seleccione "DifyDatasetsConnector" como tipo de recuperador de conocimientos.
### Configuración de creación (establecida al crear una base de conocimientos)
-**api_base_url**: URL base para la API de Dify
- Para Dify Cloud:`https://api.dify.ai/v1`(predeterminado)
- Para instancias autohospedadas: la URL de su servidor (por ejemplo,`http://localhost/api`o`https://your-domain.com/api`)
-**dify_apikey**: Su clave API de Dify de su instancia de Dify
-**dataset_id**: el ID de su base de conocimientos/conjunto de datos de Dify
### Configuración de recuperación (ajustable por consulta)
-**search_method**(predeterminado: semantic_search): el método de búsqueda a utilizar
-`keyword_search`: búsqueda basada en palabras clave
-`semantic_search`: búsqueda de similitud semántica (predeterminado)
-`full_text_search`: búsqueda de texto completo
-`hybrid_search`: búsqueda híbrida que combina semántica y texto completo
-**top_k**(predeterminado: 5): número máximo de resultados recuperados
-**score_threshold_enabled**(predeterminado: falso): si se habilita el filtrado de umbral de puntuación
-**score_threshold**(predeterminado: 0,5): puntuación de relevancia mínima (0-1), solo se muestra cuando el umbral de puntuación está habilitado
-**reranking_enable**(predeterminado: falso): habilita la reclasificación para mejorar la calidad de los resultados. El modelo de reclasificación se obtiene automáticamente de la configuración de su conjunto de datos de Dify; primero configure el modelo de reclasificación en la consola de Dify.
## Cómo obtener valores de configuración
### Obteniendo su clave API de Dify
1. Vaya a https://cloud.dify.ai/
2. Navegue a la página de su base de conocimientos.
3. Haga clic en "ACCESO API" en la barra lateral izquierda
4. Cree o copie su clave API desde la sección "Claves API"
### Obteniendo su ID de conjunto de datos
1. En la lista de la base de conocimientos de Dify, haga clic en su base de conocimientos.
2. El ID del conjunto de datos está en la URL:`https://cloud.dify.ai/datasets/{dataset_id}`
3. O puede encontrarlo en la página de documentación de API de su base de conocimientos.
### Configuración de reclasificación
1. En la consola Dify, vaya a la configuración de su conjunto de datos.
2. Habilite la reclasificación y seleccione un modelo de reclasificación (por ejemplo,`cohere/rerank-v3.5`)
3. Guarde la configuración
4. En LangBot, habilite la opción "Habilitar reclasificación": el complemento utilizará automáticamente el modelo configurado en Dify.
## Referencia de API
Este complemento utiliza la API Dify Dataset:
- Recuperación:`POST /v1/datasets/{dataset_id}/retrieve`
- Información del conjunto de datos:`GET /v1/datasets/{dataset_id}`
- Carga de documentos:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- Eliminación de documentos:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- Documentación: https://docs.dify.ai/
@@ -0,0 +1,58 @@
# DifyDatasetsConnector
Dify APIを使用してDifyナレッジベースから知識を取得またはファイルを保存します。
## 設定
LangBotで外部ナレッジベースを追加し、ナレッジリトリーバータイプとして「DifyDatasetsConnector」を選択してください。
### 作成設定(ナレッジベース作成時に設定)
- **api_base_url**:Dify APIのベースURL
- Dify Cloudの場合:`https://api.dify.ai/v1`(デフォルト)
- セルフホストインスタンスの場合:サーバーのURL(例:`http://localhost/api` または `https://your-domain.com/api`)
- **dify_apikey**:DifyインスタンスのAPIキー
- **dataset_id**:Difyナレッジベース/データセットのID
### 検索設定(クエリごとに調整可能)
- **search_method**(デフォルト:semantic_search):使用する検索方法
- `keyword_search`:キーワードベースの検索
- `semantic_search`:セマンティック類似度検索(デフォルト)
- `full_text_search`:全文検索
- `hybrid_search`:ハイブリッド検索(セマンティック検索と全文検索の組み合わせ)
- **top_k**(デフォルト:5):取得する結果の最大数
- **score_threshold_enabled**(デフォルト:オフ):スコア閾値フィルタリングを有効にするかどうか
- **score_threshold**(デフォルト:0.5):最小関連度スコア(0-1)、スコア閾値が有効な場合のみ表示
- **reranking_enable**(デフォルト:オフ):リランキングを有効にして結果の品質を向上。リランキングモデルはDifyデータセット設定から自動的に取得されます。先にDifyコンソールでリランキングモデルを設定してください
## 設定値の取得方法
### Dify APIキーの取得
1. https://cloud.dify.ai/ にアクセス
2. ナレッジベースページに移動
3. 左サイドバーの「API ACCESS」をクリック
4. 「API Keys」セクションからAPIキーを作成またはコピー
### データセットIDの取得
1. Difyナレッジベース一覧でナレッジベースをクリック
2. データセットIDはURLに含まれています:`https://cloud.dify.ai/datasets/{dataset_id}`
3. またはナレッジベースのAPIドキュメントページで確認できます
### リランキングの設定
1. Difyコンソールでデータセット設定に移動
2. リランキングを有効にし、リランキングモデルを選択(例:`cohere/rerank-v3.5`)
3. 設定を保存
4. LangBotで「リランキングを有効化」トグルをオンにすると、プラグインがDifyで設定されたモデルを自動的に使用します
## APIリファレンス
このプラグインはDify Dataset APIを使用します:
- 検索:`POST /v1/datasets/{dataset_id}/retrieve`
- データセット情報:`GET /v1/datasets/{dataset_id}`
- ドキュメントアップロード:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- ドキュメント削除:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- ドキュメント:https://docs.dify.ai/
@@ -0,0 +1,58 @@
# DifyDatasetsConnector
ดึงความรู้จากหรือจัดเก็บไฟล์ลงในฐานความรู้ของ Dify โดยใช้ Dify API
## การกำหนดค่า
โปรดเพิ่มฐานความรู้ภายนอกใน LangBot และเลือก "DifyDatasetsConnector" เป็นประเภทการดึงความรู้
### การตั้งค่าการสร้าง (ตั้งค่าเมื่อสร้างฐานความรู้)
-**api_base_url**: URL ฐานสำหรับ Dify API
- สำหรับ Dify Cloud:`https://api.dify.ai/v1`(ค่าเริ่มต้น)
- สำหรับอินสแตนซ์ที่โฮสต์เอง: URL เซิร์ฟเวอร์ของคุณ (เช่น`http://localhost/api`หรือ`https://your-domain.com/api`)
-**dify_apikey**: คีย์ Dify API ของคุณจากอินสแตนซ์ Dify ของคุณ
-**dataset_id**: ID ของฐานความรู้/ชุดข้อมูล Dify ของคุณ
### การตั้งค่าการดึงข้อมูล (ปรับได้ตามแบบสอบถาม)
-**search_method**(ค่าเริ่มต้น: semantic_search): วิธีค้นหาที่จะใช้
-`keyword_search`: การค้นหาตามคำหลัก
-`semantic_search`: การค้นหาความคล้ายคลึงทางความหมาย (ค่าเริ่มต้น)
-`full_text_search`: ค้นหาข้อความแบบเต็ม
-`hybrid_search`: การค้นหาแบบไฮบริดที่รวมความหมายและข้อความแบบเต็ม
-**top_k**(ค่าเริ่มต้น: 5): จำนวนผลลัพธ์ที่ดึงได้สูงสุด
-**score_threshold_enabled**(ค่าเริ่มต้น: false): ว่าจะเปิดใช้งานการกรองเกณฑ์คะแนนหรือไม่
-**score_threshold**(ค่าเริ่มต้น: 0.5): คะแนนความเกี่ยวข้องขั้นต่ำ (0-1) จะแสดงเฉพาะเมื่อมีการเปิดใช้งานเกณฑ์คะแนน
-**reranking_enable**(ค่าเริ่มต้น: false): เปิดใช้งานการจัดอันดับใหม่เพื่อปรับปรุงคุณภาพผลลัพธ์ โมเดลการจัดอันดับใหม่จะถูกดึงมาจากการตั้งค่าชุดข้อมูล Dify ของคุณโดยอัตโนมัติ โปรดกำหนดค่าโมเดลการจัดอันดับใหม่ในคอนโซล Dify ก่อน
## วิธีรับค่าการกำหนดค่า
### รับคีย์ Dify API ของคุณ
1. ไปที่ https://cloud.dify.ai/
2. ไปที่หน้าฐานความรู้ของคุณ
3. คลิกที่ "API ACCESS" ในแถบด้านข้างซ้าย
4. สร้างหรือคัดลอกคีย์ API ของคุณจากส่วน "คีย์ API"
### รับรหัสชุดข้อมูลของคุณ
1. ในรายการฐานความรู้ Dify ให้คลิกที่ฐานความรู้ของคุณ
2. รหัสชุดข้อมูลอยู่ใน URL:`https://cloud.dify.ai/datasets/{dataset_id}`
3. หรือคุณสามารถค้นหาได้ในหน้าเอกสารประกอบ API ของฐานความรู้ของคุณ
### การกำหนดค่าการจัดอันดับใหม่
1. ในคอนโซล Dify ให้ไปที่การตั้งค่าชุดข้อมูลของคุณ
2. เปิดใช้งานการจัดอันดับใหม่และเลือกโมเดลการจัดอันดับใหม่ (เช่น`cohere/rerank-v3.5`)
3. บันทึกการตั้งค่า
4. ใน LangBot เปิดใช้งานการสลับ "เปิดใช้งานการจัดอันดับใหม่" — ปลั๊กอินจะใช้โมเดลที่กำหนดค่าใน Dify โดยอัตโนมัติ
## การอ้างอิง API
ปลั๊กอินนี้ใช้ Dify Dataset API:
- การดึงข้อมูล:`POST /v1/datasets/{dataset_id}/retrieve`
- ข้อมูลชุดข้อมูล:`GET /v1/datasets/{dataset_id}`
- การอัปโหลดเอกสาร:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- ลบเอกสาร:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- เอกสารประกอบ: https://docs.dify.ai/
@@ -0,0 +1,58 @@
#DifyDatasetsConnector
Truy xuất kiến ​​thức từ hoặc lưu trữ tệp vào cơ sở kiến ​​thức Dify bằng API Dify.
## Cấu hình
Vui lòng thêm cơ sở kiến ​​thức bên ngoài vào LangBot và chọn "DifyDatasetsConnector" làm loại trình truy xuất kiến ​​thức.
### Cài đặt tạo (được đặt khi tạo cơ sở kiến ​​thức)
-**api_base_url**: URL cơ sở cho API Dify
- Đối với Dify Cloud:`https://api.dify.ai/v1`(mặc định)
- Đối với các phiên bản tự lưu trữ: URL máy chủ của bạn (ví dụ:`http://localhost/api`hoặc`https://your-domain.com/api`)
-**dify_apikey**: Khóa API Dify từ phiên bản Dify của bạn
-**dataset_id**: ID của cơ sở dữ liệu/cơ sở kiến thức Dify của bạn
### Cài đặt truy xuất (có thể điều chỉnh cho mỗi truy vấn)
-**search_method**(mặc định: ngữ nghĩa_search): Phương thức tìm kiếm sẽ sử dụng
-`keyword_search`: Tìm kiếm dựa trên từ khóa
-`semantic_search`: Tìm kiếm tương tự về mặt ngữ nghĩa (mặc định)
-`full_text_search`: Tìm kiếm toàn văn
-`hybrid_search`: Tìm kiếm kết hợp ngữ nghĩa và toàn văn
-**top_k**(mặc định: 5): Số lượng kết quả truy xuất tối đa
-**score_threshold_enabled**(mặc định: false): Có bật tính năng lọc ngưỡng điểm hay không
-**score_threshold**(mặc định: 0,5): Điểm phù hợp tối thiểu (0-1), chỉ hiển thị khi bật ngưỡng điểm
-**reranking_enable**(mặc định: false): Bật tính năng sắp xếp lại để cải thiện chất lượng kết quả. Mô hình sắp xếp lại được tự động tìm nạp từ cài đặt tập dữ liệu Dify của bạn - trước tiên hãy định cấu hình mô hình sắp xếp lại trong bảng điều khiển Dify
## Cách lấy giá trị cấu hình
### Lấy khóa API Dify của bạn
1. Truy cập https://cloud.dify.ai/
2. Điều hướng đến trang cơ sở kiến thức của bạn
3. Nhấp vào "TRUY CẬP API" ở thanh bên trái
4. Tạo hoặc sao chép khóa API của bạn từ phần "Khóa API"
### Lấy ID tập dữ liệu của bạn
1. Trong danh sách cơ sở kiến thức Dify, nhấp vào cơ sở kiến thức của bạn
2. ID tập dữ liệu có trong URL:`https://cloud.dify.ai/datasets/{dataset_id}`
3. Hoặc bạn có thể tìm thấy nó trong trang tài liệu API trong cơ sở kiến thức của bạn
### Cấu hình sắp xếp lại
1. Trong bảng điều khiển Dify, hãy chuyển đến cài đặt tập dữ liệu của bạn
2. Kích hoạt tính năng sắp xếp lại và chọn mô hình sắp xếp lại (ví dụ:`cohere/rerank-v3.5`)
3. Lưu cài đặt
4. Trong LangBot, bật nút chuyển đổi "Bật xếp hạng lại" - plugin sẽ tự động sử dụng mô hình được định cấu hình trong Dify
## Tham chiếu API
Plugin này sử dụng API bộ dữ liệu Dify:
- Truy xuất:`POST /v1/datasets/{dataset_id}/retrieve`
- Thông tin tập dữ liệu:`GET /v1/datasets/{dataset_id}`
- Tải lên tài liệu:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- Xóa tài liệu:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- Tài liệu: https://docs.dify.ai/
@@ -0,0 +1,58 @@
# DifyDatasetsConnector
使用 Dify API 从 Dify 知识库中检索知识或向其中存入文件。
## 配置
请在 LangBot 中添加外部知识库,并选择"DifyDatasetsConnector"作为知识检索器类型。
### 创建设置(创建知识库时配置)
- **api_base_url**:Dify API 的基础 URL
- Dify Cloud:`https://api.dify.ai/v1`(默认)
- 自托管实例:您的服务器 URL(例如 `http://localhost/api` 或 `https://your-domain.com/api`)
- **dify_apikey**:您的 Dify 实例的 API 密钥
- **dataset_id**:您的 Dify 知识库/数据集的 ID
### 检索设置(每次查询可调整)
- **search_method**(默认:semantic_search):使用的搜索方法
- `keyword_search`:基于关键词的搜索
- `semantic_search`:语义相似度搜索(默认)
- `full_text_search`:全文搜索
- `hybrid_search`:混合搜索,结合语义检索和全文检索
- **top_k**(默认:5):返回的最大检索结果数量
- **score_threshold_enabled**(默认:关闭):是否启用分数阈值过滤
- **score_threshold**(默认:0.5):最低相关度分数(0-1),仅在启用分数阈值时显示
- **reranking_enable**(默认:关闭):启用重排序以提升结果质量。重排序模型将自动从 Dify 数据集设置中获取,请先在 Dify 控制台中配置重排序模型
## 如何获取配置值
### 获取您的 Dify API 密钥
1. 访问 https://cloud.dify.ai/
2. 导航到您的知识库页面
3. 点击左侧边栏中的"API ACCESS"
4. 从"API Keys"部分创建或复制您的 API 密钥
### 获取您的数据集 ID
1. 在 Dify 知识库列表中,点击您的知识库
2. 数据集 ID 在 URL 中:`https://cloud.dify.ai/datasets/{dataset_id}`
3. 或者您可以在知识库的 API 文档页面中找到它
### 配置重排序
1. 在 Dify 控制台中,进入数据集设置
2. 启用重排序并选择重排序模型(如 `cohere/rerank-v3.5`)
3. 保存设置
4. 在 LangBot 中开启"启用重排序"开关,插件将自动使用 Dify 中配置的模型
## API 参考
本插件使用 Dify Dataset API:
- 检索:`POST /v1/datasets/{dataset_id}/retrieve`
- 数据集信息:`GET /v1/datasets/{dataset_id}`
- 文档上传:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- 文档删除:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- 文档:https://docs.dify.ai/
@@ -0,0 +1,58 @@
# DifyDatasets連接器
使用 Dify API 從 Dify 知識庫檢索知識或將文件儲存到 Dify 知識庫中。
## 配置
請在 LangBot 中新增外部知識庫,並選擇「DifyDatasetsConnector」作為知識擷取器類型。
### 建立設定(建立知識庫時設定)
-**api_base_url**:Dify API 的基本 URL
- 對於 Dify Cloud:「https://api.dify.ai/v1」(預設)
- 對於自架執行個體:您的伺服器 URL(例如「http://localhost/api」或「https://your-domain.com/api」)
-**dify_apikey**:您的 Dify 實例中的 Dify API 金鑰
-**dataset_id**:您的 Dify 知識庫/資料集的 ID
### 檢索設定(每個查詢均可調整)
-**search_method**(預設值:semantic_search):要使用的搜尋方法
-`keyword_search`:基於關鍵字的搜索
-`semantic_search`:語意相似性搜尋(預設)
-`full_text_search`:全文搜尋
-`hybrid_search`:結合語意和全文的混合搜尋
-**top_k**(預設值:5):檢索結果的最大數量
-**score_threshold_enabled**(預設: false): 是否啟用分數閾值過濾
-**score_threshold**(預設值:0.5):最小相關性分數(0-1),僅在啟用分數閾值時顯示
-**reranking_enable**(預設值:false):啟用重新排名以提高結果品質。重新排名模型會自動從您​​的 Dify 資料集設定中取得 - 請先在 Dify 控制台中設定重新排名模型
## 如何取得設定值
### 取得您的 Dify API 金鑰
1. 造訪https://cloud.dify.ai/
2. 導覽至您的知識庫頁面
3. 點選左側邊欄中的“API 存取”
4. 從「API 金鑰」部分建立或複製您的 API 金鑰
### 取得您的資料集 ID
1. 在 Dify 知識庫清單中,按一下您的知識庫
2. 資料集 ID 在 URL 中:`https://cloud.dify.ai/datasets/{dataset_id}`
3.或者您可以在知識庫的API文檔頁面中找到它
### 配置重新排名
1. 在 Dify 控制台中,前往您的資料集設置
2. 啟用重新排名並選擇重新排名模型(例如“cohere/rerank-v3.5”)
3. 儲存設定
4. 在 LangBot 中,啟用「啟用重新排名」開關 - 外掛程式將自動使用 Dify 中配置的模型
## API 參考
該外掛程式使用 Dify 資料集 API:
- 檢索:`POST /v1/datasets/{dataset_id}/retrieve`
- 資料集資訊:`GET /v1/datasets/{dataset_id}`
- 文件上傳:`POST /v1/datasets/{dataset_id}/document/create-by-file`
- 文件刪除:`DELETE /v1/datasets/{dataset_id}/documents/{document_id}`
- 文件:https://docs.dify.ai/