如何將 Dify 與 Google Sheets 和 Google Drive 連接

如果你希望你的人工智慧代理使用真實且最新的信息， 將 Dify 與 Google Sheets 連接 這是實現此目的最簡單的方法之一。電子表格可以充當小型資料儲存庫，從中可以查詢產品、客戶、任務或應用程式使用的任何其他記錄。

此整合允許 Dify 工作流程讀取不同範圍的資料並寫入新值，而無需手動複製資料。例如，您可以建立精靈，用於檢查訂單狀態、對表單回應進行分類，或在處理要求後更新表格。

有幾種方法可以做到這一點。最直接的路線是使用… Google Sheets 外掛程式和 Google Cloud 服務帳戶如果您需要自動回應變更、執行排程任務或將電子表格與其他應用程式結合使用，您也可以使用像 n8n 這樣的中間平台。

連接 Dify 和 Google Sheets 需要哪些條件

在開始之前，有必要澄清一下，這個插件 omluc/google_sheets 這款外掛程式可在 Dify 應用程式商店中找到，它是一款社群外掛程式。雖然它並非 Dify 團隊開發的官方插件，但可以透過他們的擴充市場進行安裝。

該外掛目前包含兩個主要工具：

• 大量取得： 從電子表格中的一個或多個區域中檢索資料。
• 批量更新： 在同一操作中更新多個範圍。

這些功能可以作為工具添加到工作流程中，也可以根據需要提供給客服人員使用。要配置這些功能，您需要：

• 一個 擁有存取 Google Cloud 權限的 Google 帳戶.
• Un 專案創建於 Google Cloud 上.
• La Google Sheets API 已啟用。
• 具有以下功能的服務帳戶 JSON 格式的鍵.
• 一個 共享表格 使用那個帳戶的電子郵件地址。

服務帳戶作為一個獨立身分運作。因此，Dify 不會直接使用您的個人 Google 帳戶，也無法自動存取您的所有電子表格。它只能存取您明確與其共用的文件。

如何在 Google Cloud 上建立服務帳號

第一步是前往 Google Cloud 控制台，建立一個新專案或選擇一個現有專案。在專案中，開啟「API 和服務」部分，前往庫，然後搜尋… Google Sheets API然後，點擊該選項啟用它。

接下來，輸入 IAM 和管理 > 服務帳戶 然後建立一個新帳戶。您可以給它一個便於識別其用途的名稱，例如“Dify Google Sheets”。

在此過程中，Google 可能會提供在專案中指派角色的選項。對於此集成，您無需為整個專案指派通用的所有者或編輯角色。對特定工作表的存取權限稍後將透過 Google 試算表的共用選項進行控制。

帳戶建立完成後：

1. 從服務帳戶部分開啟您的詳細資料。
2. 轉到選項卡 鑰匙.
3. 點選 新增密鑰 > 建立新密鑰.
4. 選擇格式 JSON.
5. 下載並儲存文件 在安全的地方。

該 JSON 檔案包含敏感訊息，包括私鑰。您不得發布、透過電子郵件發送或將其上傳到任何儲存庫。任何取得該金鑰的人都可能擁有該服務帳戶的權限。

如何在 Dify 中安裝和設定插件

在 Dify 中，開啟外掛程式市場，搜尋由 [開發者名稱] 發布的 Google Sheets 外掛程式。 omluc安裝前請檢查作者姓名，以免與其他可能提供不同功能的擴充功能混淆。

安裝完成後，開啟插件的憑證設定。表單會要求您輸入服務帳戶金鑰。使用文字編輯器開啟下載的 JSON 檔案。 複製其所有內容 然後將其貼到相應的欄位中。.

請勿單獨複製電子郵件地址、項目 ID 或私鑰。該插件需要完整的 JSON 結構來驗證發送到 Google Sheets 的請求。

接下來，儲存憑證並開啟要使用的電子表格。在 JSON 檔案中，您會找到一個名為「」的欄位。 client_email其值看起來將類似這樣：

[email protected]

點選 分享 在 Google 試算表中，將該地址加入進去，就像添加其他使用者地址一樣：

• 授予權限 讀者 如果Dify只會查閱資料。
• 授予權限 編輯 如果還需要更新儲存格。

不建議透過連結公開分享電子表格。使用服務帳戶可以將文件設為私有，並限制只有特定使用者才能存取。

如何從工作流程讀取 Google Sheets 中的數據

若要從工作表中擷取訊息，請在 Dify 工作流程中新增一個工具節點，然後選擇該操作。 大量取得該外掛程式可讓您在一次操作中查詢多個範圍，從而避免為表的每個部分建立不同的節點。

您需要提供電子表格標識符。此識別碼出現在其網址中，位於「<webname>」和「<webname>」之間。 /d/ y /edit在具有以下結構的 URL 中：

https://docs.google.com/spreadsheets/d/IDENTIFICADOR/edit

您只能使用標記為“ IDENTIFICADOR.

您還需要使用 Google 試算表的格式指定標籤頁名稱和範圍。例如：

Clientes!A2:D50
Productos!A:C
Pedidos!B2:B20

