Crie, execute e personalize um complemento de revisão de slides para o Google Workspace Slides com este projeto de código. Se você faz uma apresentação por semana ou um por ano, a maioria de nós precisaria de uma ajudinha a fazer tudo certo. Você tendem a colocar demais em um slide? Talvez você se esqueça de interromper sua apresentação com recursos visuais? Você pode até ter um conjunto de diretrizes de sua organização sobre apresentações eficazes. Você leu esses artigos recentemente?
Consultor do Apresentações é um complemento de código aberto do Google Workspace que usa de inteligência artificial (IA) para analisar e dar feedback sobre suas apresentações, sempre que precisar. O projeto usa imagem e texto da API Gemini do Google de processamento para analisar suas Apresentações Google em relação a um conjunto de diretrizes e informa como você está se saindo em relação a essas diretrizes. Melhor ainda, você pode personalizar essas diretrizes para seguir as recomendações da organização; ou lembrá-lo de melhorar suas apresentações com base em regras que você define para você mesmo.
Para um vídeo de visão geral do projeto e como estendê-lo, incluindo insights de quem o desenvolveu, confira o Avaliador de slides da IA - Criar com o Google IA generativa. Caso contrário, comece a ampliar o projeto seguindo as instruções abaixo.
Figura 1. Complemento do Slides Advisor para o Apresentações Google executado como um painel da barra lateral.
Configurar o projeto
Estas instruções ajudam você a configurar o projeto do Slides Advisor para desenvolvimento e testes. As etapas gerais são criar a conta do Google Apps projeto de script, configurar um projeto do Google Cloud para acesso à API e definir algumas propriedades de script para o projeto.
Criar um projeto do Apps Script
Este projeto do Slides Advisor é executado Complemento para Apresentações Google. Configure o projeto usando a interface da Web do Apresentações Google. criar um projeto do Apps Script para o código.
Para criar um novo projeto do Apps Script:
- Navegue até o app da Web Apresentações para Google Workspace.
- Abra uma apresentação já existente ou crie uma nova.
- Na sua apresentação, selecione Extensões > Apps Script.
Ao concluir essas etapas, você terá um novo Untitled project em a interface do usuário da Web do Apps Script, anexada à apresentação onde você começou. 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 "Renomear projeto", digite:
My Slides Advisore depois Selecione Renomear.
Preparar os arquivos do projeto
O projeto do Slides Advisor tem cinco arquivos de código, e você precisa configurá-los antes de copiar o código para seu novo projeto do Apps Script. Esta seção descreve como preparar o projeto e obter o código.
Para preparar os arquivos do projeto:
- Abra a interface da Web do Apps Script com o Consultor das minhas Apresentações. projeto.
- No menu lateral esquerdo, selecione o ícone < > Editor.
- Renomeie o arquivo Code.gs como main.gs passando o cursor sobre
Code.gs, selecionando Renomear no menu de contexto.
digite
main. A interface adiciona a extensão .gs automaticamente. - Torne visível o arquivo de manifesto appscript.json do projeto selecionando no ícone de engrenagem (Configurações do projeto) no menu lateral esquerdo e, em seguida, ative a configuração Show "appscript.json" arquivo de manifesto.
- Na interface da Web do Apps Script, no menu à esquerda, selecione a opção < > Editor.
- Crie um arquivo de código ui.gs selecionando o ícone + (mais) à direita
do cabeçalho Arquivos, selecionando Script e inserindo
ui. - Repita a etapa anterior para criar
slides.gseai.gs. arquivos de código.
Seu projeto do Apps Script agora precisa conter os cinco arquivos de código a seguir, que geralmente estão vazios:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
Para a próxima etapa, pegue o código do projeto no repositório e copie-o no seu projeto do Apps Script.
Acessar o código do projeto
O código do projeto do Slides Advisor está hospedado em um repositório de código. Você você precisa copiar esse código para seu projeto do Apps Script para trabalhar com ele. Isso descreve como obter 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 do projeto.
appsscript.json - Copie o conteúdo desse arquivo de código para a área de transferência.
- Volte para a interface da Web do Apps Script, selecione o appsscript.json e cole no editor de código. substituindo o código anterior.
- Repita esse 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. Google A nuvem oferece privacidade de dados bem como uma série de serviços de software úteis para a criação aplicativos, como o Slides Advisor. Você conecta o código do complemento à API Gemini criando um projeto do Cloud com acesso à API de IA, criando uma conta de serviço para projeto, criando uma chave para a conta de serviço e instalando essa chave seu projeto de complementos.
Configurar um projeto do Cloud
O projeto do Cloud que você usa para se conectar à API Gemini precisa ter a conta da serviço de API ativado e você precisará criar uma conexão autenticada a partir do o complemento Apresentações Advisor para este projeto. A API Vertex AI também exige que o faturamento seja ativado nos projetos em que for usado.
Para configurar um projeto do Cloud com acesso à API Vertex AI:
- Acesse o console do Google Cloud. e fazer login, se necessário.
- No console do Google Cloud, selecione um projeto do Cloud ou criar uma.
- No console Página Painel para seu projeto, no painel APIs, selecione Acessar visão geral das APIs ou acesse https://console.cloud.google.com/apis/.
- Na parte superior da página APIs e serviços, selecione + ATIVAR APIs E SERVIÇOS.
- Na página Biblioteca de APIs, procure por
vertex ai api, selecione o API Vertex AI e selecione o botão Ativar. - Se ainda não estiver ativo, ative o faturamento da sua conta do Google Cloud projeto e ative a API AI selecionando o botão Ativar no a página do console da API Vertex AI.
- Verifique se a API Vertex AI está ativada acessando o a página APIs e serviços para seu projeto. A API Vertex AI vai aparecer listada nesta página.
Criar uma conta de serviço
O complemento Slides Advisor requer uma conexão autenticada com o Cloud para acessar a API Vertex AI e os modelos Gemini. Você cria isso. de uma só vez gerando conta de serviço no projeto do Cloud que tem acesso à API Vertex AI. Consultor do Apresentações projeto se conecta usando essa conta de serviço.
Para criar uma conta de serviço para o complemento do supervisor do Apresentações Google:
- No console do Google Cloud, acesse APIs e serviços do seu 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, Detalhes da conta de serviço digite o nome, o ID e a descrição da conta de serviço.
- Selecione Criar e continuar para criar a conta de serviço.
- Na seção Conceda a essa conta de serviço acesso ao projeto, selecione o controle Papel.
- No campo Filtro, pesquise e selecione Usuário da Vertex AI. conjunto de permissões e selecione Continuar.
- Para concluir a criação dessa conta de serviço, selecione Concluído.
Para mais informações sobre como criar contas de serviço, consulte a documentação Criar contas de serviço na documentação do Google Cloud.
Criar e instalar a chave da conta de serviço
O projeto do Slides Advisor precisa ser autenticado na conta de serviço. que você criou no procedimento anterior. Para ativar essa autenticação, crie uma chave para a conta de serviço e configure essa chave nos seus slides do Google Apps Script como uma propriedade de script. O procedimento a seguir explica como criar a chave e configurá-la no seu projeto.
Para criar e configurar uma chave de conta de serviço:
- No console do Google Cloud, acesse a página APIs e serviços para 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 criada, selecione o endereço de e-mail da conta ou o ícone de lápis para editá-la.
- Na janela de edição da conta de serviço, na parte de cima da página, selecione no título da guia KEYS.
- 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 faz o download automático para seu computador.
- Abra o arquivo projectid-hashcode.json transferido por download e copie o conteúdo.
- Abra a interface da Web do Apps Script com o Consultor das minhas Apresentações. projeto e, no menu lateral esquerdo, selecione a visualização Configurações.
- Na seção Script Properties, selecione a opção Editar script propriedades e depois no botão Adicionar propriedade de script.
- No novo campo Propriedade, insira
SERVICE_ACCOUNT_KEYe, no Valor, copie o conteúdo dos arquivos projectid-hashcode.json. - Para salvar a nova propriedade, selecione o botão Salvar propriedades do script.
Para mais informações sobre como criar chaves de contas de serviço, consulte a documentação Criar e excluir chaves de contas de serviço na documentação do Google Cloud.
Testar o projeto de complemento
Para testar o projeto do Slides Advisor, é preciso criar uma implantação de teste
do código do complemento e instale essa implantação de teste. Neste teste,
do projeto, o projeto estará disponível apenas no arquivo do Apresentações Google
em que iniciou o projeto de complemento do Apps Script e nenhuma outra apresentação
apresentações. Saiba mais sobre como implantar seu complemento para uso mais amplo em
a documentação do Apps Script do Google Workspace,
Criar e gerenciar implantações
tópico.
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 as opções ícone de engrenagem e Complemento do Google Workspace.
- Ao lado de Application(s): Slides title, selecione o botão Install.
- Mantenha as configurações padrão de Testar o código mais recente e selecione Concluído.
- Navegar pela apresentação do Apresentações Google conectada ao seu Apps Script e atualize a página da Web.
- No canto inferior direito do aplicativo da Web Apresentações, selecione o ( < ) para abrir o painel lateral, selecione o ícone de olho preto e branco para abra o painel Supervisor de Apresentações.
Depois de concluir esta etapa e executar o complemento, você poderá modificá-la para usar diretrizes diferentes ou seguir um fluxo de trabalho diferente. Consulte a próximas seções para obter instruções sobre como fazer algumas modificações básicas no Complemento do Apresentações Google.
Modificar o comportamento da avaliação
Você pode alterar o comportamento de revisão do supervisor do Apresentações, tanto em termos do que que você recebe da API Gemini e a interface do usuário fornecida pela Add-on, modificando o código do projeto. O foco deste tutorial é alterar solicitar instruções para modificar o comportamento da revisão de slides de apresentação. Para mais informações sobre como estender a interface do usuário das Apresentações Google usando o Apps Script, ver Estender as Apresentações Google.
Mudar as diretrizes de avaliação
O Slides Advisor é programado com um conjunto básico de diretrizes para revisão de slides com categorias para simplicidade, cor e tipografia, estrutura e espaço em branco, imagens e ícones. As diretrizes de avaliações são apenas instruções de texto incluída em um comando pela API Gemini, junto com um snapshot de um slide selecionado e as anotações do apresentador.
Você pode alterar o comportamento da avaliação do complemento alterando o texto instruções. Por exemplo, é possível instruir o modelo Gemini a gerar a saída com a classificação da categoria na mesma linha do título da categoria ou alterar o nome de uma categoria.
Para alterar o local e o nome de uma categoria, faça o seguinte:
- Abra a interface da Web do Apps Script com o Consultor das minhas Apresentações. projeto. Se necessário, navegue até a janela do projeto abrindo o aplicativo apresentação de slides contendo o projeto do Apps Script e selecionando Extensões > Apps Script.
- No menu lateral esquerdo, selecione o ícone < > Editor e selecione ai.gs.
- No arquivo de código ai.gs, localize a constante de string
SYSTEM_PROMPT. e modifique as instruções da seguinte forma 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 aSimplicity. texto da categoria paraMessage: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.
- Navegar pela apresentação do Apresentações Google conectada ao seu Apps Script projeto, recarregue a página da web e teste as alterações no complemento executá-lo novamente.
Se você ainda não configurou uma implantação de teste para o complemento Slides Advisor, siga as instruções Teste o projeto de complemento.
Você pode remover, substituir ou reescrever as instruções da categoria das avaliações no
Constante de string SYSTEM_PROMPT para corresponder aos requisitos da avaliação. Se você quiser
para testar diferentes abordagens de revisão ou reescrever toda a avaliação
acesse o site do Google AI Studio
para o aplicativo. Com esse app, é possível criar protótipos, testar e salvar comandos para o Gemini em um
interface simples e fácil de usar e usa a mesma API Gemini do app Slides Advisor.
projeto. Para mais informações sobre como usar o AI Studio, consulte a
Guia de início rápido do AI Studio.
Mudar a configuração do comportamento do modelo
A API Gemini oferece várias configurações para mudar o funcionamento geral o modelo em resposta a um comando de solicitação. Especificamente, a temperature configuração do modelo permite definir quanta variação o modelo é permitido em um sendo que 0 é a menor e 1 a mais alta. Definir esse valor de 0,1 produz respostas muito consistentes, mas esse comportamento pode parecer repetitivo e menos úteis para os usuários que recebem feedback de avaliações. Considere definir o um valor de temperatura mais alto e lembre-se de que quanto maior a temperatura, mais inconsistentes podem ser os resultados, o que pode incluir a implementação as instruções de maneira diferente, podendo até mesmo ignorar algumas delas.
Para aumentar a temperatura para respostas às avaliações, faça o seguinte:
- Abra a interface da Web do Apps Script com o Consultor das minhas Apresentações. projeto.
- No menu lateral esquerdo, selecione o ícone < > Editor e selecione ai.gs.
No arquivo de código ai.gs, localize a função
analyzeSlides()e modifique a constantegenerationConfigdefinindo o valortemperaturepara0.3:function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };Salve as mudanças no arquivo de código ai.gs.
Navegar pela apresentação do Apresentações Google conectada ao seu Apps Script projeto, recarregue a página da web e teste as alterações no complemento executá-lo novamente.
Para mais informações sobre as configurações de comportamento do modelo, consulte o
Documentação da API para
GenerationConfig
Outros recursos
Para mais informações sobre o projeto de Consultor do Apresentações, consulte a repositório de códigos (link em inglês). Se você precisar de ajuda para criar o aplicativo ou quiser colaborar com outros desenvolvedores, confira a Servidor do Discord da comunidade do Google Developers. Para mais projetos do Build with Google AI, confira a playlist de vídeos.