繁中

Dify的自建版本連接到Notion知識庫,提供完整的故障排除記錄

從找不到提供商到最終成功,啟用時遇到了經典錯誤 概念知識庫 在自建的Dify環境中:

未找到提供商

這個問題更加常見,尤其是如果您使用Docker Compose自己部署它。本文記錄了我從發現問題、故障排除步驟到最終成功集成到Notion的旅程,希望幫助其他遇到類似問題的人。

1.問題背景

使用Docker Compose部署的Dify,API和Web版本都是最新的:

  • dify-api:1.9.2
  • dify-web:1.9.2

但當嘗試在Dify知識庫中連接Notion時,我不斷收到提示:

未找到提供商

即使Notion配置項已 . inf 設置在中並配置集成令牌,仍然無法正常連接。

2.初步調查:確認服務狀態

我首先查看了當前正在運行的容器:

sudo docker撰寫ps

輸出如下:

docker-plugin_daemon-1 langgenius/dify-plugin-daemon:0.3.3-本地
docker-api-1 langgenius/dify-api:1.9.2
docker-web-1 langgenius/dify-web:1.9.2
...

這裡出現了一個非常關鍵的點:

plugin_daemon的版本為:0.3.3-本地(本地構建)

而且API / Web / WORKER已經是版本 1.9.2 .

版本不匹配是根本問題.

3.深入調查:檢查插件守護程式日誌

我查看了Notion相關日誌:

sudo docker編寫日誌plugin_daemon --tail=200| grep觀念

輸出顯示Notion插件正常加載:

新插件已登錄:langgenius/Concept_:0.1.13
插件langgenius/Concept_:0.1.13已啟動

這證明plugin_daemon正在運行該插件並且沒有掛起。

然而,因為插件守護程式是 0.3.3-local,是的 一個非常舊的版本,Notion Provider是後來添加的新插件。

這導致:

  • API 1.9.x-支持Notion數據源插件
  • plugin-daemon 0.3.3 |不完全支持/不兼容
  • 知識庫掛鈎報告- 未找到提供商

這解釋了為什麼插件「似乎已經啟動」,但知識庫仍然無法導入Notion。

4.關鍵原因:版本系統獨立

這一點非常重要:

組件版本系統
API / Web / WORKER1.x系列
插件守護程式0.x系列(獨立版本)
概念_插件0.x系列

因此:

  • 插件守護程式未使用API升級
  • plugin-daemon:1.9.2此圖像不存在
  • 如果您使用較舊的插件守護程式,您將無法找到提供程式

 Docker編寫拉 出現:

langgenius/dify-plugin-daemon的清單:1.9.2未找到

這進一步證明plugin-daemon根本沒有1.x版本。

5.解決方案:將plugin-daemon升級到最新的0.x官方版本

最關鍵的一步是 docker-compose.yml 將插件守護程式鏡像更改為最新版本。

例如:

plugin_daemon:
 圖片:langgenius/dify-plugin-daemon:0.4.3

或使用最新版本:

plugin_daemon:
 圖片:langgenius/dify-plugin-daemon:最新

之後:

sudo碼頭工人作曲拉
sudo docker整理下來
sudo docker composition up -d

更新後的插件守護程式自動加載最新的收件箱插件,包括:

  • langgenius/概念_
  • langgenius/概念

並且完全兼容API 1.9.x。

6.完成插件配置(否則仍無法導入)

插件升級成功後,還需要前往Dify後台完成配置:

路徑:

Dify 控制台|插件(擴展)|概念數據源|配置

必須填寫:

  • 集成類型:內部
  • 概念內部秘密:secret_xxxxxxxx

保存.

這是插件自己的配置,它沒有任何內容 . inf 用它來做,它也沒有填充在知識庫中。

7.創建新的知識庫(重要)

最後,在知識庫中創建一個新知識庫並選擇:

✔ 概念數據源(插件)。
不要選擇舊的「觀念」(那是歷史的遺產)

填寫頁面ID |測試連接|導入成功。

8.總結:整個問題的核心點

經過全面的調查,我找到了這個問題的最終根本原因:

API/Web升級到1.9.2,但plugin-daemon仍然是舊版本0.3.3-本地。

結果:

  • 概念插件不兼容
  • 未找到提供商
  • 無論如何填寫代幣或頁面ID,都無法正確勾掛

修複方法非常簡單:

將plugin-daemon 升級到最新版本即可

9.最終作業指導書(可以直接粘貼)

1.編輯合成文件:

plugin_daemon:
 圖片:langgenius/dify-plugin-daemon:0.4.3

2.重新啟動:

sudo碼頭工人作曲拉
sudo docker整理下來
sudo docker composition up -d

3.配置插件:

Dify →插件→概念數據源→配置

4.創建新的知識庫(需要Notion數據源的插件版本)

完成:現在您擁有了一個完全可重複的解決方案

這一整套調查過程從以下幾點開始:

  • 初始誤差
  • 貨櫃檢測
  • 版本比較
  • 插件日誌確認
  • 到最終的升級修復

管材:

返回頂端