GPT no Google Sheet de Graça com Apps Script

Geralmente ao buscar uma integração com GPT no Google Sheet nos deparamos com várias opções disponíveis nas lojas de extensões, só que a grande maioria é pago e caro. Pensando nisso, vamos ensinar como você pode instalar um Apps Script Gratuito para usar sua API do GPT em fórmula nas suas planilhas.

Vantagens da Integração do GPT com o Google Sheets

A. Personalização e Flexibilidade: Diferentemente das extensões padrão, a integração do GPT permite criar soluções personalizadas para atender necessidades específicas. Isso inclui análises de dados, geração de relatórios, automação de tarefas repetitivas e processamento de linguagem natural.

B. Economia de Tempo e Eficiência: O GPT pode automatizar tarefas que normalmente consumiriam muito tempo, como a compilação de dados de diferentes fontes, a redação de resumos de dados e a geração de insights a partir de conjuntos de dados complexos.

C. Aprimoramento Contínuo: O modelo GPT está em constante evolução, recebendo atualizações e melhorias que ampliam suas capacidades e eficiência.

Extensão x Script Personalizado

As extensões geralmente oferecem mais opções, uma UI personalizada com uma interface de fácil acesso e configuração. O grande problema é o preço usado para realizar algo simples, consultar o GPT.

Fazer um script personalizado além de economizar dinheiro, vai permitir customizar, colocar instruções padronizadas, criar diferentes formulas que atendem suas necessidades.

O grande problema é que usar o Script do Apps Scripts, mesmo com a ajuda do chatGPT ainda pode ocasionar em erros. Até executar e depurar o código pode ser um pouco chato.

Como Integrar o GPT ao Google Sheets

Integrar o GPT ao Google Sheets envolve alguns passos técnicos, incluindo:

A. Configuração de API: Primeiramente, é necessário obter acesso à API do GPT da OpenAI. Isso geralmente envolve a criação de uma conta e a obtenção de uma chave de API.

B. Uso do Google Apps Script: O Google Apps Script, uma plataforma de script baseada em JavaScript para automação no G Suite, pode ser usado para integrar o GPT ao Google Sheets. Isso envolve escrever scripts que fazem chamadas à API do GPT e processam as respostas.

C. Automação e Customização: Com o script em funcionamento, é possível automatizar tarefas, como a geração de texto, análises de dados e outras funcionalidades, diretamente no Google Sheets.

Código do Apps Script para usar GPT no Sheet

Abaixo compartilho o código que uso para usar uma simples formula como GPT=(“promt”;CE1). Usando essa fórmula do Sheet eu consigo usar diferentes celulas para gerar conteúdo nas minhas tabelas.

Você também pode customizar e modificar o código, criar diferentes fórmulas que realizam diferentes funções. Com a ajuda do chat GPT você vai conseguir usar a API da OpenAI no Google Sheet de graça.

var apiKey = 'SUACHAVEDEAPI';

function GPT() {
  var messages = [];
  for (var i = 0; i < arguments.length; i++) {
    var arg = arguments[i];
    if (typeof arg === 'string' && arg.trim() !== '') {
      messages.push({ 'role': 'user', 'content': arg.trim() });
    } else if (Array.isArray(arg)) {
      arg.forEach(function(cellValue) {
        if (typeof cellValue === 'string' && cellValue.trim() !== '') {
          messages.push({ 'role': 'user', 'content': cellValue.trim() });
        }
      });
    }
  }

  if (messages.length === 0) {
    return 'Nenhuma mensagem válida fornecida.';
  }

  var url = 'https://api.openai.com/v1/chat/completions';
  var headers = {
    'Authorization': 'Bearer ' + apiKey,
    'Content-Type': 'application/json'
  };

  var payload = {
    'model': 'gpt-3.5-turbo-1106', // Especificar o modelo desejado
    'messages': messages,
    'max_tokens': 700 // Configuração flexível do número máximo de tokens
  };

  var options = {
    'method': 'post',
    'headers': headers,
    'payload': JSON.stringify(payload),
    'muteHttpExceptions': true // Importante para tratar erros
  };

  try {
    var response = UrlFetchApp.fetch(url, options);
    var result = JSON.parse(response.getContentText());

    if (response.getResponseCode() === 200 && result.choices && result.choices.length > 0) {
      return result.choices[0].message.content; // Acessa o conteúdo da mensagem corretamente
    } else {
      Logger.log('Erro na resposta da API: ' + response.getContentText());
      return 'Erro na resposta da API.';
    }
  } catch (e) {
    Logger.log('Erro ao fazer a requisição para a API: ' + e.message);
    return 'Erro ao fazer a requisição para a API.';
  }
}

Como Instalar o Código no Apps Script

Para integrar o GPT da OpenAI com o Google Sheets, você precisará usar o Google Apps Script, que permite automatizar tarefas e interagir com APIs externas, como a da OpenAI. Abaixo, segue um tutorial passo a passo de como instalar o código fornecido e utilizar uma fórmula personalizada no Google Sheets para interagir com o GPT.

Passo 1: Configurar a API da OpenAI

1. Acesse o site da OpenAI e crie uma conta ou faça login.
2. Navegue até a seção de gerenciamento de API e gere uma nova chave de API. Guarde essa chave, pois você precisará dela para autenticar suas requisições.

Passo 2: Abrir o Editor do Google Apps Script

1. Abra um novo ou existente Google Sheets onde você deseja usar o GPT.
2. No menu, clique em Extensões > Apps Script.
3. Isso abrirá o editor do Google Apps Script em uma nova aba.

Passo 3: Instalar o Código

1. No editor do Apps Script, apague qualquer código existente.
2. Copie e cole o código fornecido no editor.
3. Substitua 'SUACHAVEDEAPI' pela chave de API real que você obteve da OpenAI.
4. Salve o script com um nome de projeto relevante, usando Arquivo > Salvar ou o ícone de disquete.

Passo 4: Usar a Função Personalizada no Google Sheets

1. Volte para a sua planilha do Google Sheets.
2. Em uma célula, digite =GPT("Sua pergunta aqui") para fazer uma pergunta ao GPT. Você também pode referenciar outras células que contenham o texto que deseja enviar.
3. Pressione Enter e aguarde a resposta ser gerada. Isso pode levar alguns segundos, dependendo da resposta da API.

Considerações Importantes

• Cotas e Limites: A API da OpenAI tem cotas de uso, que podem limitar a quantidade de requisições que você pode fazer. Fique atento a esses limites para evitar interrupções.
• Segurança da Chave de API: Mantenha sua chave de API segura e não a compartilhe dentro do script ou de qualquer maneira que possa ser exposta publicamente.
• Tratamento de Erros: O código inclui tratamento básico de erros, mas você pode querer expandi-lo para lidar melhor com falhas de rede ou respostas inesperadas da API.
• Customização: Você pode ajustar o modelo ('model'), o número máximo de tokens ('max_tokens') e outras configurações conforme a necessidade do seu projeto.

Seguindo estes passos, você será capaz de integrar o poderoso GPT da OpenAI ao Google Sheets, abrindo um leque de possibilidades para automação, análise de dados, geração de conteúdo e muito mais.