Dai un'occhiata al nuovo Cookbook dell'API Gemini e al nostro forum della community.

Questa pagina è stata tradotta dall'API Cloud Translation.

Crea un revisore di slide IA con Gemini

Assembla, esegui e personalizza un componente aggiuntivo del revisore di slide per Presentazioni di Google Workspace con questo progetto di codice. Che si tratti di una presentazione alla settimana o una all'anno, molti di noi potrebbero avere bisogno di un po' di aiuto. Tendi a inserire troppi elementi in una slide? Magari ti dimentichi di suddividere la presentazione con gli elementi visivi? Potresti anche disporre di una serie di linee guida della tua organizzazione per le presentazioni efficaci. Li avete letti di recente?

Il progetto Presentazioni Advisor è un componente aggiuntivo di Google Workspace open source che utilizza la tecnologia di intelligenza artificiale (IA) per rivedere e fornire feedback sulle tue presentazioni, ogni volta che ne hai bisogno. Il progetto utilizza le funzionalità di elaborazione di immagini e testo dell'API Gemini di Google per analizzare le tue diapositive Google in base a una serie di linee guida e ti consente di conoscere le tue prestazioni rispetto a quelle linee guida. Meglio ancora, puoi personalizzare queste linee guida in modo da seguire i consigli della tua organizzazione o ricordarti di migliorare le presentazioni in base a regole che hai definito personalmente.

Per una panoramica video del progetto e di come estenderlo, inclusi approfondimenti dalle persone che lo hanno creato, dai un'occhiata al revisore di diapositive IA - Creare con l'IA di Google. Altrimenti, puoi iniziare a estendere il progetto seguendo le istruzioni.

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

Configurazione del progetto

Queste istruzioni illustrano come configurare il progetto Consulente in Presentazioni per lo sviluppo e i test. I passaggi generali prevedono la creazione del progetto Google Apps Script, l'impostazione di un progetto Google Cloud per l'accesso API e l'impostazione di alcune proprietà Script per il progetto.

Crea progetto Apps Script

Questo progetto consulente di Presentazioni viene eseguito come componente aggiuntivo per Presentazioni Google. Puoi configurare 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:

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

Una volta completati questi passaggi, dovresti visualizzare un nuovo progetto senza titolo nell'interfaccia utente web di Apps Script, allegata alla presentazione da cui hai iniziato. Assegna un nome al progetto per trovarlo più facilmente.

Per assegnare un nome al progetto Apps Script:

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

prepara i file di progetto

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

Per preparare i file di progetto:

Apri l'interfaccia web di Apps Script contenente il progetto Il mio consulente per Presentazioni.
Nel menu laterale a sinistra, seleziona la visualizzazione < > Editor.
Rinomina il file Code.gs in Code.gs passando il mouse sopra il nome file del codice Code.gs, selezionando Code.gs dal menu contestuale e inserendo Code.gs. L'interfaccia aggiunge automaticamente l'estensione .gs.
Rendi visibile il file manifest appscript.json del progetto selezionando l'icona a forma di ingranaggio (Impostazioni progetto) nel menu laterale a sinistra, quindi attivando l'opzione Mostra file manifest "appscript.json".
Nel menu laterale a sinistra dell'interfaccia web di Apps Script, seleziona la visualizzazione < > Editor.
Crea un file di codice ui.gs selezionando l'icona + (più) a destra dell'intestazione File, selezionando Script e inserendo ui.
Ripeti il passaggio precedente per creare i file di codice slides.gs e ai.gs.

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

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 Presentazioni Advisor è ospitato in un repository di codice. Devi copiare quel codice nel tuo progetto Apps Script per utilizzarlo. Questa sezione descrive come ottenere il codice del progetto.

Per ottenere il codice del progetto:

