Sehen Sie sich das neue Cookbook zur Gemini API und unser Community-Forum an.

Diese Seite wurde von der Cloud Translation API übersetzt.

Mit Gemini einen KI-Folienprüfer erstellen

Stellen Sie mit diesem Codeprojekt ein Folienprüfer-Add-on für Google Workspace Präsentationen zusammen, führen Sie es aus und passen Sie es an. Unabhängig davon, ob Sie eine Präsentation pro Woche oder einmal im Jahr halten, die meisten von uns brauchen ein wenig Unterstützung. Stecken Sie meist zu viel auf eine Folie? Vielleicht vergessen Sie, Ihre Präsentation mit visuellen Elementen zu gliedern? Möglicherweise gibt es von Ihrem Unternehmen sogar eine Reihe von Richtlinien für wirkungsvolle Präsentationen. Hast du das in letzter Zeit gelesen?

Das Slides Advisor-Projekt ist ein Open-Source-Google Workspace-Add-on, das künstliche Intelligenz (KI) verwendet, um Ihre Präsentationen zu prüfen und Feedback zu geben, wann immer Sie sie benötigen. Das Projekt verwendet die Bild- und Textverarbeitungsfunktionen der Gemini API von Google, um Ihre Google-Präsentationen anhand einer Reihe von Richtlinien zu analysieren und zu erfahren, wie Sie bei Einhaltung dieser Richtlinien abschneiden. Diese Richtlinien lassen sich sogar so anpassen, dass sie den Empfehlungen Ihrer Organisation entspricht, oder Sie daran erinnern, Ihre Präsentationen anhand von Regeln zu verbessern, die Sie selbst definieren.

Ein Video mit einem Überblick über das Projekt und wie es erweitert werden kann, einschließlich der Erkenntnisse der Entwickler, findest du unter AI Präsentationen Reviewer – Build with Google AI. Alternativ können Sie beginnen, das Projekt zu erweitern. Folgen Sie dazu der Anleitung.

Abbildung 1: Präsentationen Advisor-Add-on für Google Präsentationen, die als Seitenleistenbereich ausgeführt wird

Projekt einrichten

In dieser Anleitung erfahren Sie, wie Sie das Slides Advisor-Projekt für Entwicklung und Tests einrichten. Die allgemeinen Schritte bestehen darin, das Google Apps Script-Projekt zu erstellen, ein Google Cloud-Projekt für den API-Zugriff einzurichten und einige Skripteigenschaften für das Projekt festzulegen.

Apps Script-Projekt erstellen

Dieses Slides Advisor-Projekt wird als Add-on für Google Präsentationen ausgeführt. Sie richten das Projekt über die Weboberfläche von Google Präsentationen ein und erstellen ein Apps Script-Projekt für den Code.

So erstellen Sie ein neues Apps Script-Projekt:

Rufen Sie die Web-App von Google Präsentationen für Google Workspace auf.
Öffnen Sie eine vorhandene Präsentation oder erstellen Sie eine neue.
Wählen Sie in Ihrer Google-Präsentation Erweiterungen > Apps Script aus.

Wenn Sie diese Schritte ausgeführt haben, sollte in der Weboberfläche von Apps Script ein neues Untitled Project (Unbenanntes Projekt) vorhanden sein, das an die Präsentation angehängt ist, mit der Sie begonnen haben. Benennen Sie das Projekt, damit es leichter zu finden ist.

So benennen Sie das Apps Script-Projekt:

Wählen Sie in der Apps Script-Weboberfläche den Text Unbenanntes Projekt aus.
Geben Sie im Dialogfeld „Projekt umbenennen“ My Slides Advisor ein und wählen Sie dann Umbenennen aus.

Projektdateien vorbereiten

Das Slides Advisor-Projekt enthält fünf Codedateien. Sie müssen diese Dateien einrichten, bevor Sie den Code in Ihr neues Apps Script-Projekt kopieren können. In diesem Abschnitt wird beschrieben, wie Sie das Projekt vorbereiten und den Code abrufen.

So bereiten Sie die Projektdateien vor:

