Crea un revisore di slide IA con Gemini

Assembla, esegui e personalizza un componente aggiuntivo del revisore di slide per Google Workspace Diapositive con questo progetto di codice. Che tu faccia una presentazione alla settimana o uno all'anno, la maggior parte di noi potrebbe avere bisogno di un aiuto per compierli nel modo giusto. Vuoi mettere troppo spesso in una slide? Magari ti dimentichi di interrompere la presentazione con le immagini? Potresti anche avere una serie di linee guida della tua organizzazione per creare presentazioni efficaci. Li hai letti di recente?

Il consulente Presentazioni progetto è un componente aggiuntivo di Google Workspace open source che utilizza di intelligenza artificiale (IA) per esaminare e fornire feedback sulle tue presentazioni, ogni volta che ne hai bisogno. Il progetto utilizza l'immagine e il testo dell'API Gemini di Google funzionalità di elaborazione per analizzare le presentazioni Google in base a una serie di linee guida e ti mostra come stai andando in base a queste linee guida. Inoltre, puoi personalizzare queste linee guida per seguire i consigli della tua organizzazione; ti ricordano di migliorare le presentazioni in base alle regole che definisci per te.

Per una panoramica video del progetto e di come estenderlo, inclusi approfondimenti da chi lo crea, dai un'occhiata al Revisore di slide IA - Crea con Google per l'IA. Altrimenti, puoi iniziare a estendere del progetto seguendo queste istruzioni.

Componente aggiuntivo Presentazioni Advisor in esecuzione come barra laterale per Presentazioni Google Figura 1. Componente aggiuntivo Presentazioni Google per Presentazioni Google in esecuzione come riquadro nella barra laterale.

Configurazione del progetto

Queste istruzioni illustrano come configurare il progetto Consulente Presentazioni per lo sviluppo e il test. I passaggi generali della creazione di Google Apps Progetto di script, configurazione di un progetto Google Cloud per l'accesso API e impostazione alcune proprietà degli script per il progetto.

Crea progetto Apps Script

Questo progetto Advisor di Presentazioni viene eseguito come Componente aggiuntivo per Presentazioni Google. Hai configurato il progetto utilizzando l'interfaccia web di Presentazioni Google e creare un progetto Apps Script per il codice.

Per creare un nuovo progetto Apps Script:

  1. Vai all'app web Presentazioni per Google per Google Workspace.
  2. Apri una presentazione esistente o creane una nuova.
  3. Nella presentazione, seleziona Estensioni > Apps Script.

Una volta completati questi passaggi, dovresti avere un nuovo Progetto senza titolo in l'interfaccia utente web di Apps Script, allegata alla presentazione da dove hai iniziato. Assegna un nome al progetto per renderlo più facile da trovare.

Per assegnare un nome al progetto Apps Script:

  1. Nell'interfaccia web di Apps Script, seleziona il testo Progetto senza titolo.
  2. Nella finestra di dialogo Rinomina progetto, digita: My Slides Advisor, quindi seleziona Rinomina.

prepara i file di progetto

Il progetto consulente di Presentazioni ha 5 file di codice che devi configurare prima di poter copiare il codice nel tuo nuovo progetto Apps Script. Questa sezione descrive come preparare il progetto e ottenere il codice.

Per preparare i file di progetto:

  1. Apri l'interfaccia web di Apps Script contenente Il mio consulente di Presentazioni progetto.
  2. Nel menu laterale a sinistra seleziona < &gt; Visualizzazione editor.
  3. Rinomina il file Code.gs in main.gs passando il mouse sopra la Nome del file di codice Code.gs, selezionando Rinomina dal menu contestuale. entra in main. L'interfaccia aggiunge automaticamente l'estensione .gs.
  4. Per rendere visibile il file manifest appscript.json del progetto, seleziona sull'icona a forma di ingranaggio (Impostazioni progetto) nel menu laterale a sinistra e attivare l'opzione Mostra "appscript.json" del file manifest.
  5. Nell'interfaccia web di Apps Script, nel menu laterale a sinistra, seleziona < &gt; Visualizzazione editor.
  6. Crea un file di codice ui.gs selezionando l'icona + (più) a destra dell'intestazione File, selezionando Script e inserendo ui.
  7. Ripeti il passaggio precedente per creare le slides.gs e le ai.gs. di codice sorgente.

