Guia completo: Conectando o Dify com o Google Sheets e o Drive

Integração direta por meio de plugins especializados para leitura e gravação de dados em planilhas.
Gerenciamento automatizado de arquivos baseado em nuvem, permitindo a busca, criação e download de documentos.
Configuração flexível através de contas de serviço JSON ou protocolos de autenticação OAuth 2.0.
Sincronização bidirecional que permite converter documentos do Google Workspace para formatos compatíveis, como XLSX e PDF.

Conecte o Dify ao Google Sheets e ao Google Drive.

Se você deseja que seus agentes de IA trabalhem com informações reais e atualizadas, Conecte o Dify ao Google Sheets É uma das maneiras mais simples de se conseguir isso. A planilha pode funcionar como um pequeno repositório de dados a partir do qual você pode consultar produtos, clientes, tarefas ou qualquer outro registro usado pelo seu aplicativo.

Essa integração permite que um fluxo de trabalho do Dify leia diferentes intervalos e grave novos valores sem a necessidade de copiar dados manualmente. Por exemplo, você pode criar um assistente que verifica o status do pedido, categoriza respostas de formulário ou atualiza uma tabela após o processamento de uma solicitação.

Existem várias maneiras de fazer isso. A rota mais direta utiliza um Plugin do Google Sheets e uma conta de serviço do Google CloudSe você precisar reagir automaticamente a mudanças, executar tarefas agendadas ou integrar a planilha com outros aplicativos, também pode usar uma plataforma intermediária como o n8n.

O que você precisa para conectar o Dify ao Google Sheets

Antes de começarmos, vale a pena esclarecer que o complemento omluc/google_sheets Disponível no Dify Marketplace, este é um plugin da comunidade. Ele não faz parte dos plugins oficiais desenvolvidos pela equipe Dify, embora possa ser instalado a partir do marketplace de extensões deles.

Este plugin incorpora atualmente duas ferramentas principais:

Obter em lote: Recupera dados de um ou mais intervalos em uma planilha.
Atualização em lote: Atualiza vários intervalos dentro da mesma operação.

Essas funções podem ser adicionadas como ferramentas em um fluxo de trabalho ou disponibilizadas a um agente para uso conforme necessário. Para configurá-las, você precisará de:

UM Conta do Google com acesso ao Google Cloud.
Un Projeto criado no Google Cloud.
La API do Google Sheets ativado.
Uma conta de serviço com um chave em formato JSON.
UM folha compartilhada com o endereço de e-mail dessa conta.

A conta de serviço funciona como uma identidade separada. Portanto, o Dify não usa diretamente sua conta pessoal do Google, nem pode acessar automaticamente todas as suas planilhas. Ele terá acesso apenas aos documentos que você compartilhar explicitamente com ele.

Como criar uma conta de serviço no Google Cloud

O primeiro passo é acessar o Console do Google Cloud e criar um novo projeto ou selecionar um existente. Dentro do projeto, abra a seção APIs e Serviços, acesse a biblioteca e pesquise por... API do Google SheetsEm seguida, toque na opção para ativá-la.

Em seguida, insira IAM e administração > Contas de serviço e crie uma nova conta. Você pode dar a ela um nome que facilite a identificação de sua finalidade, como "Dify Google Sheets".

Conteúdo exclusivo - Clique aqui GRU Space e o primeiro hotel na Lua: reservas, planos e perguntas

Durante esse processo, o Google pode oferecer a opção de atribuir funções dentro do projeto. Para essa integração, não é necessário atribuir uma função geral de proprietário ou editor para todo o projeto. O acesso a planilhas específicas será controlado posteriormente por meio das opções de compartilhamento do Google Sheets.

Após a criação da conta:

Acesse seus dados na seção de contas de serviço.
Acesse a aba Chaves.
Clique em Adicionar chave > Criar uma nova chave.
Selecione o formato JSON.
Baixe e salve o arquivo. em um lugar seguro.

O arquivo JSON contém informações confidenciais, incluindo uma chave privada. Você não deve publicá-lo, enviá-lo por e-mail ou carregá-lo em um repositório. Qualquer pessoa que obtiver essa chave poderá agir com as permissões da conta de serviço.