Öffnen Sie die Apps Script-Weboberfläche mit dem Projekt My Slides Advisor.
Wählen Sie im Menü auf der linken Seite die Ansicht < > Editor aus.
Benennen Sie die Datei Code.gs in main.gs um. Bewegen Sie dazu den Mauszeiger auf den Namen der Codedatei Code.gs, wählen Sie im Kontextmenü Umbenennen aus und geben Sie main ein. Die -Schnittstelle fügt die .gs-Erweiterung automatisch hinzu.
Machen Sie die Manifestdatei appscript.json des Projekts sichtbar, indem Sie im Menü auf der linken Seite das Zahnradsymbol (Projekteinstellungen) auswählen und dann die Option Manifestdatei "appscript.json" anzeigen aktivieren.
Wählen Sie in der Apps Script-Weboberfläche im Menü auf der linken Seite die Ansicht < > Editor aus.
Erstellen Sie eine ui.gs-Codedatei. Klicken Sie dazu auf das Symbol + (Plus) rechts neben dem Header Dateien, wählen Sie Script aus und geben Sie ui ein.
Wiederholen Sie den vorherigen Schritt, um die Codedateien slides.gs und ai.gs zu erstellen.

Ihr Apps Script-Projekt sollte jetzt die folgenden fünf Codedateien enthalten, die größtenteils leer sind:

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

Rufen Sie für den nächsten Schritt den Projektcode aus dem Repository ab und kopieren Sie ihn in Ihr Apps Script-Projekt.

Projektcode abrufen

Der Code für das Slides Advisor-Projekt wird in einem Code-Repository gehostet. Sie müssen diesen Code in Ihr Apps Script-Projekt kopieren, um damit zu arbeiten. In diesem Abschnitt wird beschrieben, wie Sie den Projektcode abrufen.

So rufen Sie den Projektcode ab:

Rufen Sie das Projektcode-Repository für die Projektmanifestdatei appsscript.json auf.
Kopieren Sie den Inhalt dieser Codedatei in die Zwischenablage.
Wechseln Sie zurück zur Apps Script-Weboberfläche, wählen Sie den Dateinamen appsscript.json aus und fügen Sie den Code in das Feld des Codeeditors ein. Ersetzen Sie dabei den vorherigen Code.
Wiederholen Sie diesen Vorgang für die anderen vier Codedateien:
- Kopieren Sie den Code main.js in die Datei main.gs.
- Kopieren Sie den Code ui.js in Ihre Datei ui.gs.
- Kopieren Sie den Code slides.js in die Datei slides.gs.
- Kopieren Sie den Code ai.js in Ihre Datei ai.gs.

Google Cloud-Projekt verbinden

In diesem Projekt wird über ein Google Cloud-Projekt auf die Gemini-KI-Modelle zugegriffen. Google Cloud bietet spezielle Datenschutzrichtlinien sowie eine Vielzahl hilfreicher Softwaredienste zum Erstellen von Anwendungen wie Slides Advisor. Sie verbinden den Add-on-Code mit der Gemini API. Dazu erstellen Sie ein Cloud-Projekt mit AI API-Zugriff, ein Dienstkonto für das Projekt, einen Schlüssel für das Dienstkonto und installieren diesen Schlüssel in Ihrem Add-on-Projekt.

Cloud-Projekt konfigurieren

Für das Cloud-Projekt, mit dem Sie eine Verbindung zur Gemini API herstellen, muss der Vertex AI API-Dienst aktiviert sein. Außerdem müssen Sie eine authentifizierte Verbindung vom Präsentationen Advisor-Add-on zu diesem Projekt erstellen. Für die Vertex AI API muss auch die Abrechnung in den Projekten aktiviert sein, in denen Sie sie verwenden.

So konfigurieren Sie ein Cloud-Projekt mit Vertex AI API-Zugriff:

Rufen Sie die Google Cloud Console auf und melden Sie sich an, falls erforderlich.
Wählen Sie in der Google Cloud Console ein vorhandenes Cloud-Projekt aus oder erstellen Sie ein neues.
Wählen Sie auf der Console-Seite Dashboard für Ihr Projekt im Bereich APIs die Option Zur API-Übersicht aus oder rufen Sie https://console.cloud.google.com/apis/ auf.
Wählen Sie oben auf der Seite APIs und Dienste die Option + APIS UND DIENSTE AKTIVIEREN aus.
Suchen Sie auf der Seite API-Bibliothek nach vertex ai api, wählen Sie die Option Vertex AI API aus und klicken Sie dann auf die Schaltfläche Aktivieren.
Falls noch nicht geschehen, müssen Sie für das Google Cloud-Projekt die Abrechnung aktivieren und dann die AI API aktivieren. Wählen Sie dazu auf der Konsolenseite der Vertex AI API die Schaltfläche Aktivieren aus.
Prüfen Sie, ob die Vertex AI API aktiviert ist. Rufen Sie dazu die Seite APIs und Dienste für Ihr Projekt auf. Die Vertex AI API sollte jetzt auf dieser Seite aufgeführt werden.