Il tuo progetto Apps Script ora dovrebbe contenere i cinque file di codice seguenti, sono per lo più vuote:

  • appscript.json
  • main.gs
  • ui.gs
  • slides.gs
  • ai.gs

Per il passaggio successivo, recupera il codice del progetto dal repository e copialo nel tuo progetto Apps Script.

Recupera il codice del progetto

Il codice del progetto Slide Advisor è ospitato in un repository di codice. Tu devi copiare quel codice nel tuo progetto Apps Script per utilizzarlo. Questo viene descritto come ottenere il codice del progetto.

Per ottenere il codice del progetto:

  1. Accedi al repository di codice del progetto per trovare il file manifest del progetto appsscript.json
  2. Copia il contenuto di questo file di codice negli appunti.
  3. Torna all'interfaccia web di Apps Script, seleziona appsscript.json e incolla il codice nell'editor di codice sostituendo eventuale codice precedente.
  4. Ripeti questa procedura per gli altri quattro file di codice:

Collega progetto Google Cloud

Questo progetto utilizza un progetto Google Cloud per accedere ai modelli di Gemini AI. Google Cloud offre una specifica privacy dei dati di sicurezza, nonché una serie di servizi software utili per la creazione applicazioni come Presentazioni Google. Collega il codice del componente aggiuntivo all'API Gemini creando un progetto Cloud con accesso all'API IA, creando un account di servizio il progetto, creando una chiave per l'account di servizio e installandola il tuo progetto aggiuntivo.

configura un progetto Cloud

Il progetto Cloud che utilizzi per connetterti all'API Gemini deve avere il ruolo Vertex AI servizio API abilitato e dovrai creare una connessione autenticata il componente aggiuntivo Presentazioni Google a questo progetto. L'API Vertex AI richiede inoltre abilitare la fatturazione mensile nei progetti in cui la utilizzi.

Per configurare un progetto Cloud con accesso all'API Vertex AI:

  1. Vai alla console Google Cloud. ed eseguire l'accesso, se necessario.
  2. Nella console Google Cloud, seleziona un progetto Cloud esistente oppure creane uno nuovo.
  3. Nella console Pagina Dashboard di del tuo progetto, nel riquadro API seleziona Vai alla panoramica delle API oppure vai all'indirizzo https://console.cloud.google.com/apis/.
  4. Nella parte superiore della pagina API e servizi, seleziona + ABILITA API E SERVIZI.
  5. Nella pagina Libreria API, cerca vertex ai api, seleziona API Vertex AI e quindi seleziona il pulsante Abilita.
  6. Se non è già attiva, devi abilitare la fatturazione per il tuo account Google Cloud progetto e poi abilitare l'API AI selezionando il pulsante Abilita pagina della console API Vertex AI.
  7. Per verificare che l'API Vertex AI sia abilitata, vai alla sezione API e servizi per del progetto. Ora dovresti vedere l'API Vertex AI elencata in questa pagina.

Crea un account di servizio

Il componente aggiuntivo Presentazioni Advisor richiede una connessione autenticata al tuo Cloud per accedere all'API Vertex AI e ai modelli Gemini. Sei tu a creare di connessione generando prima un account di servizio nel tuo progetto Cloud che ha accesso all'API Vertex AI. Il consulente di Presentazioni si connette usando questo account di servizio.

Per creare un account di servizio per il componente aggiuntivo Presentazioni Google:

  1. Nella console Google Cloud, vai alla API e servizi per il tuo progetto Cloud.
  2. Nella parte sinistra della pagina, seleziona Credenziali.
  3. Nella parte superiore della pagina, seleziona + CREA CREDENZIALI > Account di servizio.
  4. Nella pagina Crea account di servizio, vai a Dettagli account di servizio inserisci un nome, un ID e una descrizione per l'account di servizio.
  5. Crea l'account di servizio selezionando Crea e continua.
  6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, seleziona il controllo Ruolo.
  7. Nel campo Filtro, cerca e seleziona Utente Vertex AI set di autorizzazioni e seleziona Continua.
  8. Completa la creazione di questo account di servizio selezionando Fine.

Per ulteriori informazioni sulla creazione di account di servizio, consulta la documentazione Creare account di servizio documentazione.

Crea e installa la chiave dell'account di servizio

