Crie, execute e personalize um complemento de revisão de slides para as Apresentações do Google Workspace com este projeto de código. Seja uma apresentação por semana ou uma por ano, a maioria de nós precisa de uma ajudinha para acertar. Você tende a colocar muito em um slide? Talvez você se esqueça de dividir sua apresentação com os recursos visuais? Você pode até ter um conjunto de diretrizes de sua organização em apresentações eficazes. Você leu isso recentemente?
O projeto Consultor do Apresentações é um complemento de código aberto do Google Workspace que usa a tecnologia de inteligência artificial (IA) para analisar e dar feedback sobre suas apresentações, sempre que você precisa. O projeto usa os recursos de processamento de imagem e texto da API Gemini do Google para analisar suas Apresentações Google em relação a um conjunto de diretrizes e informa seu desempenho em relação a elas. Melhor ainda, você pode personalizar essas diretrizes para seguir as recomendações da sua organização ou lembrá-lo de melhorar suas apresentações com base em regras que você definir para si.
Para ter uma visão geral em vídeo do projeto e como estendê-lo, incluindo insights das pessoas que o criaram, confira Avaliador de apresentações de IA: criar com IA do Google. Caso contrário, você pode começar a ampliar o projeto seguindo as instruções abaixo.
Figura 1. Complemento do consultor do Apresentações Google para o app Apresentações Google executado como um painel de barra lateral.
Configuração do projeto
Estas instruções ajudam você a configurar o projeto do consultor do Apresentações para desenvolvimento e teste. As etapas gerais são criar o projeto do Google Apps Script, configurar um projeto do Google Cloud para acesso à API e definir algumas propriedades do script para o projeto.
Criar projeto do Apps Script
Este projeto do consultor do Apresentações é executado como um complemento para o Apresentações Google. Configure o projeto usando a interface da Web do Apresentações Google e crie um projeto do Apps Script para o código.
Para criar um novo projeto do Apps Script:
- Acesse o app Apresentações da Web para o Google Workspace.
- Abra uma apresentação existente ou crie uma nova.
- Na apresentação, selecione Extensões > Apps Script.
Ao concluir essas etapas, você terá um novo projeto sem título na interface do usuário da Web do Apps Script, anexado à apresentação de início. Dê um nome ao projeto para que seja mais fácil encontrá-lo.
Para nomear o projeto do Apps Script:
- Na interface da Web do Apps Script, selecione o texto Untitled project.
- Na caixa de diálogo "Rename Project", digite:
My Slides Advisore selecione Rename.
Preparar os arquivos do projeto
O projeto do Supervisor do Apresentações tem cinco arquivos de código que você precisa configurar antes de copiar o código para seu novo projeto do Apps Script. Esta seção descreve como preparar o projeto e extrair o código.
Para preparar os arquivos do projeto:
- Abra a interface da Web do Apps Script que contém o projeto My Slides Advisor.
- No menu lateral esquerdo, selecione a visualização < > Editor.
- Mude o nome do arquivo Code.gs para main.gs passando o cursor sobre o nome do arquivo do código
Code.gs, selecionando Rename no menu de contexto e
inserindo
main. A interface adiciona a extensão .gs automaticamente. - Para exibir o arquivo de manifesto appscript.json do projeto, selecione o ícone de engrenagem (Configurações do projeto) no menu lateral à esquerda e ative a opção Mostrar arquivo de manifesto "appscript.json".
- Na interface da Web do Apps Script, no menu lateral esquerdo, selecione a visualização <> Editor.
- Para criar um arquivo de código ui.gs, selecione o ícone + (sinal de mais) à direita
do cabeçalho Files, selecione Script e digite
ui. - Repita a etapa anterior para criar os arquivos de código
slides.gseai.gs.
Seu projeto do Apps Script vai conter agora os cinco arquivos de código a seguir, que estão quase vazios:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
Para a próxima etapa, copie o código do projeto no repositório e cole-o no seu projeto do Apps Script.
Acessar o código do projeto
O código do projeto do consultor do Apresentações está hospedado em um repositório. Você precisa copiar esse código no seu projeto do Apps Script para trabalhar com ele. Esta seção descreve como conseguir o código do projeto.
Para conseguir o código do projeto:
- Navegue até o repositório de código do projeto para encontrar o arquivo de manifesto,
appsscript.json. - Copie o conteúdo do arquivo de código para a área de transferência.
- Volte para a interface da Web do Apps Script, selecione o nome de arquivo appsscript.json e cole o código no painel do editor, substituindo qualquer código anterior.
- Repita este procedimento para os outros quatro arquivos de código:
Conectar projeto do Google Cloud
Este projeto usa um projeto do Google Cloud para acessar os modelos de IA do Gemini. O Google Cloud fornece políticas específicas de privacidade de dados, bem como uma série de serviços de software úteis para criar aplicativos como o Slides Advisor. Para conectar o código do complemento à API Gemini, crie um projeto do Cloud com acesso à API de IA, crie uma conta de serviço para o projeto, crie uma chave para a conta de serviço e a instale no projeto do complemento.
Configurar um projeto do Cloud
O projeto do Cloud que você usa para se conectar à API Gemini precisa ter o serviço da API Vertex AI ativado, e você precisará criar uma conexão autenticada a partir do complemento do consultor do Apresentações para esse projeto. A API Vertex AI também exige que o faturamento esteja ativado nos projetos em que você o usa.
Para configurar um projeto do Cloud com acesso à API Vertex AI:
- Navegue até o console do Google Cloud e faça login, se necessário.
- No console do Google Cloud, selecione um projeto do Cloud atual ou crie um novo.
- Na página Painel do seu projeto, no painel APIs, selecione Ir para a visão geral das APIs ou navegue até https://console.cloud.google.com/apis/.
- Na parte de cima da página APIs e serviços, selecione + ATIVAR APIS E SERVIÇOS.
- Na página Biblioteca de APIs, pesquise
vertex ai api, selecione a opção API Vertex AI e clique no botão Ativar. - Se o projeto do Google Cloud ainda não estiver ativo, ative o faturamento e ative a API AI selecionando o botão Ativar na página do console da API Vertex AI.
- Para verificar se a API Vertex AI está ativada, acesse a página APIs e serviços do seu projeto. A API Vertex AI vai aparecer listada nesta página.
Crie uma conta de serviço
O complemento Slides Advisor requer uma conexão autenticada com o projeto do Cloud para acessar a API Vertex AI e os modelos do Gemini. Para criar essa conexão, primeiro gere uma conta de serviço no projeto do Cloud que tenha acesso à API Vertex AI. O projeto do Consultor do Apresentações se conecta usando essa conta de serviço.
Se você quiser criar uma conta de serviço para o complemento do consultor do Apresentações, faça o seguinte:
- No console do Google Cloud, navegue até a página APIs e serviços do projeto do Cloud.
- No lado esquerdo da página, selecione Credenciais.
- Na parte de cima da página, selecione + CRIAR CREDENCIAIS > Conta de serviço.
- Na página Criar conta de serviço, seção Detalhes da conta de serviço, insira um nome, ID e descrição para a conta de serviço.
- Crie a conta de serviço selecionando Criar e continuar.
- Na seção Conceda a essa conta de serviço acesso ao projeto, selecione o controle Papel.
- Na pesquisa de campo Filtro, selecione o conjunto de permissões Usuário da Vertex AI e selecione Continuar.
- Conclua a criação dessa conta de serviço selecionando Concluído.
Para mais informações sobre como criar contas de serviço, consulte a documentação Criar contas de serviço do Google Cloud.
Criar e instalar a chave da conta de serviço
O projeto do consultor do Apresentações precisa ser autenticado na conta de serviço criada no procedimento anterior. Para ativar essa autenticação, crie uma chave para a conta de serviço e configure-a no projeto do Apps Script do consultor do Apresentações como uma propriedade de script. O procedimento a seguir explica como criar a chave e configurá-la no projeto.
Para criar e configurar uma chave de conta de serviço:
- No console do Google Cloud, navegue até a página APIs e serviços do seu projeto do Cloud.
- No lado esquerdo da página, selecione Credenciais.
- Na seção Contas de serviço, encontre a conta de serviço que você criou e selecione o endereço de e-mail da conta ou o ícone de lápis para editá-lo.
- Na janela de edição da conta de serviço, perto do topo da página, selecione o título da guia CHAVES.
- Na seção Chaves, selecione Adicionar chave > Criar nova chave.
- Na caixa de diálogo Criar chave privada para..., selecione JSON e depois Criar. Nesta etapa, é criado um arquivo de chave chamado projectid-hashcode.json e o download é feito automaticamente no seu computador.
- Abra o arquivo projectid-hashcode.json que você transferiu por download e copie o conteúdo.
- Abra a interface da Web do Apps Script que contém o projeto My Slides Advisor e, no menu à esquerda, selecione a visualização Configurações.
- Na seção Propriedades do script, selecione o botão Editar propriedades do script e, em seguida, o botão Adicionar propriedade do script.
- No novo campo Propriedade, insira
SERVICE_ACCOUNT_KEYe, no campo Valor, copie o conteúdo do arquivo projectid-hashcode.json que foi salvo. - Selecione o botão Salvar propriedades do script para salvar a nova propriedade.
Para mais informações sobre como criar chaves de conta de serviço, consulte a documentação Criar e excluir chaves de conta de serviço do Google Cloud.
Testar o projeto de complemento
Para testar o projeto do consultor do Apresentações, você precisa criar uma implantação de teste do código do complemento e instalá-la. Nesta configuração de teste, o projeto está disponível apenas no arquivo do Apresentações Google em que você iniciou o projeto do complemento do Apps Script e nenhuma outra apresentação do Apresentações. Saiba como implantar seu complemento para uso mais amplo no tópico Criar e gerenciar implantações da documentação do Apps Script do Google Workspace.
Para implantar e testar o código do projeto do Apps Script:
- Na parte superior da interface da Web do Apps Script, selecione Implantar > Testar implantações.
- Na caixa de diálogo Testar implantações, ao lado de Selecionar tipo, selecione o ícone de engrenagem e Complemento do Google Workspace.
- Ao lado de Application(s): título do Slides, selecione o botão Install.
- Mantenha as configurações padrão de Testar o código mais recente e selecione Concluído.
- Navegue pela apresentação do Apresentações Google conectada ao seu projeto do Apps Script e atualize a página da Web.
- No canto inferior direito do app Apresentações da Web, selecione o ícone ( < ) para abrir o painel lateral e, em seguida, selecione o ícone de olho preto e branco para abrir o Supervisor do Apresentações.
Depois de concluir essa etapa e executar o complemento, você poderá fazer modificações para usar diretrizes diferentes ou seguir um fluxo de trabalho diferente. Consulte as próximas seções para saber como fazer algumas modificações básicas no complemento do consultor do Apresentações.
Modificar o comportamento da avaliação
Você pode alterar o comportamento de revisão do consultor do Apresentações, tanto em termos de qual saída da API Gemini quanto na interface do usuário fornecida pelo complemento modificando o código do projeto. O foco deste tutorial é alterar as instruções de solicitação para modificar o comportamento de revisão do slide da apresentação. Para mais informações sobre como estender a interface do usuário do Apresentações Google usando o Apps Script, consulte Estender o Apresentações Google.
Mudar diretrizes de revisão
O consultor do Apresentações vem programado com um conjunto básico de diretrizes de revisão de slides com categorias de simplicidade, cor e tipografia, estrutura e espaços em branco, além de gráficos e ícones. As diretrizes de revisão são apenas instruções em texto incluídas em um comando pela API Gemini, com um snapshot de um slide selecionado e as anotações do apresentador.
Para mudar o comportamento de revisão do complemento, altere as instruções em texto. Por exemplo, é possível instruir o modelo do Gemini a gerar a avaliação com a classificação na mesma linha que o título da categoria ou alterar o nome de uma categoria.
Para alterar o local de avaliação da categoria e o nome de uma categoria:
- Abra a interface da Web do Apps Script que contém o projeto My Slides Advisor. Se necessário, navegue até a janela do projeto abrindo a apresentação do Apresentações Google que contém o projeto do Apps Script e selecionando Extensões > Apps Script.
- No menu lateral à esquerda, selecione a visualização < > Editor e depois o nome de arquivo ai.gs.
- No arquivo de código ai.gs, localize a constante de string
SYSTEM_PROMPTe modifique as instruções da seguinte maneira, com o texto em negrito:const SYSTEM_PROMPT = ` ... For each of the following categories evaluate the given slide. Score each category on a scale of 0 to 100, show the score next to the category heading, and concisely explain the reasoning. Do not suggest improvements if the score is 80 or above.
- Na mesma constante de string
SYSTEM_PROMPT, mude o texto da categoriaSimplicityparaMessage:const SYSTEM_PROMPT = ` ... * Message -- Slides should focus on one main idea per slide and ...
- Salve as mudanças no arquivo de código ai.gs.
- Navegue pela apresentação do Apresentações Google conectada ao seu projeto do Apps Script, atualize a página da Web e execute novamente as alterações do complemento para testar as alterações.
Se você ainda não configurou uma implantação de teste para o complemento do consultor do Apresentações, siga as instruções em Testar o projeto de complemento.
Você pode remover, substituir ou reescrever as instruções da categoria da avaliação na constante de string SYSTEM_PROMPT para corresponder aos requisitos da avaliação. Se você quiser testar diferentes abordagens de revisão ou reescrever todo o prompt de revisão, confira o aplicativo da Web Google AI Studio. Esse app permite prototipar, testar e salvar comandos para o Gemini em uma
interface conveniente e usa a mesma API Gemini que o projeto
do consultor do Apresentações. Para mais informações sobre como usar o AI Studio, consulte o Guia de início rápido do AI Studio.
Alterar a configuração do comportamento do modelo
A API Gemini fornece várias configurações para alterar a operação geral do modelo em resposta a um prompt de solicitação. A configuração de temperatura do modelo permite definir a variação permitida do modelo em uma resposta, sendo 0 o menor e 1 o mais alto. Definir esse valor como 0,1 produz respostas muito consistentes, mas esse comportamento pode parecer repetitivo e menos útil para os usuários que recebem feedback de avaliações. Considere definir o valor da temperatura como mais alto e tenha em mente que, quanto maior a temperatura, mais inconsistentes serão seus resultados, o que pode incluir a implementação de instruções de outra forma e até mesmo a ignorar completamente algumas delas.
Para aumentar a temperatura das respostas às avaliações, faça o seguinte:
- Abra a interface da Web do Apps Script que contém o projeto My Slides Advisor.
- No menu lateral à esquerda, selecione a visualização < > Editor e depois o nome de arquivo ai.gs.
No arquivo de código ai.gs, localize a função
analyzeSlides()e modifique a constantegenerationConfigdefinindo o valor detemperaturecomo0.3:function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };Salve as mudanças no arquivo de código ai.gs.
Navegue pela apresentação do Apresentações Google conectada ao seu projeto do Apps Script, atualize a página da Web e execute novamente as alterações do complemento para testar as alterações.
Para mais informações sobre as configurações de comportamento do modelo, consulte a documentação
da API Gemini para
GenerationConfig.
Outros recursos
Para mais informações sobre o projeto do Slides Advisor, consulte o repositório de códigos. Se você precisar de ajuda para criar o app ou quiser colaborar com outros desenvolvedores, confira o servidor da Comunidade de desenvolvedores do Google no Discord. Para mais projetos do Build with Google AI, confira a playlist de vídeos.