Как связать Dify с Google Sheets и Google Drive

Если вы хотите, чтобы ваши агенты ИИ работали с реальной и актуальной информацией, Подключите Dify к Google Sheets Это один из самых простых способов добиться этого. Электронная таблица может служить небольшим хранилищем данных, из которого можно запрашивать информацию о товарах, клиентах, задачах или любых других записях, используемых вашим приложением.

Эта интеграция позволяет рабочему процессу Dify считывать различные диапазоны данных и записывать новые значения без необходимости ручного копирования данных. Например, вы можете создать мастер, который проверяет статус заказа, классифицирует ответы на форму или обновляет таблицу после обработки запроса.

Существует несколько способов сделать это. Самый прямой путь использует... Плагин Google Sheets и учетная запись сервиса Google Cloud.Если вам необходимо автоматически реагировать на изменения, запускать запланированные задачи или интегрировать электронную таблицу с другими приложениями, вы также можете использовать промежуточную платформу, такую ​​как n8n.

Что вам понадобится для подключения Dify к Google Sheets

Прежде чем начать, стоит уточнить, что дополнение omluc/google_sheets Этот плагин, доступный на Dify Marketplace, является плагином от сообщества. Он не входит в число официальных плагинов, разработанных командой Dify, хотя его можно установить из их магазина расширений.

В настоящее время этот плагин включает в себя два основных инструмента:

• Пакетное получение: Извлекает данные из одного или нескольких диапазонов в электронной таблице.
• Обновление пакета: Обновляет несколько диапазонов в рамках одной операции.

Эти функции можно добавить в качестве инструментов в рабочий процесс или предоставить агенту для использования по мере необходимости. Для их настройки вам потребуется:

• А Учетная запись Google с доступом к Google Cloud..
• Un Проект создан на платформе Google Cloud..
• La API Google Таблиц включено.
• Сервисный аккаунт с ключ в формате JSON.
• А общий лист с адресом электронной почты этой учетной записи.

Сервисный аккаунт функционирует как отдельная учетная запись. Поэтому Dify не использует напрямую вашу личную учетную запись Google и не может автоматически получать доступ ко всем вашим электронным таблицам. Он будет иметь доступ только к тем документам, которыми вы явно поделились с ним.

Как создать сервисный аккаунт в Google Cloud

Первый шаг — перейти в консоль Google Cloud и создать новый проект или выбрать существующий. В проекте откройте раздел «API и сервисы», перейдите в библиотеку и выполните поиск... API Google ТаблицЗатем нажмите на эту опцию, чтобы включить её.

Далее, введите Управление идентификацией и доступом (IAM) и администрирование > Сервисные учетные записи и создайте новую учетную запись. Вы можете дать ей имя, которое позволит легко определить, для чего она используется, например, «Dify Google Sheets».

В ходе этого процесса Google может предложить вам возможность назначить роли в проекте. Для этой интеграции вам не нужно назначать роль общего владельца или редактора для всего проекта. Доступ к конкретным таблицам будет контролироваться позже с помощью параметров общего доступа к Google Sheets.

После создания учетной записи:

1. Откройте свои данные в разделе «Учетные записи сервисов».
2. Перейдите на вкладку Ключи.
3. Нажмите на Добавить ключ > Создать новый ключ.
4. Выберите формат JSON.
5. Скачайте и сохраните файл. в безопасном месте.

JSON-файл содержит конфиденциальную информацию, включая закрытый ключ. Его нельзя публиковать, отправлять по электронной почте или загружать в репозиторий. Любой, кто получит этот ключ, сможет действовать, используя права доступа учетной записи службы.

Как установить и настроить плагин в Dify

В Dify откройте магазин плагинов и найдите надстройку Google Sheets, опубликованную компанией омлюкПеред установкой проверьте имя автора, чтобы избежать путаницы с другими расширениями, которые могут предлагать другие функции.

После установки откройте настройки учетных данных плагина. Форма запросит ключ учетной записи службы. Откройте загруженный JSON-файл в текстовом редакторе. скопировать все его содержимое и вставьте это в соответствующее поле.

Не копируйте отдельно только адрес электронной почты, идентификатор проекта или закрытый ключ. Для аутентификации запросов к Google Таблицам надстройке требуется полная структура JSON.

Далее сохраните учетные данные и откройте электронную таблицу, которую хотите использовать. Внутри JSON-файла вы найдете поле с названием... client_email, значение которого будет выглядеть примерно так:

[email protected]

Нажмите на Делиться Добавьте этот адрес в Google Таблицы, как если бы это был другой пользователь:

• Предоставляет разрешение читатель если Dify будет только консультироваться с данными.
• Предоставляет разрешение редактор если вам также необходимо обновить ячейки.

Не рекомендуется делиться электронной таблицей публично по ссылке. Служебная учетная запись позволяет сохранить документ в приватном режиме и ограничить доступ к нему для конкретного пользователя.

Как считывать данные из Google Таблиц из рабочего процесса

Чтобы извлечь информацию из таблицы, добавьте узел инструмента в рабочий процесс Dify и выберите действие. Пакетное получениеНадстройка позволяет выполнять запросы к нескольким диапазонам в рамках одной операции, что избавляет от необходимости создавать отдельный узел для каждого раздела таблицы.

Вам потребуется указать идентификатор электронной таблицы. Он отображается в её веб-адресе, между /d/ y /editВ URL-адресе со следующей структурой:

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

Необходимо использовать только значение, отмеченное как IDENTIFICADOR.

Вам также потребуется указать название вкладки и диапазон, используя обозначения Google Sheets. Вот несколько примеров:

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

