- スプレッドシートのデータ読み書き専用のプラグインを介した直接統合。
- クラウドベースの自動ファイル管理システムにより、文書の検索、作成、ダウンロードが可能になります。
- JSONサービスアカウントまたはOAuth 2.0認証プロトコルによる柔軟な設定。
- Google WorkspaceのドキュメントをXLSXやPDFなどの互換性のある形式に変換できる双方向同期機能。
AIエージェントに実際の最新の情報に基づいて動作させたい場合は、 DifyをGoogleスプレッドシートと連携させる これは、目的を達成する最も簡単な方法の一つです。スプレッドシートは、製品、顧客、タスク、またはアプリケーションで使用されるその他のレコードを照会するための小さなデータリポジトリとして機能します。
この統合により、Difyワークフローは手動でデータをコピーすることなく、異なる範囲を読み取り、新しい値を書き込むことができます。たとえば、注文状況を確認したり、フォームの回答を分類したり、リクエスト処理後にテーブルを更新したりするウィザードを作成できます。
これを行うにはいくつかの方法があります。最も直接的な方法は、 Google スプレッドシートのプラグインと Google Cloud サービスアカウント変更に自動的に対応したり、スケジュールされたタスクを実行したり、スプレッドシートを他のアプリケーションと組み合わせたりする必要がある場合は、n8nのような中間プラットフォームを使用することもできます。
DifyをGoogleスプレッドシートに接続するために必要なもの
始める前に、アドオンが omluc/google_sheets Difyマーケットプレイスで入手可能なこのプラグインは、コミュニティによって開発されたものです。Difyチームが開発した公式プラグインの一部ではありませんが、Difyの拡張機能マーケットプレイスからインストールできます。
このプラグインには現在、主に2つのツールが組み込まれています。
- バッチ取得: スプレッドシート内の1つまたは複数の範囲からデータを取得します。
- 一括更新: 同一操作内で複数の範囲を更新します。
これらの機能はワークフロー内のツールとして追加することも、必要に応じてエージェントが使用できるようにすることもできます。設定するには、以下のものが必要です。
- あ Google Cloudへのアクセス権を持つGoogleアカウント.
- Un Google Cloud 上に作成されたプロジェクト.
- La Google Sheets API 有効。
- サービスアカウント JSON形式のキー.
- あ 共有シート そのアカウントのメールアドレスとともに。
サービスアカウントは独立したIDとして機能します。そのため、Difyはあなたの個人用Googleアカウントを直接使用したり、あなたのスプレッドシートすべてに自動的にアクセスしたりすることはありません。Difyがアクセスできるのは、あなたが明示的に共有したドキュメントのみです。
Google Cloudでサービスアカウントを作成する方法
最初のステップは、Google Cloud Console にアクセスして新しいプロジェクトを作成するか、既存のプロジェクトを選択することです。プロジェクト内で、API とサービス セクションを開き、ライブラリに移動して、次のものを検索します。 Google Sheets API次に、そのオプションをタップして有効にします。
次に、 IAMと管理 > サービスアカウント そして新しいアカウントを作成します。「Dify Google Sheets」のように、用途が分かりやすい名前を付けることができます。
このプロセス中に、Google からプロジェクト内で役割を割り当てるオプションが表示される場合があります。この連携では、プロジェクト全体に一般的な所有者や編集者の役割を割り当てる必要はありません。特定のシートへのアクセスは、後で Google スプレッドシートの共有オプションを通じて制御されます。
アカウントが作成されたら：
- サービスアカウントセクションから詳細情報を開いてください。
- タブに移動 キー.
- クリック キーを追加 > 新しいキーを作成.
- フォーマットを選択 JSON.
- ファイルをダウンロードして保存する 安全な場所に。
JSONファイルには、秘密鍵を含む機密情報が含まれています。このファイルを公開したり、メールで送信したり、リポジトリにアップロードしたりすることは絶対にしないでください。この鍵を入手した者は、サービスアカウントの権限で操作を行う可能性があります。
Difyにプラグインをインストールして設定する方法
Difyでプラグインマーケットプレイスを開き、Google Sheetsアドオンを検索します。 オムルクインストールする前に作者名を確認してください。そうしないと、異なる機能を提供する可能性のある他の拡張機能と混同してしまう可能性があります。
インストール後、プラグインの認証情報設定を開きます。フォームにサービスアカウントキーの入力を求められます。ダウンロードしたJSONファイルをテキストエディタで開きます。 その内容をすべてコピーする そして、対応するフィールドに貼り付けてください。.
メールアドレス、プロジェクトID、秘密鍵だけを個別にコピーしないでください。このアドオンは、Googleスプレッドシートへのリクエストを認証するために、完全なJSON構造を必要とします。
次に、認証情報を保存し、使用したいスプレッドシートを開きます。JSON ファイル内には、というフィールドがあります。 client_emailその値は、以下のような表示になります。
[email protected]クリック 共有 Googleスプレッドシート内で、そのアドレスを別のユーザーのアドレスとして追加します。
- 許可を与える リーダー Difyはデータのみを参照します。
- 許可を与える エディタ セルも更新する必要がある場合。
スプレッドシートをリンク経由で公開することは推奨されません。サービスアカウントを使用すれば、ドキュメントを非公開にし、特定のユーザーのみにアクセスを制限できます。
ワークフローからGoogleスプレッドシートのデータを読み取る方法
シートから情報を取得するには、ツールノードをDifyワークフローに追加し、アクションを選択します。 バッチ取得このアドインを使用すると、複数の範囲を一度の操作でクエリできるため、テーブルの各セクションごとに異なるノードを作成する必要がなくなります。
スプレッドシートの識別子を入力する必要があります。これは、Web アドレスの と の間に表示されます。 /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 は書き込みを拒否します。
モデルが任意の範囲や値を自由に選択できないようにすることも推奨されます。より安全な構成は、 まずデータを検証し、変更可能な列を制限し、制御変数を使用して範囲を構築します。 ワークフローを通じて。
例えば、プロセスを次のように整理することができます。
- El ユーザーが注文番号を入力する.
- バッチ取得が再び列に並びます 対応する。
- 条件付きノード 注文が存在するか確認する.
- モデル 情報を分析または分類する.
- バッチ更新は結果を書き込む 特定の列に。
- 出力ノードは、どのレコードが変更されたかを確認します。
可能な限り、設定時にはテスト用のスプレッドシートを使用してください。不適切な更新を行うと、特に範囲が意図したよりも多くの行や列に及ぶ場合、既存の情報が上書きされてしまう可能性があります。
DifyとGoogleスプレッドシートを接続する際によくある間違い
認証エラーが発生した場合は、JSONファイル全体を貼り付けたこと、およびその形式が変更されていないことを確認してください。秘密鍵には改行が含まれており、ドキュメント構造内で改行を維持する必要があります。
Difyがシートが見つからない、またはアクセスできないと表示した場合は、以下の点を確認してください。
- Google Sheets APIは、正しいプロジェクトで有効になっています。
- シートには正確な値が記載されています
client_email. - シート識別子には、URLの追加部分は含まれていません。
- タブ名は、大文字・小文字、スペース、アクセント記号を含めて一致している必要があります。
- 範囲は、次のような有効な表記法を使用します。
Datos!A2:C20. - ワークフローが書き込みを試みた場合、そのアカウントには編集者権限が付与されます。
Google Cloud でキーを削除または無効化した場合は、新しいキーを作成し、Dify に保存されている認証情報を置き換える必要があります。JSON ファイルが漏洩した疑いがある場合も、新しいキーを生成することをお勧めします。
GoogleスプレッドシートとGoogleドライブのプラグインの違い
Google スプレッドシートと Google ドライブは、単一の統合として扱うべきではありません。Sheets コミュニティ プラグインは、 セル範囲の表示と変更 サービスアカウントを通じて。
対照的に、データソースとして利用可能な公式のGoogleドライブプラグインは OAuth 2.0この機能を使うと、フォルダの閲覧、ファイルの一覧表示、そして処理やDifyナレッジストリームへの組み込みのためにファイルの内容をダウンロードすることができます。
Driveコネクタは読み取り専用です。ファイルの作成、フォルダの整理、ドキュメントの変更や削除は行いません。Google Workspaceからネイティブファイルをダウンロードすると、互換性のある形式に自動的にエクスポートされます。GoogleスプレッドシートはXLSXファイルに変換され、GoogleドキュメントとGoogleスライドはPDFファイルとしてエクスポートされます。
したがって、タスクに応じて統合方法を選択する必要があります。
- プラグインを使用する Googleスプレッドシート セル内の値を読み取ったり書き込んだりする。
- データソースを使用する Googleドライブ ファイルを検索してダウンロードする。
- ワークフローがセルとドキュメント全体の両方を扱う必要がある場合にのみ、両方を組み合わせてください。
n8nを使用して統合を拡張する方法
Google Sheets アドオンは、次のような場合に便利です。 Difyからアクションを実行するただし、これだけではすべての自動化シナリオを網羅できるわけではありません。トリガー、スケジュールされた実行、または複数のアプリケーションへの接続が必要な場合は、 n8nを仲介役として.
このアーキテクチャでは、 Difyはデータをn8nウェブフックに送信できます HTTPリクエストを介して。n8nはリクエストを受け取り、 Google Sheetsノードを実行し、結果をワークフローに返します。.
このプロセスを逆に行うことも可能です。例えば、n8nは新しい行を検出し、その値を処理し、Difyで公開されているアプリケーションのAPIを呼び出すことができます。そして、AIによって生成された結果を同じシートの別の列に書き込むことができます。
このシステムでは、次のような自動化を作成できます。
- シートに追加された回答を自動的に分類します。
- 指定した時間に要約を生成する。
- 記録を更新すると同時に通知を送信する。
- Googleスプレッドシートのデータを、メール、CRM、その他のアプリケーションと連携させます。
- AIが細胞を変更する前に、検証を適用してください。
その代わりに、設定はより複雑になり、両方のサービスで使用されるウェブフック、認証情報、およびAPIキーを保護する必要が生じます。
DifyをGoogleスプレッドシートに接続すると、標準的なスプレッドシートを、エージェントやワークフローにとってアクセスしやすい情報源に変換できます。最も簡単な方法は、Sheets APIを有効にし、サービスアカウントを作成し、プラグインをインストールして、必要なシートのみをメールアドレスで共有することです。
そこから、 バッチ取得では範囲を指定してクエリを実行でき、バッチ更新では結果を書き込みます。プロジェクトで完全なドキュメントを扱ったり、イベントに対応したり、複数のアプリケーションを連携させたりする必要がある場合は、各ツールの機能を混同することなく、Google Driveやn8nをこの設定に追加できます。
私はテクノロジー愛好家であり、その「オタク」の興味を職業に変えています。私は 10 年以上、純粋な好奇心から最先端のテクノロジーを使用し、あらゆる種類のプログラムをいじくり回してきました。現在はコンピューター技術とビデオゲームを専門にしています。これは、私が 5 年以上、テクノロジーやビデオ ゲームに関するさまざまな Web サイトに執筆し、誰にでも理解できる言語で必要な情報を提供することを目的とした記事を作成しているためです。
ご質問がございましたら、私の知識は Windows オペレーティング システムから携帯電話用の Android に関連するあらゆるものまで多岐にわたります。そして、私はあなたに対して、いつでも喜んで数分を費やして、このインターネットの世界であなたが抱いている疑問を解決するお手伝いをしたいと考えています。