Como instalar e configurar o plugin no Dify

No Dify, abra o Marketplace de Plugins e procure pelo complemento do Google Sheets publicado por omlucVerifique o nome do autor antes de instalar para evitar confundi-lo com outras extensões que possam oferecer funções diferentes.

Após a instalação, abra as configurações de credenciais do plugin. O formulário solicitará a chave da conta de serviço. Abra o arquivo JSON baixado com um editor de texto. copiar todo o seu conteúdo e cole-o no campo correspondente..

Não copie apenas o e-mail, o ID do projeto ou a chave privada separadamente. O complemento requer a estrutura JSON completa para autenticar as solicitações feitas ao Google Sheets.

Em seguida, salve as credenciais e abra a planilha que deseja usar. Dentro do arquivo JSON, você encontrará um campo chamado client_email, cujo valor terá uma aparência semelhante a esta:

[email protected]

Clique em Compartilhar No Google Sheets, adicione esse endereço como se fosse de outro usuário:

Concede permissão a leitor se o Dify consultar apenas os dados.
Concede permissão a editor Se você também precisar atualizar células.

Não é recomendável compartilhar a planilha publicamente por meio de um link. A conta de serviço permite manter o documento privado e restringir o acesso a um usuário específico.

Como ler dados do Google Sheets a partir de um fluxo de trabalho

Para recuperar informações da planilha, adicione um nó de ferramenta ao fluxo de trabalho do Dify e selecione a ação. Obter em loteO suplemento permite consultar vários intervalos em uma única operação, evitando a necessidade de criar um nó diferente para cada seção da tabela.

Você precisará fornecer o identificador da planilha. Ele aparece no endereço da web, entre /d/ y /editEm uma URL com esta estrutura:

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

Você deve usar apenas o valor marcado como IDENTIFICADOR.

Você também precisará especificar o nome da guia e o intervalo usando a notação do Google Sheets. Alguns exemplos seriam:

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

O nome antes do ponto de exclamação corresponde à tabulação. As letras e os números que se seguem delimitam as colunas e linhas a serem recuperadas.

Conteúdo exclusivo - Clique aqui Como gerar PDFs automaticamente a partir do Google Sheets passo a passo

Em seguida, você pode passar o resultado para um nó LLM para resumi-lo, localizar um registro ou preparar uma resposta. É recomendável instruir o modelo a usar apenas os dados recuperados e a indicar claramente quando não encontrar uma correspondência, especialmente se a planilha contiver informações de clientes, estoque ou pedidos.

Como atualizar células do Dify

A ferramenta Atualização em lote Permite inserir valores em vários intervalos. Isso pode ser usado, por exemplo, para alterar o status de uma tarefa, salvar uma classificação gerada por IA ou adicionar o resultado de uma solicitação.

Antes de usar, verifique se a conta de serviço tem permissões de edição no documento. Se tiver apenas permissões de leitura, as consultas funcionarão, mas o Google rejeitará as tentativas de gravação.

Também é aconselhável impedir que o modelo escolha livremente qualquer intervalo ou valor. Uma configuração mais segura consiste em Primeiro, valide os dados, limite as colunas modificáveis e construa o intervalo usando variáveis controladas. através do fluxo de trabalho.

Por exemplo, você pode organizar o processo desta forma:

El O usuário insere um número de pedido..
Batch Get volta para a fila correspondente.
Um nó condicional Verifique se o pedido existe..
O modelo Analisa ou classifica as informações..
A atualização em lote grava o resultado. em uma coluna específica.
O nó de saída confirma qual registro foi modificado.

Sempre que possível, utilize uma planilha de teste durante a configuração. Uma atualização mal feita pode sobrescrever informações existentes, especialmente quando o intervalo abrange mais linhas ou colunas do que o pretendido.

Erros comuns ao conectar o Dify com o Google Sheets

Se você encontrar um erro de autenticação, verifique se colou o arquivo JSON completo e se o formato não foi alterado. As chaves privadas contêm quebras de linha que devem ser mantidas na estrutura do documento.