Dienstkonto erstellen

Das Präsentationen Advisor-Add-on erfordert eine authentifizierte Verbindung zu Ihrem Cloud-Projekt, um auf die Vertex AI API und die Gemini-Modelle zugreifen zu können. Für diese Verbindung erstellen Sie zuerst ein Dienstkonto in Ihrem Cloud-Projekt, das Zugriff auf die Vertex AI API hat. Das Slides Advisor-Projekt stellt die Verbindung über dieses Dienstkonto her.

So erstellen Sie ein Dienstkonto für das Präsentationen Advisor-Add-on:

Rufen Sie in der Google Cloud Console die Seite APIs und Dienste für Ihr Cloud-Projekt auf.
Wählen Sie links auf der Seite Anmeldedaten aus.
Wählen Sie oben auf der Seite + ANMELDEDATEN ERSTELLEN > Dienstkonto aus.
Geben Sie auf der Seite Dienstkonto erstellen im Abschnitt Dienstkontodetails einen Namen, eine ID und eine Beschreibung für das Dienstkonto ein.
Erstellen Sie das Dienstkonto. Wählen Sie dazu Erstellen und fortfahren aus.
Wählen Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt gewähren das Steuerelement Rolle aus.
Wählen Sie im Feld Filter den Berechtigungssatz Vertex AI User und dann Weiter aus.
Schließen Sie die Erstellung dieses Dienstkontos ab, indem Sie Fertig auswählen.

Weitere Informationen zum Erstellen von Dienstkonten finden Sie in der Google Cloud-Dokumentation Dienstkonten erstellen.

Dienstkontoschlüssel erstellen und installieren

Das Slides Advisor-Projekt muss sich bei dem Dienstkonto authentifizieren können, das Sie im vorherigen Verfahren erstellt haben. Sie können diese Authentifizierung aktivieren, indem Sie einen Schlüssel für das Dienstkonto erstellen und diesen Schlüssel in Ihrem Apps Script-Projekt in Präsentationen Advisor als Skript-Attribut konfigurieren. Im Folgenden wird erläutert, wie Sie den Schlüssel erstellen und in Ihrem Projekt konfigurieren.

So erstellen und konfigurieren Sie einen Dienstkontoschlüssel:

Rufen Sie in der Google Cloud Console die Seite APIs und Dienste für Ihr Cloud-Projekt auf.
Wählen Sie links auf der Seite Anmeldedaten aus.
Suchen Sie im Abschnitt Dienstkonten das von Ihnen erstellte Dienstkonto und wählen Sie zum Bearbeiten die E-Mail-Adresse des Kontos oder das Stiftsymbol aus.
Wählen Sie im Bearbeitungsfenster des Dienstkontos oben auf der Seite den Tab SCHLÜSSEL aus.
Wählen Sie im Abschnitt Schlüssel die Option Schlüssel hinzufügen > Neuen Schlüssel erstellen aus.
Wählen Sie im Dialogfeld Privaten Schlüssel erstellen für... die Option JSON und dann Erstellen aus. In diesem Schritt wird eine Schlüsseldatei namens projectid-hashcode.json erstellt und automatisch auf Ihren Computer heruntergeladen.
Öffnen Sie die heruntergeladene Datei projectid-hashcode.json und kopieren Sie den Inhalt.
Öffnen Sie die Apps Script-Weboberfläche mit dem Projekt My Slides Advisor und wählen Sie im Menü auf der linken Seite die Ansicht Settings (Einstellungen) aus.
Klicken Sie im Bereich Skripteigenschaften auf die Schaltfläche Skripteigenschaften bearbeiten und dann auf die Schaltfläche Skripteigenschaft hinzufügen.
Geben Sie im neuen Feld Property den Wert SERVICE_ACCOUNT_KEY ein und kopieren Sie im Feld Value (Wert) den Inhalt der heruntergeladenen Datei projectid-hashcode.json.
Speichern Sie die neue Eigenschaft, indem Sie auf die Schaltfläche Skripteigenschaften speichern klicken.

