Neste guia, você aprenderá como criar seu próprio plug-in AI para uso com o Google Docs. Para fazer isso, usaremos os modelos de linguagem do OpenAI, GPT-3.5 ou GPT-4, que estão alimentando o ChatGPT. Vamos mergulhar de cabeça.
Etapa 1: criar um novo documento e nomeá-lo
Crie um novo documento do Google ou use um atalho: digite “docs.new” na barra de endereços do navegador.
O plug-in AI que estamos prestes a criar funcionará apenas neste documento, então nomeie-o para poder encontrá-lo novamente mais tarde (neste demo, chamei o meu de “Assistente AI”).
Etapa 2: criar um novo Apps Script e nomeá-lo
Navegue até “Extensões” > “Apps Scripts” e, no canto superior esquerdo, dê um nome ao seu novo Apps Script.
Apps Script é uma linguagem de script que nos permite automatizar tarefas em Documentos ou Planilhas.
Etapa 3: adicionar chaves de API OpenAI
Para usar o GPT 3.5 ou GPT 4 da OpenAI (os modelos que alimentam sua interface ChatGPT), precisamos adicionar uma chave de API ao nosso Google App Script.
Você pode usar uma chave de API OpenAI existente ou criar uma nova em sua conta OpenAI navegando até “platform.openai.com”, clicando em “Chaves de API” ou “Exibir chaves de API” no menu da sua conta e criando uma nova API chave.
Depois de ter sua chave de API OpenAI pronta, navegue até “Configurações do projeto” em seu App Script…
… e role até “Propriedades do script” e clique em “Adicionar propriedade do script”
Nomeie a nova propriedade “OPENAI_API_KEY” e copie/cole sua chave de API OpenAI no campo “Valor”.
Passo 4: Adicionando o script
Por fim, volte ao editor de código do App Script (o símbolo “<>” no menu à esquerda) e clique em “Code.gs”, o arquivo do script principal que vamos editar agora:
Substitua as 3 linhas de código em Code.gs por isto:const MODEL_TYPE = “gpt-3.5-turbo” ;
const OPENAI_API_KEY = Serviço de propriedades . getScriptProperties (). getProperty ( ‘OPENAI_API_KEY’ );
função onOpen ( ) {
DocumentApp . getUi (). createMenu ( “Ferramentas de IA” )
. addItem ( “Criar sugestões de título/legenda” , “generateTitles” )
. addItem ( “Criar história em quadrinhos de 4 painéis” , “)
. addItem ( “Usar texto realçado como prompt” , “textAsPrompt” )
. adicionarToUi ();
}
function generateTitles ( ) {
const doc = DocumentApp . getActiveDocument ();
const userText = doc. obterSeleção (). getRangeElements ()[ 0 ]. getElement (). asText (). getText ();
const prompt = `Crie vários títulos e subtítulos para o seguinte tópico: ” ${userText}”` ;
callOpenAiAPI (prompt, doc);
}
function fourPanelStory ( ) {
const doc = DocumentApp . getActiveDocument ();
const userText = doc. getSelection (). getRangeElements ()[ 0 ]. getElement (). asText (). getText ();
const prompt = `Use esta ideia para criar uma história em quadrinhos composta por quatro imagens, mas responda apenas com breves legendas de imagem para as quatro imagens: ${userText} \n` ;
callOpenAiAPI (prompt, doc);
}
function textAsPrompt ( ) {
const doc = DocumentApp . getActiveDocument ();
const userText = doc. obterSeleção (). getRangeElements ()[ 0 ]. getElement (). asText (). getText ();
const prompt = ` ${userText} ` ;
callOpenAiAPI (prompt, doc);
}
function callOpenAiAPI ( prompt, doc ) { corpo
const = doc. getCorpo ();
consttemperatura = 0,83 ;
const maxTokens = 2060 ;
const requestBody = {
modelo : MODEL_TYPE ,
mensagens : [{ função : “usuário” , conteúdo : prompt}],
temperatura,
max_tokens : maxTokens,
};
const options = {
method : “POST” ,
headers : {
“Content-Type” : “application/json” ,
Authorization : “Bearer ” + OPENAI_API_KEY ,
},
carga útil : JSON . stringify (requestBody),
}; resposta
const = UrlFetchApp . fetch ( “https://api.openai.com/v1/chat/completions” , opções);
const respostaTexto = resposta. getContentText ();
constjson = JSON . parse (responseText);
const geradoTexto = json[ ‘escolhas’ ][ 0 ][ ‘mensagem’ ][ ‘conteúdo’ ];
Registrador . log (generatedText);
corpo.appendParagraph (generatedText. toString ());
}
Seu arquivo Code.gs agora deve se parecer com o seguinte:
Passo 5: Salve o script e execute-o
É hora de salvar seu trabalho e testar o script. Clique no pequeno item ???? no menu superior para salvar o App Script.
Isso ativará o botão “Executar”. Certifique-se de que diz “onOpen” ao lado (esta é a função que queremos executar quando o script for iniciado). Clique em “Executar”.
Agora você será solicitado a revisar as permissões do script. Como chamaremos um serviço externo (o servidor OpenAI), o Google nos pergunta se confiamos nesse script e em seu serviço externo.
Já que o fazemos, clique em “Avançado” e depois em “Ir para [nome do seu script] (inseguro)”. Faça login com sua conta e clique em “Permitir”.
A tag “insegura” é a suposição padrão do Google aqui, é segura de usar (bem, lembre-se de que você pagará pelas gerações de texto com base em tokens: 1.000 tokens gerados pelo GPT 3.5 custarão $ 0,002, se você mudar para o GPT 4 então você terá que pagar $ 0,06 pela mesma quantidade de tokens)
Etapa 6: testar o script e personalizá-lo
Depois de recarregar seu Google Doc inicial, você verá um novo menu chamado “AI Tools”.
Três itens de menu mostram algumas das possibilidades que você tem agora dentro do seu Google Doc. Se você destacar algo e clicar em um dos itens, o texto destacado será processado de acordo.
Costumização
Agora, é hora de alterar o script de acordo com suas necessidades. Então, vamos dar uma olhada rápida no código (navegue de volta para “Extensions” > “App Scripts” e escolha o arquivo com o qual acabamos de trabalhar: “Code.gs”)
Você encontrará uma função chamada “onOpen” que é responsável por criar o novo menu e os três itens de menu.função onOpen ( ) {
DocumentApp . getUi (). createMenu ( “Ferramentas de IA” )
. addItem ( “Criar sugestões de título/legenda” , “generateTitles” )
. addItem ( “Criar história em quadrinhos de 4 painéis” , “fourPanelStory” )
. addItem ( “Usar texto realçado como prompt” , “textAsPrompt” )
. adicionarToUi ();
}
Cada item de menu tem uma função correspondente listada ao lado do nome do item de menu. Por exemplo, o item de menu
“Criar sugestões de título/legenda”
vem com uma função chamada
“gerar títulos”
Se você rolar um pouco para baixo, verá esta função e como o prompt subjacente é definido.function generateTitles ( ) {
const doc = DocumentApp . getActiveDocument ();
const userText = doc. obterSeleção (). getRangeElements ()[ 0 ]. getElement (). asText (). getText ();
const prompt = `Crie vários títulos e subtítulos para o seguinte tópico: ” ${userText} “` ;
callOpenAiAPI (prompt, doc);
}
Nesse caso, sempre que o item de menu “Criar sugestões de título/legenda” for clicado, a área de texto destacada momentaneamente será combinada com esse prompt e enviada para o modelo de complementação de texto GPT 3.5 do OpenAI.
Aqui está o prompt sozinho:Crie vários títulos e subtítulos para o seguinte tópico: “${userText}”
A parte ${userText} é o espaço reservado para o texto realçado do seu Documento Google.
Agora você pode alterar o nome do menu, seus itens e os prompts correspondentes.
Alteração de tokens máximos e temperatura
Você também pode alterar as configurações para sua chamada API OpenAI aqui:function callOpenAiAPI ( prompt, doc ) { corpo
const = doc. getCorpo (); temperatura
constante = 0,83 ;
const maxTokens = 2060 ;
const requestBody = {
modelo : MODEL_TYPE ,
mensagens : [{ função : “usuário” , conteúdo : prompt}],
temperatura,
max_tokens : maxTokens,
};
É isso.