Quando o Dify indicar que não consegue encontrar ou acessar a planilha, verifique os seguintes pontos:

A API do Google Sheets está habilitada no projeto correto.
A planilha foi compartilhada com o valor exato de client_email.
O identificador da planilha não contém nenhuma parte adicional da URL.
O nome da aba corresponde, incluindo maiúsculas, espaços e acentos.
O intervalo utiliza uma notação válida, como por exemplo: Datos!A2:C20.
A conta tem permissão de editor se o fluxo de trabalho tentar gravar.

Se você excluiu ou desativou a chave no Google Cloud, será necessário criar uma nova e substituir as credenciais salvas no Dify. Você também deve gerar uma nova chave se suspeitar que o arquivo JSON foi exposto.

Diferenças entre os plugins do Google Sheets e do Google Drive

O Google Sheets e o Google Drive não devem ser tratados como uma única integração. O plugin da comunidade do Sheets destina-se a visualizar e modificar intervalos de células por meio de uma conta de serviço.

Conteúdo exclusivo - Clique aqui O que é rundll32.exe e como saber se é um malware legítimo ou disfarçado?

Em contrapartida, o plugin oficial do Google Drive, disponível como fonte de dados, utiliza OAuth 2.0Permite navegar por pastas, listar arquivos e baixar seu conteúdo para processamento ou incorporação em um fluxo de conhecimento do Dify.

O conector do Drive é somente leitura: ele não cria arquivos, organiza pastas, modifica ou exclui documentos. Ao baixar arquivos nativos do Google Workspace, eles são exportados automaticamente para formatos compatíveis. As Planilhas Google são convertidas em arquivos XLSX, enquanto os Documentos Google e as Apresentações Google são exportados como PDFs.

Portanto, você deve escolher a integração de acordo com a tarefa:

Use o plugin para Planilhas Google Ler ou escrever valores em células.
Utilize a fonte de dados de Google Drive Para localizar e baixar arquivos.
Combine ambos apenas se o fluxo de trabalho precisar trabalhar com células e documentos inteiros.

Como estender a integração usando n8n

Como estender a integração dify usando n8n

O complemento do Google Sheets é útil para executar ações do DifyNo entanto, por si só, não abrange todos os cenários de automação. Se precisar de gatilhos, execuções agendadas ou conexões com vários aplicativos, você pode adicionar recursos adicionais. n8n como intermediário.

Nessa arquitetura, A Dify pode enviar os dados para um webhook n8n. por meio de uma solicitação HTTP. O n8n recebe a solicitação, Ele executa seus nós do Google Sheets e retorna o resultado para o fluxo de trabalho..

Você também pode inverter o processo. Por exemplo, o n8n pode detectar uma nova linha, processar seus valores e chamar a API de um aplicativo publicado no Dify. O resultado gerado pela IA pode então ser gravado em outra coluna na mesma planilha.

Este sistema permite criar automações como:

Classificar automaticamente as respostas adicionadas a uma planilha.
Gere resumos em um horário específico.
Atualizar registros e enviar uma notificação ao mesmo tempo.
Combine dados do Google Sheets com e-mail, CRM ou outros aplicativos.
Aplique validações antes de permitir que a IA modifique uma célula.

Em contrapartida, a configuração é mais complexa e exige a proteção dos webhooks, credenciais e chaves de API utilizadas por ambos os serviços.

Conectar o Dify ao Google Sheets permite transformar uma planilha padrão em uma fonte de informações de fácil acesso para agentes ou fluxos de trabalho. A abordagem mais direta é habilitar a API do Sheets, criar uma conta de serviço, instalar o plugin e compartilhar apenas as planilhas necessárias com seu endereço de e-mail.

De lá, O comando Batch Get permite consultar intervalos de valores, e o comando Batch Update grava os resultados.Se o projeto precisar trabalhar com documentos completos, reagir a eventos ou coordenar vários aplicativos, você pode complementar essa configuração com o Google Drive ou o n8n sem confundir as funções de cada ferramenta.