Tworzenie weryfikatora slajdów z AI za pomocą Gemini

Przygotowywanie, uruchamianie i dostosowywanie dodatku do recenzentów slajdów do Google Workspace Prezentacje z tym projektem kodu. czy prowadzisz jedną prezentację w tygodniu, czy raz na rok, większość z nas przydałaby się odrobina pomocy w ich poprawieniu. Czy umieszcza zbyt dużo informacji na slajdzie? Może zapomniałeś podzielić prezentację? o treściach wizualnych? Możesz nawet przygotować dla swojej organizacji zestaw wytycznych dotyczących i skuteczne prezentacje. Czytałeś(-aś) je ostatnio?

Doradca Prezentacji Google projektu to dodatek do Google Workspace typu open source, technologii inteligentnych (AI) do przeglądania prezentacji i przekazywania opinii na ich temat, zawsze i wszędzie. Projekt wykorzystuje obrazy i tekst z interfejsu Google Gemini API funkcji przetwarzania w celu analizowania Prezentacji Google pod kątem zestawu wytycznych. oraz informuje, jak sobie radzisz z tymi wytycznymi. Tym lepiej, może dostosować te wskazówki tak, aby były zgodne z zaleceniami organizacji; przypomina o konieczności ulepszenia prezentacji na podstawie zdefiniowanych przez Ciebie reguł siebie.

Filmowe omówienie projektu i sposobów jego rozszerzenia, w tym statystyki od osób, które go stworzyły, zapoznaj się z artykułem na temat recenzenta Prezentacji AI – Build with Google AI Możesz też rozpocząć przedłużanie subskrypcji, zgodnie z instrukcją.

Dodatek do Doradcy Prezentacji działający jako pasek boczny w Prezentacjach Google Rysunek 1. Dodatek doradcy Prezentacji Google dla Prezentacji Google działających jako panel paska bocznego.

Konfigurowanie projektu

Te instrukcje przeprowadzą Cię przez proces konfigurowania projektu w narzędziu Prezentacje Google do programowania i testowania. Ogólna procedura to tworzenie Projekt skryptu, konfigurowanie projektu Google Cloud na potrzeby dostępu do interfejsu API i ustawienie właściwości skryptu w projekcie.

Utwórz projekt Apps Script

Ten projekt usługi Prezentacje Google jest uruchamiany jako Dodatek do Prezentacje Google. Konfigurujesz projekt za pomocą interfejsu internetowego Prezentacji Google. utwórz dla kodu projekt Apps Script.

Aby utworzyć nowy projekt Apps Script:

  1. Otwórz aplikację internetową Prezentacje dla Google. Obszar roboczy.
  2. Otwórz istniejącą prezentację lub utwórz nową.
  3. W Prezentacjach Google wybierz Rozszerzenia > Apps Script.

Gdy wykonasz te czynności, w interfejsu internetowego Apps Script dołączonego do prezentacji od tego miejsca. Nazwij projekt, aby ułatwić sobie jego znalezienie.

Aby nazwać projekt Apps Script:

  1. W interfejsie internetowym Apps Script zaznacz tekst Untitled project (Projekt bez tytułu).
  2. W oknie Zmień nazwę projektu wpisz: My Slides Advisor, a następnie wybierz Zmień nazwę.

Przygotowywanie plików projektu

Projekt Prezentacji Advisor zawiera 5 plików kodu i musisz je skonfigurować przed skopiowaniem kodu do nowego projektu Apps Script. Ta sekcja opisuje, jak przygotować projekt i uzyskać kod.

Aby przygotować pliki projektu:

  1. Otwórz interfejs internetowy Apps Script zawierający Doradcę Moich Prezentacji w projektach AI.
  2. W menu po lewej stronie wybierz < &gt; widoku edytora.
  3. Zmień nazwę pliku Code.gs na main.gs, kursorem myszy Code.gs, kliknij Zmień nazwę w menu kontekstowym. wpisz main. Interfejs automatycznie dodaje rozszerzenie .gs.
  4. Wybierz, aby plik manifestu appscript.json projektu był widoczny. ikonę koła zębatego (Ustawienia projektu) w menu po lewej stronie, włączając opcję Pokaż plik „appscript.json” manifest pliku.
  5. W interfejsie internetowym Apps Script po lewej stronie kliknij przycisk < &gt; widoku edytora.
  6. Utwórz plik z kodem ui.gs, klikając ikonę + (plus) po prawej stronie. nagłówka Files (Pliki), wybierając Script (Skrypt) i wpisując ui.
  7. Powtórz poprzedni krok, aby utworzyć slides.gs i ai.gs. w plikach z kodem.