Vai al repository di codice del progetto per il file manifest del progetto, appsscript.json
Copia i contenuti di questo file di codice negli appunti.
Torna all'interfaccia web di Apps Script, seleziona il nome del file appsscript.json e incolla il codice nel riquadro dell'editor di codice, sostituendo l'eventuale codice precedente.
Ripeti questa procedura per gli altri quattro file di codice:
- Copia il codice main.js nel file main.gs.
- Copia il codice ui.js nel file ui.gs.
- Copia il codice slides.js nel file slides.gs.
- Copia il codice ai.js nel file ai.gs.

Collega progetto Google Cloud

Questo progetto utilizza un progetto Google Cloud per accedere ai modelli AI Gemini. Google Cloud fornisce norme specifiche per la privacy dei dati, oltre a una serie di servizi software utili per la creazione di applicazioni come Presentazioni Advisor. Puoi connettere il codice del componente aggiuntivo all'API Gemini creando un progetto Cloud con accesso all'API AI, creando un account di servizio per il progetto, creando una chiave per l'account di servizio e installando quella chiave nel progetto del componente aggiuntivo.

Configura un progetto Cloud

Nel progetto Cloud che utilizzi per connetterti all'API Gemini deve essere abilitato il servizio API Vertex AI e dovrai creare una connessione autenticata dal componente aggiuntivo di Presentazioni Advisor a questo progetto. L'API Vertex AI richiede anche di abilitare la fatturazione nei progetti in cui la utilizzi.

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

Vai alla console Google Cloud ed esegui l'accesso, se necessario.
Nella console Google Cloud, seleziona un progetto Cloud esistente o creane uno nuovo.
Nella pagina Dashboard della console per il tuo progetto, nel riquadro API, seleziona Vai alla panoramica API o vai a https://console.cloud.google.com/apis/.
Nella parte superiore della pagina API e servizi, seleziona + ABILITA API E SERVIZI.
Nella pagina Libreria API, cerca vertex ai api, seleziona l'opzione API Vertex AI e seleziona il pulsante Abilita.
Se non è già attiva, devi abilitare la fatturazione per il tuo progetto Google Cloud, quindi abilitare l'API AI selezionando il pulsante Abilita nella pagina della console dell'API Vertex AI.
Per verificare che l'API Vertex AI sia abilitata, vai alla pagina API e servizi del tuo progetto. Ora dovresti vedere l'elenco di API Vertex AI in questa pagina.

Crea un account di servizio

Il componente aggiuntivo Presentazioni Advisor richiede una connessione autenticata al progetto Cloud per accedere all'API Vertex AI e ai modelli Gemini. Per creare questa connessione, devi prima generare un account di servizio nel progetto Cloud che ha accesso all'API Vertex AI. Il progetto Presentazioni Advisor si connette utilizzando questo account di servizio.

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

Nella console Google Cloud, vai alla pagina API e servizi del tuo progetto Cloud.
Sul lato sinistro della pagina, seleziona Credenziali.
Nella parte superiore della pagina, seleziona + CREA CREDENZIALI > Account di servizio.
Nella sezione Dettagli account di servizio della pagina Crea account di servizio, inserisci il nome, l'ID e la descrizione dell'account di servizio.
Crea l'account di servizio selezionando Crea e continua.
Nella sezione Concedi a questo account di servizio l'accesso al progetto, seleziona il controllo Ruolo.
Nel campo Filtro, cerca l'insieme di autorizzazioni Utente Vertex AI e seleziona Continua.
Completa la creazione di questo account di servizio selezionando Fine.

Per ulteriori informazioni sulla creazione di account di servizio, consulta la documentazione di Google Cloud Creazione di account di servizio.

Crea e installa la chiave dell'account di servizio

Il progetto Presentazioni Advisor deve essere in grado di eseguire l'autenticazione con l'account di servizio creato nella procedura precedente. Puoi attivare questa autenticazione creando una chiave per l'account di servizio e configurando quella chiave nel progetto Apps Script di Presentazioni Advisor come proprietà Script. La procedura seguente spiega come creare la chiave e configurarla nel progetto.

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