Weitere Informationen zum Erstellen von Dienstkontoschlüsseln finden Sie in der Google Cloud-Dokumentation Dienstkontoschlüssel erstellen und löschen.

Add-on-Projekt testen

Google Workspace-Folienbereich mit dem Google Präsentationen Advisor-Symbol Zum Testen des Slides Advisor-Projekts müssen Sie eine Testbereitstellung des Add-on-Codes erstellen und diese Testbereitstellung installieren. In dieser Testkonfiguration ist das Projekt nur in der Google-Präsentation verfügbar, in der Sie das Apps Script-Add-on-Projekt gestartet haben, und in keinen anderen Präsentationen. Weitere Informationen zum Bereitstellen des Add-ons für eine breitere Verwendung finden Sie in der Google Workspace Apps Script-Dokumentation unter Bereitstellungen erstellen und verwalten.

So stellen Sie den Apps Script-Projektcode bereit und testen ihn:

Wählen Sie oben auf der Apps Script-Weboberfläche Bereitstellen > Bereitstellungen testen aus.
Klicken Sie im Dialogfeld Bereitstellungen testen neben Typ auswählen auf das Zahnradsymbol und dann auf Google Workspace-Add-on.
Wählen Sie neben „Apps: Titel der Präsentation“ die Schaltfläche Installieren aus.
Behalten Sie die Standardeinstellungen für Aktuellen Code testen bei und wählen Sie Fertig aus.
Navigieren Sie in der Google-Präsentation, die mit Ihrem Apps Script-Projekt verknüpft ist, und aktualisieren Sie die Webseite.
Klicken Sie in der rechten unteren Ecke der Präsentationen-Web-App auf das Symbol ( <), um die Seitenleiste zu öffnen. Wählen Sie dann das schwarz-weiße Augensymbol aus, um den Google Präsentationen Advisor-Bereich zu öffnen.

Nachdem Sie diesen Schritt abgeschlossen und das Add-on erfolgreich ausgeführt haben, können Sie es ändern, um andere Richtlinien zu verwenden oder einem anderen Workflow zu folgen. In den nächsten Abschnitten finden Sie eine Anleitung dazu, wie Sie einige grundlegende Änderungen am Präsentationen Advisor-Add-on vornehmen.

Überprüfungsverhalten ändern

Sie können das Überprüfungsverhalten des Präsentationen Advisor in Bezug auf die Ausgabe, die Sie von der Gemini API erhalten, und die vom Add-on bereitgestellte Benutzeroberfläche ändern, indem Sie dessen Projektcode anpassen. In dieser Anleitung geht es vorrangig um das Ändern der Eingabeaufforderung, um das Verhalten der Präsentationsfolien zu ändern. Weitere Informationen zum Erweitern der Benutzeroberfläche von Google Präsentationen mit Apps Script finden Sie unter Google Präsentationen erweitern.

Richtlinien für Rezensionen ändern

Der Google Präsentationen Advisor enthält grundlegende Richtlinien zur Überprüfung von Folien mit Kategorien wie Einfachheit, Farbe und Typografie, Struktur und Leerzeichen sowie Grafiken und Symbolen. Die Richtlinien für die Überprüfung bestehen ausschließlich aus Textanweisungen, die in einem Prompt über die Gemini API enthalten sind, zusammen mit einer Momentaufnahme der ausgewählten Folie und Vortragsnotizen.

Sie können das Überprüfungsverhalten des Add-ons ändern, indem Sie die Textanweisungen ändern. Sie können das Gemini-Modell beispielsweise anweisen, die Rezension mit der Kategoriebewertung in derselben Zeile wie die Kategorieüberschrift auszugeben, oder den Namen einer Kategorie ändern.

So ändern Sie den Ort der Einstufung einer Kategorie und einen Kategorienamen:

Öffnen Sie die Apps Script-Weboberfläche mit dem Projekt My Slides Advisor. Gehen Sie gegebenenfalls zum Projektfenster. Öffnen Sie dazu die Google Präsentationen-Präsentation mit dem Apps Script-Projekt und wählen Sie Erweiterungen > Apps Script aus.
Wählen Sie im Menü auf der linken Seite die Ansicht < > Editor und dann den Dateinamen ai.gs aus.

Suchen Sie in der Codedatei ai.gs nach der Stringkonstante SYSTEM_PROMPT und ändern Sie die Anleitung mit dem fett formatierten Text so:

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.

Ändern Sie in derselben Stringkonstante SYSTEM_PROMPT den Kategorietext Simplicity in Message:

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

Speichern Sie die Änderungen an der ai.gs-Codedatei.
Rufen Sie die mit Ihrem Apps Script-Projekt verbundene Google Präsentationen-Präsentation auf, laden Sie die Webseite neu und testen Sie die Änderungen am Add-on, indem Sie es noch einmal ausführen.

Wenn Sie noch keine Testbereitstellung für das Präsentationen Advisor-Add-on eingerichtet haben, folgen Sie der Anleitung unter Add-on-Projekt testen.

Sie können die Anleitung für die Rezensionskategorie in der String-Konstante SYSTEM_PROMPT entfernen, ersetzen oder umschreiben, um Ihren Anforderungen entsprechend zu entsprechen. Wenn Sie verschiedene Ansätze für Überprüfungsaufforderung ausprobieren oder die gesamte Aufforderung zur Überprüfung neu schreiben möchten, sehen Sie sich die Webanwendung Google AI Studio an. Mit dieser App können Sie Prompts für Gemini in einer praktischen Benutzeroberfläche erstellen, testen und speichern. Sie verwendet dieselbe Gemini API wie das Präsentationen Advisor-Projekt. Weitere Informationen zur Verwendung von AI Studio finden Sie in der Kurzanleitung zu AI Studio.

Konfiguration des Modellverhaltens ändern

Die Gemini API bietet mehrere Einstellungen zum Ändern des allgemeinen Betriebs des Modells als Reaktion auf eine Anfrageaufforderung. Mit der Einstellung temperature (Temperatur) für das Modell können Sie insbesondere festlegen, wie stark die Abweichung des Modells in einer Antwort zulässig ist. Dabei ist null die niedrigste und 1 die höchste. Wenn Sie diesen Wert auf 0,1 festlegen, erhalten Sie sehr konsistente Antworten.Dieses Verhalten kann sich jedoch wiederholen und für Nutzer, die Feedback zu Rezensionen erhalten, weniger hilfreich sein. Ziehen Sie in Betracht, den Temperaturwert zu erhöhen. Beachten Sie, dass die Ergebnisse umso uneinheitlicher sein können, je höher die Temperatur ist, was dazu führen kann, dass Anweisungen anders implementiert oder sogar einige Anweisungen vollständig ignoriert werden.

So erhöhen Sie die Temperatur für Rezensionsantworten:

Öffnen Sie die Apps Script-Weboberfläche mit dem Projekt My Slides Advisor.
Wählen Sie im Menü auf der linken Seite die Ansicht < > Editor und dann den Dateinamen ai.gs aus.
Suchen Sie in der Codedatei ai.gs die Funktion analyzeSlides() und ändern Sie die Konstante generationConfig. Dazu setzen Sie den Wert temperature auf 0.3:
```
function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };
```
Speichern Sie die Änderungen an der ai.gs-Codedatei.
Rufen Sie die mit Ihrem Apps Script-Projekt verbundene Google Präsentationen-Präsentation auf, laden Sie die Webseite neu und testen Sie die Änderungen am Add-on, indem Sie es noch einmal ausführen.

Weitere Informationen zu den Konfigurationseinstellungen für das Modellverhalten finden Sie in der Gemini API-Dokumentation für GenerationConfig.

Zusätzliche Ressourcen

Weitere Informationen zum Slides Advisor-Projekt finden Sie im Code-Repository. Wenn Sie Hilfe beim Erstellen der Anwendung benötigen oder mit anderen Entwicklern zusammenarbeiten möchten, besuchen Sie den Server der Google Developers-Community Discord. Weitere KI-Projekte von Build with Google finden Sie in der Videoplaylist.