Il progetto Advisor di Presentazioni deve essere in grado di eseguire l'autenticazione nell'account di servizio creato nella procedura precedente. Puoi attivare l'autenticazione creando una chiave per l'account di servizio e configurandola in Presentazioni progetto Apps Script di consulenza come proprietà script. La seguente procedura spiega come creare e configurare la chiave nel progetto.

Per creare e configurare una chiave dell'account di servizio:

  1. Nella console Google Cloud, vai alla API e servizi per nel tuo progetto Cloud.
  2. Nella parte sinistra della pagina, seleziona Credenziali.
  3. Nella sezione Account di servizio, individua l'account di servizio creato, seleziona l'indirizzo email dell'account o l'icona a forma di matita per modificarlo.
  4. Nella finestra di modifica dell'account di servizio, nella parte superiore della pagina, seleziona titolo della scheda KEYS.
  5. Nella sezione Chiavi, seleziona Aggiungi chiave > Crea nuova chiave.
  6. Nella finestra di dialogo Crea chiave privata per..., seleziona JSON e poi Crea. Questo passaggio crea un file chiave denominato projectid-hashcode.json e lo scarica automaticamente sul tuo computer.
  7. Apri il file projectid-hashcode.json scaricato e copia i contenuti.
  8. Apri l'interfaccia web di Apps Script contenente Il mio consulente di Presentazioni progetto e, nel menu a sinistra, seleziona la visualizzazione Settings (Impostazioni).
  9. Nella sezione Proprietà script, seleziona Modifica script proprietà e poi sul pulsante Aggiungi proprietà script.
  10. Nel nuovo campo Proprietà, inserisci SERVICE_ACCOUNT_KEY e Value (Valore), copia i contenuti della scheda scaricata projectid-hashcode.json.
  11. Salva la nuova proprietà selezionando il pulsante Salva proprietà script.

Per saperne di più sulla creazione di chiavi degli account di servizio, consulta la documentazione di Google Cloud Creare ed eliminare le chiavi degli account di servizio documentazione.

Testa il progetto del componente aggiuntivo

Riquadro a slide di Google Workspace con l&#39;icona di un consulente di Presentazioni Il test del progetto Slide Advisor richiede la creazione di un deployment di prova del codice del componente aggiuntivo e installare il deployment di test. In questo test configurazione, il progetto è disponibile solo nella presentazione di Presentazioni Google in cui hai avviato il componente aggiuntivo di Apps Script nel progetto e in nessun'altra presentazione presentazioni. Puoi scoprire di più sul deployment del tuo componente aggiuntivo per un uso più ampio in la documentazione di Apps Script di Google Workspace, Creare e gestire i deployment per ogni argomento.

Per eseguire il deployment e il test del codice del progetto Apps Script:

  1. Nella parte superiore dell'interfaccia web di Apps Script, seleziona Deploy > Testa deployment.
  2. Nella finestra di dialogo Testa i deployment, accanto a Seleziona tipo, seleziona l'icona a forma di ingranaggio e il componente aggiuntivo di Google Workspace.
  3. Accanto ad Applicazioni: titolo slide, seleziona il pulsante Installa.
  4. Lascia invariate le impostazioni predefinite per Prova il codice più recente e seleziona Fine.
  5. Esplorare la presentazione Google collegata ad Apps Script progetto e ricarica la pagina web.
  6. Nell'angolo in basso a destra dell'app web Presentazioni, seleziona ( &lt;) per aprire il riquadro laterale, quindi seleziona l'icona a forma di occhio bianco e nero per apri il riquadro Presentazioni Presentazioni.

Dopo aver completato questo passaggio ed eseguito correttamente il componente aggiuntivo, puoi iniziare la modifica in modo che utilizzi linee guida diverse o che segua un flusso di lavoro diverso. Consulta le sezioni successive per istruzioni su come apportare alcune modifiche di base Componente aggiuntivo Presentazioni.

Modifica il comportamento della revisione

Puoi modificare il comportamento della revisione del consulente di Presentazioni, sia per quanto riguarda che ricevi dall'API Gemini e l'interfaccia utente fornita Componente aggiuntivo, modificando il codice del progetto. Questo tutorial è incentrato sulla modifica che richiedono istruzioni per modificare il comportamento di revisione delle slide della presentazione. Per ulteriori informazioni su come estendere l'interfaccia utente di Presentazioni Google utilizzando Apps Script, vedi Estensione di Presentazioni Google.

