Integração com Google Sheets
Sincronização de dados de planilhas com a integração do Google Sheets para CrewAI.
Visão Geral
Permita que seus agentes gerenciem dados de planilhas por meio do Google Sheets. Leia linhas, crie novos registros, atualize dados existentes e otimize os fluxos de trabalho de gerenciamento de dados com automação alimentada por IA. Perfeito para acompanhamento de dados, relatórios e gestão colaborativa de informações.
Pré-requisitos
Antes de utilizar a integração com o Google Sheets, certifique-se de que você possui:
- Uma conta CrewAI Enterprise com assinatura ativa
- Uma conta Google com acesso ao Google Sheets
- Sua conta Google conectada pela página de integrações
- Planilhas com cabeçalhos de coluna adequados para operações com dados
Configurando a Integração com Google Sheets
1. Conecte sua Conta Google
- Acesse Integrações do CrewAI Enterprise
- Localize Google Sheets na seção Integrações de Autenticação
- Clique em Conectar e conclua o fluxo OAuth
- Conceda as permissões necessárias para acesso à planilha
- Copie seu Token Enterprise em Configurações da Conta
2. Instale o Pacote Necessário
Ações Disponíveis
GOOGLE_SHEETS_GET_ROW
GOOGLE_SHEETS_GET_ROW
Descrição: Obtém linhas de uma planilha Google Sheets.
Parâmetros:
spreadsheetId
(string, obrigatório): Planilha - Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar uma planilha. Por padrão, usa a primeira worksheet da planilha selecionada.limit
(string, opcional): Limite de linhas - Limita o número máximo de linhas retornadas.
GOOGLE_SHEETS_CREATE_ROW
GOOGLE_SHEETS_CREATE_ROW
Descrição: Cria uma nova linha em uma planilha Google Sheets.
Parâmetros:
spreadsheetId
(string, obrigatório): Planilha - Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar uma planilha. Por padrão, usa a primeira worksheet da planilha selecionada.worksheet
(string, obrigatório): Worksheet - Sua worksheet deve conter cabeçalhos de coluna.additionalFields
(object, obrigatório): Campos - Inclua os campos para criar essa linha como um objeto, usando os nomes das colunas como chaves. Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar um Mapeamento de Colunas.
GOOGLE_SHEETS_UPDATE_ROW
GOOGLE_SHEETS_UPDATE_ROW
Descrição: Atualiza linhas existentes em uma planilha Google Sheets.
Parâmetros:
spreadsheetId
(string, obrigatório): Planilha - Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar uma planilha. Por padrão, usa a primeira worksheet da planilha selecionada.worksheet
(string, obrigatório): Worksheet - Sua worksheet deve conter cabeçalhos de coluna.filterFormula
(object, opcional): Filtro em forma normal disjuntiva - OU de grupos E (AND) de condições individuais para identificar quais linhas atualizar.Operadores disponíveis:$stringContains
,$stringDoesNotContain
,$stringExactlyMatches
,$stringDoesNotExactlyMatch
,$stringStartsWith
,$stringDoesNotStartWith
,$stringEndsWith
,$stringDoesNotEndWith
,$numberGreaterThan
,$numberLessThan
,$numberEquals
,$numberDoesNotEqual
,$dateTimeAfter
,$dateTimeBefore
,$dateTimeEquals
,$booleanTrue
,$booleanFalse
,$exists
,$doesNotExist
additionalFields
(object, obrigatório): Campos - Inclua os campos a serem atualizados como objeto, usando os nomes das colunas como chaves. Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar um Mapeamento de Colunas.
Exemplos de Uso
Configuração Básica de um Agente Google Sheets
Filtrando Ferramentas Específicas do Google Sheets
Análise de Dados e Geração de Relatórios
Atualizações Automatizadas de Dados
Fluxo de Trabalho Complexo com Dados
Solução de Problemas
Problemas Comuns
Erros de Permissão
- Certifique-se de que sua conta Google tem acesso de edição às planilhas alvo
- Verifique se a conexão OAuth inclui os escopos necessários para a API do Google Sheets
- Confira se as planilhas estão compartilhadas com a conta autenticada
Problemas de Estrutura da Planilha
- Certifique-se de que as worksheets têm cabeçalhos de coluna antes de criar ou atualizar linhas
- Verifique se os nomes das colunas em
additionalFields
correspondem exatamente aos cabeçalhos - Confirme que a worksheet especificada existe na planilha
Problemas de Tipo e Formato de Dados
- Garanta que os valores dos dados estejam no formato esperado para cada coluna
- Utilize formatos de data adequados nas colunas de data (recomenda-se ISO)
- Verifique se valores numéricos estão devidamente formatados para colunas numéricas
Problemas com Fórmulas de Filtro
- Certifique-se de que as fórmulas de filtro seguem a estrutura JSON correta para forma normal disjuntiva
- Use nomes de campos válidos, correspondendo exatamente aos cabeçalhos das colunas
- Teste filtros simples antes de criar consultas com múltiplas condições
- Verifique se os tipos de operadores correspondem aos tipos de dados das colunas
Limites de Linhas e Performance
- Fique atento aos limites de linhas ao usar
GOOGLE_SHEETS_GET_ROW
- Considere paginação para grandes volumes de dados
- Use filtros específicos para reduzir a quantidade de dados processados
Operações de Atualização
- Certifique-se de que as condições de filtro identifiquem corretamente as linhas a serem atualizadas
- Teste condições de filtro com pequenos conjuntos de dados antes de grandes atualizações
- Verifique se todos os campos obrigatórios estão incluídos nas operações de atualização
Obtendo Ajuda
Precisa de Ajuda?
Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas da integração com o Google Sheets.