Twój projekt Apps Script powinien teraz zawierać 5 poniższych plików kodu, które są najczęściej puste:

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

W następnym kroku pobierz kod projektu z repozytorium i skopiuj go do w projekcie Apps Script.

Pobieranie kodu projektu

Kod projektu Prezentacji Advisor jest hostowany w repozytorium kodu. Ty skopiować ten kod do projektu Apps Script, aby móc z nim pracować. Ten zawiera informacje o tym, jak uzyskać kod projektu.

Aby pobrać kod projektu:

  1. Przejdź do repozytorium kodu projektu, gdzie znajduje się plik manifestu. appsscript.json
  2. Skopiuj zawartość tego pliku z kodem do schowka.
  3. Wróć do interfejsu internetowego Apps Script, zaznacz appsscript.json i wklej go do edytora kodu. i zastępując wszystkie wcześniejsze kody.
  4. Powtórz tę procedurę dla pozostałych 4 plików z kodem:

Połącz projekt Google Cloud

W tym projekcie używany jest projekt Google Cloud do uzyskiwania dostępu do modeli AI Gemini. Google Google Cloud zapewnia określoną prywatność danych zasad, a także szereg przydatnych usług oprogramowania do tworzenia takich jak Prezentacje Advisor. Łączysz kod dodatku z interfejsem Gemini API przez utworzenie projektu Cloud z dostępem do AI API, utworzenie konta usługi dla projektu, tworząc klucz dla konta usługi i instalując go projektu dodatku.

Konfigurowanie projektu Cloud

Projekt Cloud, którego używasz do łączenia się z interfejsem Gemini API, musi korzystać z Vertex AI została włączona usługa API i musisz utworzyć uwierzytelnione połączenie z dodatku doradcy Prezentacji Google do tego projektu. Interfejs Vertex AI API wymaga również w projektach, w których z niego korzystasz.

Aby skonfigurować projekt Cloud z dostępem do interfejsu Vertex AI API:

  1. Otwórz konsolę Google Cloud. i w razie potrzeby zalogować się na konto.
  2. W konsoli Google Cloud wybierz istniejący projekt Cloud lub utwórz nową.
  3. W konsoli Strona panelu dla swojego projektu, w panelu Interfejsy API wybierz Otwórz przegląd interfejsów API lub otwórz stronę https://console.cloud.google.com/apis/.
  4. U góry strony Interfejsy API i usługi wybierz + WŁĄCZ INTERFEJSY API I USŁUGI.
  5. Na stronie API Library (Biblioteka interfejsów API) wyszukaj vertex ai api, wybierz Vertex AI API i kliknij przycisk Włącz.
  6. Włącz płatności za Google Cloud, jeśli jeszcze nie zostało to zrobione. projektu i włącz interfejs AI API, klikając przycisk Włącz Vertex AI API w konsoli.
  7. Sprawdź, czy interfejs Vertex AI API jest włączony, przechodząc do Strona Interfejsy API i usługi dla do swojego projektu. Na tej stronie powinien się wyświetlić interfejs Vertex AI API.

Tworzenie konta usługi

Dodatek doradcy Prezentacji wymaga uwierzytelnionego połączenia z chmurą projekt, aby uzyskać dostęp do interfejsu Vertex AI API i modeli Gemini. Tworzysz je, przez wygenerowanie konto usługi, w projekcie Cloud, który ma dostęp do interfejsu Vertex AI API. Doradca ds. Prezentacji projekt nawiązuje połączenie za pomocą tego konta usługi.

Aby utworzyć konto usługi dla dodatku doradcy Prezentacji:

  1. W konsoli Google Cloud otwórz Interfejsy API i usługi Twojego projektu Cloud.
  2. W lewej części strony kliknij Credentials (Dane logowania).
  3. U góry strony wybierz + UTWÓRZ DANE LOGOWANIA > Konto usługi.
  4. Na stronie Utwórz konto usługi w sekcji Szczegóły konta usługi wpisz nazwę, identyfikator i opis konta usługi.
  5. Utwórz konto usługi, klikając Utwórz i kontynuuj.
  6. W sekcji Przyznaj temu kontu usługi dostęp do projektu wybierz element sterujący rolą.
  7. W polu Filter (Filtr) znajdź i wybierz Vertex AI User (Użytkownik Vertex AI). i wybierz Dalej.
  8. Aby zakończyć tworzenie konta usługi, kliknij Gotowe.

Więcej informacji o tworzeniu kont usługi znajdziesz na stronie Google Cloud Tworzenie kont usługi dokumentacji.

Utwórz i zainstaluj klucz konta usługi