Имя перед восклицательным знаком соответствует клавише табуляции. Следующие за ним буквы и цифры обозначают столбцы и строки, которые необходимо извлечь.

Затем вы можете передать результат узлу LLM для его обобщения, поиска записи или подготовки ответа. Рекомендуется указать модели использовать только полученные данные и четко указывать, когда совпадение не найдено, особенно если лист содержит информацию о клиентах, запасах или заказах.

Как обновить ячейки в Dify

Инструмент Пакетное обновление Это позволяет записывать значения в различных диапазонах. Это можно использовать, например, для изменения статуса задачи, сохранения классификации, сгенерированной ИИ, или добавления результата запроса.

Перед использованием убедитесь, что у учетной записи службы есть права редактора документа. Если у нее есть только права на чтение, запросы будут работать, но Google отклонит попытки записи.

Также рекомендуется запретить модели свободно выбирать любой диапазон или значение. Более безопасная конфигурация включает в себя следующее: Сначала проверьте данные, ограничьте количество изменяемых столбцов и постройте диапазон, используя контролируемые переменные. в рамках рабочего процесса.

Например, вы можете организовать этот процесс следующим образом:

1. El пользователь вводит номер заказа.
2. Batch Get возвращается в строй соответствующий.
3. Условный узел проверить, существует ли заказ.
4. Модель анализирует или классифицирует информацию.
5. Пакетное обновление записывает результат. в определенном столбце.
6. Выходной узел подтверждает, какая запись была изменена.

По возможности используйте тестовую электронную таблицу во время настройки. Неправильно составленное обновление может перезаписать существующую информацию, особенно если диапазон охватывает больше строк или столбцов, чем предполагалось.

Распространенные ошибки при подключении Dify к Google Sheets.

Если вы столкнулись с ошибкой аутентификации, убедитесь, что вы вставили весь JSON-файл и что его формат не был изменен. Закрытые ключи содержат переносы строк, которые необходимо сохранять в структуре документа.

Если Dify сообщает, что не может найти или получить доступ к листу, проверьте следующие пункты:

• API Google Sheets включен в правильном проекте.
• В таблице указано точное значение client_email.
• Идентификатор листа не содержит никаких дополнительных частей URL-адреса.
• Название вкладки совпадает, включая регистр букв, пробелы и диакритические знаки.
• В диапазоне используется допустимая запись, например: Datos!A2:C20.
• Учетная запись имеет права редактора, если в ходе рабочего процесса предпринимается попытка записи.

Если вы удалили или деактивировали ключ в Google Cloud, вам потребуется создать новый и заменить учетные данные, сохраненные в Dify. Также следует сгенерировать новый ключ, если вы подозреваете, что JSON-файл был скомпрометирован.

Различия между плагинами Google Sheets и Google Drive

Google Sheets и Google Drive не следует рассматривать как единую интеграцию. Плагин Sheets Community предназначен для Просмотр и изменение диапазонов ячеек через служебный аккаунт.

В отличие от этого, официальный плагин Google Drive, доступный в качестве источника данных, использует OAuth 2.0Это позволяет просматривать папки, получать список файлов и загружать их содержимое для обработки или включения в поток знаний Dify.

Коннектор Google Диска работает только в режиме чтения: он не создает файлы, не организует папки, не изменяет и не удаляет документы. При загрузке файлов из Google Рабочего пространства он автоматически экспортирует их в совместимые форматы. Таблицы Google преобразуются в файлы XLSX, а документы Google Docs и презентации Google Slides — в файлы PDF.

Следовательно, выбор интеграции должен соответствовать поставленной задаче:

• Используйте плагин для Google Таблицы Считывать или записывать значения в ячейки.
• Используйте источник данных Google Диск для поиска и загрузки файлов.
• Используйте оба варианта только в том случае, если рабочий процесс должен работать как с ячейками, так и с целыми документами.

Как расширить интеграцию с помощью n8n

Надстройка для Google Sheets полезна для выполнять действия из DifyОднако сам по себе он не охватывает все сценарии автоматизации. Если вам нужны триггеры, запланированные выполнения или подключения к нескольким приложениям, вы можете использовать другой подход. n8n как посредник.

В этой архитектуре, Dify может отправлять данные на веб-перехватчик n8n. через HTTP-запрос. n8n получает запрос. Он выполняет узлы Google Sheets и возвращает результат в рабочий процесс..

Вы также можете выполнить обратный процесс. Например, n8n может обнаружить новую строку, обработать ее значения и вызвать API приложения, опубликованного на Dify. Полученный с помощью ИИ результат затем можно записать в другой столбец того же листа.

Эта система позволяет создавать сценарии автоматизации, такие как:

• Автоматическая классификация ответов, добавленных в таблицу.
• Создавайте сводные отчеты в определенный момент времени.
• Обновлять записи и одновременно отправлять уведомления.
• Объедините данные из Google Таблиц с электронной почтой, CRM-системами или другими приложениями.
• Перед тем как разрешить ИИ изменять ячейку, необходимо выполнить проверку данных.

Взамен конфигурация становится более сложной и требует защиты веб-хуков, учетных данных и ключей API, используемых обеими службами.

Подключение Dify к Google Sheets позволяет превратить обычную электронную таблицу в легкодоступный источник информации для агентов или рабочих процессов. Самый простой способ — включить API Sheets, создать учетную запись службы, установить плагин и поделиться только необходимыми таблицами с вашим адресом электронной почты.

Оттуда, Функция Batch Get позволяет запрашивать диапазоны значений, а функция Batch Update записывает результаты.Если проект требует работы с полными документами, реагирования на события или координации нескольких приложений, вы можете дополнить эту систему Google Drive или n8n, не путая функции каждого инструмента.