Nella console Google Cloud, vai alla pagina API e servizi del tuo progetto Cloud.
Sul lato sinistro della pagina, seleziona Credenziali.
Nella sezione Account di servizio, individua l'account di servizio che hai creato, seleziona l'indirizzo email dell'account o l'icona a forma di matita per modificarlo.
Nella finestra di modifica dell'account di servizio, nella parte superiore della pagina, seleziona il titolo della scheda CHIAVE.
Nella sezione Chiavi, seleziona Aggiungi chiave > Crea nuova chiave.
Nella finestra di dialogo Crea chiave privata per..., seleziona JSON, quindi Crea. Questo passaggio crea un file chiave denominato projectid-hashcode.json e lo scarica automaticamente sul computer.
Apri il file projectid-hashcode.json scaricato e copia i contenuti.
Apri l'interfaccia web di Apps Script contenente il progetto Il mio consulente in Presentazioni e seleziona la visualizzazione Impostazioni nel menu a sinistra.
Nella sezione Proprietà script, seleziona il pulsante Modifica proprietà dello script e poi il pulsante Aggiungi proprietà script.
Nel nuovo campo Proprietà, inserisci SERVICE_ACCOUNT_KEY e, nel campo Valore, copia il contenuto del file projectid-hashcode.json scaricato.
Salva la nuova proprietà selezionando il pulsante Salva proprietà script.

Per ulteriori informazioni sulla creazione di chiavi degli account di servizio, consulta la documentazione di Google Cloud Creazione ed eliminazione delle chiavi degli account di servizio.

Testare il progetto del componente aggiuntivo

Riquadro slide di Google Workspace con l'icona di Presentazioni Advisor Il test del progetto Presentazioni Advisor richiede la creazione di un deployment di prova del codice del componente aggiuntivo e l'installazione di quel deployment di test. In questa configurazione di test, il progetto è disponibile solo nella presentazione Google in cui hai avviato l'aggiunta di Apps Script sul progetto e in nessuna altra presentazione di Presentazioni. Per saperne di più sul deployment del componente aggiuntivo per un utilizzo più ampio, consulta la documentazione di Google Workspace su Apps Script, nell'argomento Creare e gestire i deployment.

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

Nella parte superiore dell'interfaccia web di Apps Script, seleziona Deployment > Test deployment.
Nella finestra di dialogo Testa i deployment, accanto a Seleziona tipo, seleziona l'icona a forma di ingranaggio e Componente aggiuntivo di Google Workspace.
Accanto ad Applicazione/i: titolo Presentazioni, seleziona il pulsante Installa.
Lascia invariate le impostazioni predefinite per Testa l'ultimo codice e seleziona Fine.
Esplora la presentazione Google collegata al tuo progetto Apps Script e ricarica la pagina web.
Nell'angolo in basso a destra dell'app web Presentazioni, seleziona l'icona ( <) per aprire il riquadro laterale, quindi seleziona l'icona a forma di occhio bianco e nero per aprire il riquadro Consulente di Presentazioni.

Dopo aver completato questo passaggio ed eseguito correttamente il componente aggiuntivo, puoi iniziare a modificarlo in modo da utilizzare linee guida diverse o seguire un flusso di lavoro diverso. Consulta le sezioni successive per istruzioni su come apportare alcune modifiche di base al componente aggiuntivo di Presentazioni Advisor.

Modifica il comportamento della recensione

Puoi modificare il comportamento di revisione di Presentazioni Advisor, sia in termini di output che ottieni dall'API Gemini e dell'interfaccia utente fornita dal componente aggiuntivo, modificando il codice di progetto. Questo tutorial spiega come modificare le istruzioni di richiesta per modificare il comportamento della revisione delle slide della presentazione. Per ulteriori informazioni su come estendere l'interfaccia utente di Presentazioni Google utilizzando Apps Script, consulta Estensione di Presentazioni Google.