Projekt Prezentacji Advisor musi mieć możliwość uwierzytelnienia na koncie usługi utworzony w poprzedniej procedurze. Aby włączyć to uwierzytelnianie, utworzenie klucza dla konta usługi i skonfigurowanie go w Prezentacjach, projekt Advisor Apps Script jako właściwość skryptu. Poniższa procedura wyjaśnia, jak utworzyć klucz i skonfigurować go w projekcie.

Aby utworzyć i skonfigurować klucz konta usługi:

  1. W konsoli Google Cloud otwórz Strona Interfejsy API i usługi dla do swojego projektu Cloud.
  2. W lewej części strony kliknij Credentials (Dane logowania).
  3. W sekcji Konta usługi znajdź konto usługi, kliknij adres e-mail konta lub ikonę ołówka, aby go edytować.
  4. W oknie edycji konta usługi u góry strony wybierz tytuł karty KEYS.
  5. W sekcji Keys (Klucze) wybierz Add Keys (Dodaj klucz) > Utwórz nowy klucz.
  6. W oknie Utwórz klucz prywatny dla... wybierz JSON, a następnie Utwórz. Wykonanie tego kroku pomoże utworzyć plik klucza o nazwie projectid-hashcode.json i automatycznie pobierze go na Twój komputer.
  7. Otwórz pobrany plik projectid-hashcode.json i skopiuj jego zawartość.
  8. Otwórz interfejs internetowy Apps Script zawierający Doradcę Moich Prezentacji projektu i wybierz widok Ustawienia w menu po lewej stronie.
  9. W sekcji Właściwości skryptu wybierz opcję Edytuj skrypt. właściwości, a następnie Dodaj właściwość skryptu.
  10. W nowym polu Usługa wpisz SERVICE_ACCOUNT_KEY, a w polu Wartość, skopiuj zawartość pobranego pliku projectid-hashcode.json.
  11. Zapisz nową właściwość, klikając przycisk Zapisz właściwości skryptu.

Więcej informacji o tworzeniu kluczy konta usługi znajdziesz w artykule o Google Cloud Tworzenie i usuwanie kluczy konta usługi dokumentacji.

Testowanie projektu dodatku

Slajd Google Workspace z ikoną Doradcy Prezentacji Testowanie projektu Prezentacji Advisor wymaga utworzenia wdrożenia testowego kodu dodatku i zainstalować to wdrożenie testowe. W tych testach projekt jest dostępny tylko w Prezentacjach Google. w którym uruchomiono dodatek Apps Script Add (dodatek Apps Script) i żadne inne slajdy prezentacje. Więcej informacji o wdrażaniu dodatku do szerszego zastosowania znajdziesz tutaj: dokumentację Apps Script Google Workspace, Tworzenie wdrożeń i zarządzanie nimi temat.

Aby wdrożyć i przetestować kod projektu Apps Script:

  1. W górnej części interfejsu internetowego Apps Script wybierz Wdróż > Testuj wdrożeniach.
  2. W oknie Testuj wdrożenia obok opcji Wybierz typ wybierz ikonę koła zębatego i dodatek Google Workspace.
  3. Obok pozycji Aplikacje: tytuł Prezentacji kliknij przycisk Zainstaluj.
  4. Pozostaw domyślne ustawienia opcji Przetestuj ostatni kod i kliknij Gotowe.
  5. Poruszanie się po prezentacji Google połączonej z Apps Script projektu i załaduj ponownie stronę.
  6. W prawym dolnym rogu aplikacji internetowej Prezentacje kliknij ( &lt; ). kliknij ikonę, aby otworzyć panel boczny, a następnie wybierz ikonę czarno-białego oka otwórz panel Doradca Prezentacji Google.

Po wykonaniu tego kroku i pomyślnym uruchomieniu dodatku możesz rozpocząć modyfikować go, aby korzystała z innych wytycznych lub korzystała z innego procesu. Zobacz kilku kolejnych sekcji, by dowiedzieć się, jak wprowadzić Dodatek do Doradcy Prezentacji.

Zmiana sposobu działania opinii

Możesz zmienić sposób weryfikacji doradcy Prezentacji, zarówno pod względem tego, z Gemini API, oraz interfejsu użytkownika Dodatek przez modyfikację kodu projektu. Ten samouczek skupia się na zmianie z instrukcjami zmieniania sposobu sprawdzania slajdów w prezentacji. Dla: znajdziesz więcej informacji o rozszerzeniu interfejsu użytkownika Prezentacji Google za pomocą Apps Script. zobacz Przedłużanie Prezentacji Google.

Zmień wytyczne dotyczące sprawdzania