感嘆號前的名稱對應於製表符。其後的字母和數字用於分隔要檢索的列和行。

然後，您可以將結果傳遞給 LLM 節點，以便對其進行匯總、尋找記錄或準備回應。建議指示模型僅使用檢索到的數據，並在找不到匹配項時明確指出，尤其是在工作表包含客戶、庫存或訂單資訊的情況下。

如何從 Dify 更新儲存格

該工具 大量更新 它允許您寫入不同範圍內的值。例如，這可用於變更任務狀態、儲存 AI 產生的分類或新增請求結果。

使用前，請確認服務帳戶擁有文件的編輯權限。如果只有讀取權限，查詢可以正常運作，但 Google 會拒絕寫入嘗試。

此外，建議防止模型自由選擇任何範圍或值。更安全的配置包括： 首先驗證數據，限制可修改的列，並使用受控變數建立範圍。 透過工作流程。

例如，您可以這樣組織流程：

1. El 使用者輸入訂單編號.
2. 批量獲取重新排隊 相應的。
3. 條件節點 檢查訂單是否存在.
4. 該模型 分析或分類資訊.
5. 批次更新寫入結果 在特定列中。
6. 輸出節點確認哪個記錄被修改了。

設定過程中，盡可能使用測試電子表格。配置不當的更新操作可能會覆蓋現有信息，尤其是在更新範圍​​涵蓋超出預期行數或列數的情況下。

將 Dify 與 Google Sheets 連接時常見的錯誤

如果遇到身份驗證錯誤，請確認您已貼上完整的 JSON 文件，且其格式未更改。私鑰包含換行符，這些換行符必須保留在文件結構中。

當 Dify 提示找不到或無法存取工作表時，請檢查以下幾點：

• Google Sheets API 已在正確的專案中啟用。
• 該表格已共享，其中包含確切值 client_email.
• 表格標識符不包含 URL 的任何其他部分。
• 標籤名稱完全匹配，包括大小寫、空格和重音符號。
• 此範圍使用有效的表示法，例如： Datos!A2:C20.
• 如果工作流程嘗試寫入數據，則該帳戶具有編輯權限。

如果您已在 Google Cloud 中刪除或停用金鑰，則需要建立新金鑰並取代 Dify 中儲存的憑證。如果您懷疑 JSON 檔案已洩露，也應該產生一個新金鑰。

Google Sheets 和 Google Drive 外掛程式之間的區別

Google Sheets 和 Google Drive 不應被視為單一整合。 Sheets 社群外掛程式旨在… 查看和修改單元格區域 透過服務帳戶。

相較之下，官方的 Google Drive 外掛程式可用作資料來源。 OAuth 2.0它允許您瀏覽資料夾、列出文件，並下載其內容以進行處理或合併到 Dify 知識流中。

雲端硬碟連接器是唯讀的：它不會建立檔案、整理資料夾，也不會修改或刪除文件。當您從 Google Workspace 下載原生檔案時，它會自動將其匯出為相容格式。 Google 試算表會轉換為 XLSX 文件，而 Google 文件和 Google 投影片則會匯出為 PDF 文件。

因此，您必須根據任務選擇合適的整合方式：

• 使用插件 Google 試算表 讀取或寫入儲存格中的值。
• 使用以下資料來源 Google 雲端硬碟 尋找並下載文件。
• 只有當工作流程需要同時處理儲存格和整個文件時，才應將兩者結合使用。

如何使用n8n擴展集成

Google Sheets 外掛程式對以下方面很有用： 從 Dify 執行操作然而，它本身並不能涵蓋所有自動化場景。如果您需要觸發器、計劃執行或連接到多個應用程序，則可以進行其他設定。 n8n 作為中介.

在這種架構中， Dify可以將資料傳送到n8n webhook。 透過HTTP請求。 n8n接收到請求後， 它執行其 Google Sheets 節點並將結果傳回給工作流程。.

您也可以反向操作。例如，n8n 可以偵測新行，處理其值，並呼叫 Dify 上發布的應用程式的 API。然後，可以將 AI 產生的結果寫入同一工作表的另一個欄位。

該系統可讓您建立以下自動化流程：

• 自動對新增到表格中的答案進行分類。
• 在指定時間產生摘要。
• 同時更新記錄並發送通知。
• 將 Google Sheets 中的資料與電子郵件、CRM 或其他應用程式的資料合併。
• 在允許人工智慧修改單元格之前，必須進行驗證。

作為回報，配置會更加複雜，需要保護兩個服務使用的 webhook、憑證和 API 金鑰。

將 Dify 連接到 Google Sheets，即可將標準電子表格轉換為易於存取的資訊來源，供客服人員或工作流程使用。最直接的方法是啟用 Sheets API，建立服務帳戶，安裝插件，然後僅透過您的電子郵件地址共用必要的表格。

從那裡開始， 批次取得可讓您查詢範圍，批次更新將結果寫入資料。如果專案需要處理完整的文件、對事件做出反應或協調多個應用程序，您可以使用 Google Drive 或 n8n 來補充此設置，而不會混淆每個工具的功能。