Linee guida per la revisione delle modifiche

Il consulente per le slide è programmato con un insieme di base di linee guida per la revisione delle slide con categorie relative a semplicità, colore e tipografia, struttura e spazi vuoti, grafica e icone. Le linee guida di revisione sono solo istruzioni di testo incluse in un prompt tramite l'API Gemini, insieme a un'immagine istantanea di una slide selezionata e alle note del relatore.

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

Per modificare la posizione di valutazione della categoria e il nome di una categoria:

Apri l'interfaccia web di Apps Script contenente il progetto Il mio consulente per Presentazioni. Se necessario, vai alla finestra del progetto aprendo la presentazione di Presentazioni Google contenente il progetto Apps Script e selezionando Estensioni > Apps Script.
Nel menu laterale a sinistra, seleziona la visualizzazione < > Editor, quindi seleziona il nome file ai.gs.

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.

Nella stessa costante stringa SYSTEM_PROMPT, modifica il testo della categoria Simplicity in Message:

const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...

Salva le modifiche apportate al file di codice ai.gs.
Naviga nella presentazione Google relativa al tuo progetto Apps Script, ricarica la pagina web e prova le modifiche al componente aggiuntivo eseguendolo di nuovo.

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

Puoi rimuovere, sostituire o riscrivere le istruzioni per la categoria di recensione nella costante di stringa SYSTEM_PROMPT in base ai tuoi requisiti di revisione. Se vuoi provare diversi approcci per le richieste di recensione o riscrivere l'intera richiesta di recensione, accedi all'applicazione web Google AI Studio. Questa app consente di prototipare, testare e salvare i prompt per Gemini in una comoda interfaccia e utilizza la stessa API Gemini del progetto Presentazioni Advisor. Per ulteriori informazioni sull'uso di AI Studio, consulta la guida rapida di AI Studio.

Modifica la configurazione del comportamento del modello

L'API Gemini offre diverse impostazioni per modificare il funzionamento generale del modello in risposta a una richiesta di richiesta. In particolare, l'impostazione della temperatura per il modello consente di impostare la variazione che il modello è consentita in una risposta, dove zero corrisponde al valore più basso e 1 al valore più alto. L'impostazione di questo valore su 0,1 produce risposte molto coerenti, ma questo comportamento può sembrare ripetitivo e meno utile per gli utenti che ricevono feedback sulle recensioni. Valuta la possibilità di impostare un valore della temperatura più alto e tieni presente che più alta è la temperatura, più incoerenti potrebbero essere i risultati, il che potrebbe includere istruzioni diverse per l'implementazione e persino ignorare completamente alcune istruzioni.

Per aumentare la temperatura per le risposte alle recensioni:

Apri l'interfaccia web di Apps Script contenente il progetto Il mio consulente per Presentazioni.
Nel menu laterale a sinistra, seleziona la visualizzazione < > Editor, quindi seleziona il nome file ai.gs.
Nel file di codice ai.gs, individua la funzione analyzeSlides() e modifica la costante generationConfig impostando il valore temperature su 0.3:
```
function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };
```
Salva le modifiche apportate al file di codice ai.gs.
Naviga nella presentazione Google relativa al tuo progetto Apps Script, ricarica la pagina web e prova le modifiche al componente aggiuntivo eseguendolo di nuovo.

Per saperne di più sulle impostazioni di configurazione del comportamento dei modelli, consulta la documentazione dell'API Gemini per GenerationConfig.

Altre risorse

Per ulteriori informazioni sul progetto Presentazioni Advisor, consulta il repository del codice. Se hai bisogno di assistenza per la creazione dell'applicazione o vuoi collaborare con altri sviluppatori, visita il server Discord della community di Google Developers. Per altri progetti IA di Build with Google, dai un'occhiata alla playlist dei video.