Doradca Prezentacji ma zaprogramowany podstawowy zestaw wytycznych dotyczących sprawdzania slajdów z podziałem na prostotę, kolory, typografię, strukturę i odstępy. oraz grafiki i ikony. Wskazówki dotyczące opinii to instrukcje tekstowe zawarte w prompcie za pomocą interfejsu Gemini API wraz z obrazem zrzutu zaznaczony slajd oraz notatki.

Możesz zmienić sposób sprawdzania dodatku, zmieniając tekst za instrukcje. Możesz na przykład polecić modelowi Gemini, aby zwracał opinię z oceną kategorii w tym samym wierszu co nagłówek kategorii lub zmienić nazwę kategorii.

Aby zmienić lokalizację oceny i nazwę kategorii:

  1. Otwórz interfejs internetowy Apps Script zawierający Doradcę Moich Prezentacji w projektach AI. W razie potrzeby przejdź do okna projektu, otwierając Prezentacja w Prezentacjach zawierająca projekt Apps Script i zaznaczanie Rozszerzenia > Apps Script.
  2. W menu po lewej stronie wybierz < &gt; widoku edytora, a następnie wybierz ai.gs.
  3. W pliku kodu ai.gs znajdź stałą ciąg znaków SYSTEM_PROMPT. i zmodyfikuj instrukcje w następujący sposób, używając pogrubionego tekstu: 
    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. Korzystając z tej samej stałej ciągu SYSTEM_PROMPT, zmień Simplicity tekst kategorii na zapytanie Message: 
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. Zapisz zmiany w pliku kodu ai.gs.
  6. Poruszanie się po prezentacji Google połączonej z Apps Script załaduj ten dodatek, załaduj ponownie stronę i przetestuj zmiany ponowne uruchomienie.

Jeśli nie masz jeszcze skonfigurowanego wdrożenia testowego dodatku Advisory, wykonaj instrukcje podane w Przetestuj projekt dodatku.

Instrukcje dotyczące kategorii opinii można usunąć, zastąpić lub przeredagować na Stała ciąg znaków SYSTEM_PROMPT, która odpowiada wymaganiom dotyczącym opinii. Jeśli chcesz wypróbować różne podejścia do weryfikacji lub napisać całą opinię zapoznaj się z przeglądarką Google AI Studio aplikacji. Ta aplikacja pozwala na prototypowanie, testowanie i zapisywanie promptów dla Gemini w wygodny interfejs i korzysta z tego samego interfejsu Gemini API co narzędzie Prezentacji Advisor w projektach AI. Więcej informacji o korzystaniu z AI Studio znajdziesz tutaj: Krótki przewodnik po AI Studio

Zmień konfigurację zachowania modelu

Interfejs Gemini API udostępnia kilka ustawień do zmiany ogólnego działania w odpowiedzi na prompt. Przede wszystkim chodzi o temperaturę pozwala określić, jak duże zmienność model jest dozwolony odpowiedź, gdzie 0 oznacza najniższą wartość, a 1 – najwyższą. Ustawianie tej wartości dla 0,1 daje bardzo spójne odpowiedzi, ale może się wydawać, że to zachowanie się powtarza i mniej przydatne dla użytkowników, którzy otrzymują opinie. Warto skonfigurować wyższą temperaturę i pamiętaj, że im wyższa temperatura, mogą być bardziej niespójne, np. wdrożenie instrukcje, a nawet zupełnie zignorować niektóre z nich.

Aby zwiększyć temperaturę odpowiedzi na opinie:

  1. Otwórz interfejs internetowy Apps Script zawierający Doradcę Moich Prezentacji w projektach AI.
  2. W menu po lewej stronie wybierz < &gt; widoku edytora, a następnie wybierz ai.gs.

  3. W pliku kodu ai.gs znajdź funkcję analyzeSlides() i zmień stałą generationConfig, ustawiając wartość temperature do 0.3:

    function analyzeSlides(slide) {

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

  4. Zapisz zmiany w pliku kodu ai.gs.

  5. Poruszanie się po prezentacji Google połączonej z Apps Script załaduj ten dodatek, załaduj ponownie stronę i przetestuj zmiany ponowne uruchomienie.

Więcej informacji o ustawieniach konfiguracji zachowania modelu znajdziesz w Gemini Dokumentacja API dla GenerationConfig

Dodatkowe materiały

Więcej informacji o projekcie Prezentacji Advisor znajdziesz tutaj: repozytorium kodu. Jeśli potrzebujesz pomocy przy tworzeniu aplikacji lub chcesz nawiązać współpracę innych programistów, zapoznaj się z Serwer Discord społeczności Google Developers. Aby dowiedzieć się więcej o projektach Build with Google AI, zapoznaj się z playlisty wideo.