Modificare le linee guida relative alle recensioni

Il Consulente Presentazioni viene fornito con una serie di linee guida di base per la revisione delle slide con categorie di semplicità, colore e tipografia, struttura e spazio vuoto, grafiche e icone. Le linee guida per la revisione sono solo istruzioni testuali incluse in un prompt tramite l'API Gemini, insieme a un'immagine snapshot di un slide selezionata e le eventuali note del relatore.

Puoi modificare il comportamento della revisione del componente aggiuntivo modificando il testo istruzioni. Ad esempio, puoi indicare al modello Gemini di restituire il valore revisione con la valutazione della categoria sulla stessa riga dell'intestazione della categoria, oppure modificare il nome di una categoria.

Per modificare il nome e la località della valutazione della categoria:

  1. Apri l'interfaccia web di Apps Script contenente Il mio consulente di Presentazioni progetto. Se necessario, vai alla finestra del progetto aprendo la finestra Presentazione di Presentazioni contenente il progetto Apps Script e selezione Estensioni > Apps Script.
  2. Nel menu laterale a sinistra, seleziona < &gt; Editor e poi seleziona ai.gs.
  3. Nel file di codice ai.gs, individua la costante stringa SYSTEM_PROMPT e modifica le istruzioni come segue con il testo in grassetto: 
    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.
  4. Nella stessa costante stringa SYSTEM_PROMPT, modifica Simplicity categoria testo a Message: 
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. Salva le modifiche apportate al file di codice ai.gs.
  6. Esplorare la presentazione Google collegata ad Apps Script progetto, ricarica la pagina web e testa le modifiche al componente aggiuntivo eseguendo di nuovo l'upgrade.

Se non hai ancora configurato un deployment di prova per il componente aggiuntivo Presentazioni segui le istruzioni in Testa il progetto del componente aggiuntivo.

Puoi rimuovere, sostituire o riscrivere le istruzioni relative alla categoria recensione nel Costante stringa SYSTEM_PROMPT per soddisfare i requisiti della revisione. Se vuoi provare diversi approcci ai prompt di revisione o riscrivere l'intera recensione consulta la pagina web di Google AI Studio un'applicazione. Questa app ti consente di prototipare, testare e salvare i prompt per Gemini in un un'interfaccia molto utile e usa la stessa API Gemini di Presentazioni progetto. Per ulteriori informazioni sull'utilizzo di AI Studio, consulta Guida rapida di AI Studio.

Modifica la configurazione del comportamento del modello

L'API Gemini fornisce diverse impostazioni per modificare il funzionamento generale del modello in risposta a un prompt. In particolare, la temperatura del modello consente di impostare la variazione consentita in un della risposta, dove zero rappresenta la più bassa e 1 la più alta. Impostazione di questo valore pari a 0,1 produce risposte molto coerenti, ma questo comportamento può sembrare ripetitivo e meno utile per gli utenti che ricevono feedback sulle recensioni. Valuta l'opportunità di impostare valore di temperatura più alto; tieni presente che più alta è la temperatura, più incoerenti possono essere i risultati, ad esempio l'implementazione istruzioni in modo diverso e anche ignorando completamente alcune istruzioni.

Per aumentare la temperatura per le risposte alle recensioni:

  1. Apri l'interfaccia web di Apps Script contenente Il mio consulente di Presentazioni progetto.
  2. Nel menu laterale a sinistra, seleziona < &gt; Editor e poi seleziona ai.gs.

  3. Nel file di codice ai.gs, individua la funzione analyzeSlides() e modifica la costante generationConfig impostando il valore temperature a 0.3:

    function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

  4. Salva le modifiche apportate al file di codice ai.gs.

  5. Esplorare la presentazione Google collegata ad Apps Script progetto, ricarica la pagina web e testa le modifiche al componente aggiuntivo eseguendo di nuovo l'upgrade.

Per maggiori informazioni sulle impostazioni di configurazione del comportamento del modello, consulta documentazione dell'API per GenerationConfig

Risorse aggiuntive

Per ulteriori informazioni sul progetto Presentazioni Advisor, consulta repository di codice. Se hai bisogno di aiuto per creare l'applicazione o vuoi collaborare con altri sviluppatori, dai un'occhiata Server di Discord della community di Google Developers. Per altri progetti di Build with Google AI, dai un'occhiata al playlist video.