יצירת בודק שקפים של AI באמצעות Gemini

באמצעות פרויקט הקוד הזה אפשר להרכיב, להריץ ולהתאים אישית תוסף לבדיקת שקפים ב-Google Workspace Slides. לא משנה אם אתם מכינים מצגת אחת בשבוע או מצגת בשנה, רובנו צריכים קצת עזרה כדי לעשות את זה כמו שצריך. אתם נוטים להציב יותר מדי בשקף? אולי שכחתם לחלק את המצגת לרכיבים חזותיים? יכול להיות שיש לכם גם כמה הנחיות מהארגון שלכם למצגות אפקטיביות. קראת את אלה לאחרונה?

פרויקט Slides Advisor הוא תוסף קוד פתוח ל-Google Workspace שמשתמש בטכנולוגיית בינה מלאכותית (AI) כדי לבדוק את המצגות שלכם ולתת משוב עליהן מתי שרוצים. בפרויקט הזה נעשה שימוש בתכונות עיבוד התמונה והטקסט של Gemini API ב-Google כדי לנתח את המצגת ב-Google Slides לפי הנחיות מסוימות, ולראות את הביצועים שלכם ביחס להנחיות האלה. בנוסף, תוכלו להתאים אישית את ההנחיות האלה בהתאם להמלצות של הארגון שלכם, או להזכיר לכם לשפר את המצגות על סמך כללים שאתם מגדירים בעצמכם.

לקבלת סקירה כללית של הפרויקט והסבר איך להרחיב אותו, כולל תובנות מהאנשים שבונים אותו, קראו את המאמר בודק מצגות ב-AI – פיתוח באמצעות Google AI. אם לא, תוכלו להתחיל להרחיב את הפרויקט לפי ההוראות הבאות.

תוסף הייעוץ של Slides שפועל כסרגל צד ב-Google Slides איור 1. תוסף יועץ של Slides ל-Google Slides שפועל כחלונית בסרגל הצד.

הגדרת הפרויקט

בהוראות האלה מוסבר איך להגדיר את פרויקט הייעוץ של Slides לצורכי פיתוח ובדיקה. השלבים הכלליים הם יצירת פרויקט Google Apps Script, הגדרת פרויקט ב-Google Cloud לגישה ל-API והגדרת מאפייני סקריפט מסוימים לפרויקט.

יצירת פרויקט ב-Apps Script

הפרויקט הזה של Slides Advisor פועל כתוסף ל-Google Slides. הגדרת הפרויקט מתבצעת באמצעות ממשק האינטרנט של Google Slides, ויצירה של פרויקט Apps Script עבור הקוד.

כך יוצרים פרויקט חדש ב-Apps Script:

  1. נכנסים לאפליקציית האינטרנט של Slides ל-Google Workspace.
  2. פותחים מצגת קיימת או יוצרים מצגת חדשה.
  3. במצגת של Slides, בוחרים באפשרות תוספים > Apps Script.

אחרי שתבצעו את השלבים האלה, אמור להיות לכם פרויקט ללא שם בממשק המשתמש של Apps Script שמצורף למצגת שבה התחלתם. נותנים שם לפרויקט כדי שיהיה קל יותר למצוא אותו.

כדי לתת שם לפרויקט Apps Script:

  1. בממשק האינטרנט של Apps Script, בוחרים בטקסט פרויקט ללא שם.
  2. בתיבת הדו-שיח של 'שינוי שם הפרויקט', מקלידים: My Slides Advisor ובוחרים באפשרות Rename.

מכינים את קובצי הפרויקט

הפרויקט של Slides Advisor כולל 5 קובצי קוד, ועליכם להגדיר את הקבצים האלה לפני שתוכלו להעתיק את הקוד לפרויקט Apps Script החדש. בקטע הזה מוסבר איך להכין את הפרויקט ולקבל את הקוד.

כדי להכין את קובצי הפרויקט:

  1. פותחים את ממשק האינטרנט של Apps Script שמכיל את הפרויקט My Slides Advisor.
  2. בתפריט השמאלי, בוחרים בתצוגת < > Editor.
  3. כדי לשנות את שם הקובץ Code.gs ל-main.gs, מעבירים את העכבר מעל שם הקובץ של הקוד Code.gs ובוחרים באפשרות Rename בתפריט ההקשר ומזינים main. הממשק מוסיף את תוסף gs .באופן אוטומטי.
  4. כדי להציג את קובץ המניפסט appscript.json של הפרויקט, בוחרים בסמל גלגל השיניים (Project Settings) בתפריט השמאלי, ומפעילים את האפשרות Show "appscript.json" file.
  5. בממשק האינטרנט של Apps Script, בתפריט הימני, בוחרים בתצוגה < > Editor.
  6. כדי ליצור קובץ קוד ui.gs, בוחרים את הסמל + (פלוס) מימין לכותרת Files, בוחרים באפשרות Script ומזינים ui.
  7. חוזרים על השלב הקודם על מנת ליצור את קובצי הקוד slides.gs ו-ai.gs.

פרויקט Apps Script אמור להכיל עכשיו את 5 קובצי הקוד הבאים, שרובם ריקים:

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

בשלב הבא, צריך לקבל את קוד הפרויקט מהמאגר ולהעתיק אותו לפרויקט Apps Script.

קבל את קוד הפרויקט

הקוד של פרויקט הייעוץ של Slides מתארח במאגר קודים. כדי לעבוד איתו, תצטרכו להעתיק את הקוד הזה לפרויקט Apps Script. בקטע הזה נסביר איך למצוא את קוד הפרויקט.

כדי לקבל את קוד הפרויקט:

  1. עוברים למאגר של קוד הפרויקט של קובץ המניפסט של הפרויקט, appsscript.json
  2. צריך להעתיק את התוכן של קובץ הקוד הזה ללוח.
  3. חוזרים לממשק האינטרנט של Apps Script, בוחרים את שם הקובץ appsscript.json ומדביקים את הקוד בחלונית של עורך הקוד ומחליפים את הקוד הקודם.
  4. חוזרים על התהליך הזה עם 4 קובצי הקוד הנוספים:
    • מעתיקים את הקוד main.js לקובץ main.gs.
    • מעתיקים את הקוד ui.js לקובץ ui.gs.
    • מעתיקים את הקוד slides.js לקובץ slides.gs.
    • מעתיקים את הקוד ai.js לקובץ ה-ai.gs.

חיבור פרויקט ב-Google Cloud

בפרויקט הזה נעשה שימוש בפרויקט ב-Google Cloud כדי לגשת למודלים של Gemini AI. ב-Google Cloud יש כללי מדיניות ספציפיים בנושא פרטיות נתונים, וגם מגוון שירותי תוכנה שימושיים לפיתוח אפליקציות כמו Slides Advisor. כדי לחבר את קוד התוסף ל-Gemini API, יוצרים פרויקט ב-Cloud עם גישה ל-AI API, יוצרים חשבון שירות לפרויקט, יוצרים מפתח לחשבון השירות ומתקינים את המפתח הזה בפרויקט של התוסף.

הגדרת פרויקט ב-Cloud

עליכם להפעיל את שירות Vertex AI API בפרויקט Cloud שבו אתם משתמשים כדי להתחבר ל-Gemini API, ותצטרכו ליצור חיבור מאומת מתוסף הייעוץ של Slides לפרויקט הזה. צריך גם להפעיל את החיוב ב-Vertex AI API בפרויקטים שבהם אתם משתמשים בו.

כדי להגדיר פרויקט ב-Cloud עם גישה ל-Vertex AI API:

  1. עוברים אל מסוף Google Cloud ונכנסים לחשבון, אם צריך.
  2. במסוף Google Cloud, בוחרים פרויקט קיים ב-Cloud או יוצרים פרויקט חדש.
  3. בדף מרכז הבקרה במסוף, בחלונית APIs, בוחרים באפשרות Go to APIs overview או עוברים אל https://console.cloud.google.com/apis/.
  4. בחלק העליון של הדף APIs and Services, בוחרים באפשרות + ENABLE APIS AND SERVICES.
  5. בדף API Library, מחפשים את vertex ai api, בוחרים באפשרות Vertex AI API ולוחצים על Enable.
  6. אם היא עדיין לא פעילה, צריך Enable billing לפרויקט שלכם ב-Google Cloud, ואז להפעיל את AI API על ידי לחיצה על הלחצן Enable בדף של מסוף Vertex AI API.
  7. כדי לוודא ש-Vertex AI API מופעל, עוברים לדף APIs and Services של הפרויקט. עכשיו Vertex AI API אמור להופיע בדף הזה.

יצירה של חשבון שירות.

לתוסף הייעוץ של Slides נדרש חיבור מאומת לפרויקט Cloud כדי לגשת ל-Vertex AI API ולמודלים של Gemini. כדי ליצור את החיבור, קודם כול יוצרים חשבון שירות בפרויקט ב-Cloud עם גישה ל-Vertex AI API. פרויקט הייעוץ של Slides מתחבר באמצעות חשבון השירות הזה.

כדי ליצור חשבון שירות לתוסף הייעוץ של Slides:

  1. במסוף Google Cloud, נכנסים לדף APIs and Services של הפרויקט ב-Cloud.
  2. בצד ימין של הדף, בוחרים באפשרות פרטי כניסה.
  3. בחלק העליון של הדף, בוחרים באפשרות + CREATE CREDENTIALS > Service account.
  4. בדף Create service account, בקטע Service account details, מזינים שם לחשבון השירות, מזהה ותיאור.
  5. כדי ליצור את חשבון השירות, לוחצים על Create and Continue (יצירה והמשך).
  6. בקטע הענקת גישה לחשבון השירות הזה לפרויקט, בוחרים את הפקד Role.
  7. בשדה Filter מחפשים את אלה, בוחרים את קבוצת ההרשאות Vertex AI User ואז בוחרים באפשרות Continue.
  8. כדי להשלים את היצירה של חשבון השירות, לוחצים על Done (סיום).

למידע נוסף על יצירת חשבונות שירות, תוכלו לקרוא את המאמר יצירת חשבונות שירות ב-Google Cloud.

יצירה והתקנה של מפתח לחשבון שירות

לפרויקט היועץ ב-Slides צריכה להיות אפשרות לבצע אימות לחשבון השירות שיצרתם בתהליך הקודם. כדי להפעיל את האימות אפשר ליצור מפתח לחשבון השירות ולהגדיר את המפתח בפרויקט Slides של Advisor Apps Script כנכס סקריפט. בתהליך הבא מוסבר איך ליצור את המפתח ולהגדיר אותו בפרויקט.

כדי ליצור ולהגדיר מפתח לחשבון שירות:

  1. במסוף Google Cloud, נכנסים לדף APIs and Services של הפרויקט ב-Cloud.
  2. בצד ימין של הדף, בוחרים באפשרות פרטי כניסה.
  3. בקטע Service Accounts, מאתרים את חשבון השירות שיצרתם, ובוחרים את כתובת האימייל של החשבון או את סמל העיפרון כדי לערוך אותו.
  4. בחלון העריכה של חשבון השירות, ליד החלק העליון של הדף, בוחרים בשם הכרטיסייה KEYS.
  5. בקטע מפתחות, בוחרים באפשרות הוספת מפתח > יצירת מפתח חדש.
  6. בתיבת הדו-שיח Create Private key for..., בוחרים JSON ואז בוחרים באפשרות Create. בשלב הזה יוצרים קובץ מפתח בשם projectid-hashcode.json באופן אוטומטי ומורידים אותו למחשב.
  7. פותחים את הקובץ projectid-hashcode.json שהורדתם ומעתיקים את התוכן שלו.
  8. פותחים את ממשק האינטרנט של Apps Script שמכיל את הפרויקט My Slides Advisor, ובתפריט הימני בוחרים בתצוגה Settings.
  9. בקטע מאפייני סקריפט לוחצים על הלחצן עריכת מאפייני סקריפט ואז לוחצים על הוספת מאפיין סקריפט.
  10. בשדה החדש Property מזינים SERVICE_ACCOUNT_KEY, ובשדה Value מעתיקים את התוכן של הקובץ projectid-hashcode.json שהורדתם.
  11. כדי לשמור את המאפיין החדש, לוחצים על הלחצן שמירה של מאפייני הסקריפט.

למידע נוסף על יצירת מפתחות של חשבונות שירות, תוכלו לקרוא את המאמר יצירה ומחיקה של מפתחות של חשבונות שירות של Google Cloud.

בדיקת הפרויקט של התוסף

חלונית שקפים של Google Workspace עם סמל של יועץ Slides כדי לבדוק את פרויקט הייעוץ של Slides צריך ליצור פריסת בדיקה של קוד התוסף, ולהתקין את הפריסה לבדיקה. בהגדרה הזו של הבדיקה, הפרויקט זמין רק במצגת של Google Slides שבה התחלתם את התוסף של Apps Script בפרויקט, ובאף מצגות אחרות ב-Slides לא. במסמכי התיעוד של Google Workspace Apps Script, בנושא יצירה וניהול של פריסות, מוסבר בהרחבה על פריסת התוסף לשימוש נרחב יותר.

כדי לפרוס ולבדוק את קוד הפרויקט של Apps Script:

  1. בחלק העליון של ממשק האינטרנט של Apps Script, בוחרים באפשרות Deploy > Test deployment (פריסה > בדיקת פריסות).
  2. בתיבת הדו-שיח בדיקת פריסות, ליד Select type לוחצים על סמל גלגל השיניים ואז על התוסף של Google Workspace.
  3. לצד 'אפליקציות': כותרת Slides, בחר בלחצן התקנה.
  4. משאירים את הגדרות ברירת המחדל של בדיקת הקוד האחרון ובוחרים באפשרות סיום.
  5. מנווטים במצגת של Google Slides שמקושרת לפרויקט Apps Script וטוענים מחדש את דף האינטרנט.
  6. בפינה השמאלית התחתונה של אפליקציית האינטרנט של Slides, לוחצים על הסמל ( < ) כדי לפתוח את החלונית הצדדית, ואז לוחצים על סמל העין השחור-לבן על מנת לפתוח את החלונית Slides Advisor.

אחרי שתשלימו את השלב הזה ותפעילו את התוסף בהצלחה, תוכלו להתחיל לשנות אותו כך שישתמשו בהנחיות אחרות או לפעול לפי תהליך עבודה אחר. בחלקים הבאים מוסבר איך לבצע כמה שינויים בסיסיים בתוסף הייעוץ של Slides.

שינוי התנהגות הבדיקה

תוכלו לשנות את התנהגות הבדיקה של היועץ ל-Slides, הן מבחינת הפלט שאתם מקבלים מ-Gemini API, והן מבחינת ממשק המשתמש של התוסף, על-ידי שינוי קוד הפרויקט שלו. המדריך הזה מתמקד בשינוי ההוראות לשליחת בקשות כדי לשנות את ההתנהגות של העברת השקפים במצגת. למידע נוסף על הרחבת ממשק המשתמש של Google Slides באמצעות Apps Script, קראו את המאמר הרחבה של Google Slides.

שינוי הנחיות לבדיקה

הייעוץ של Slides מתוכנת עם קבוצה בסיסית של הנחיות לבדיקת שקפים, עם קטגוריות של פשטות, צבע וטיפוגרפיה, מבנה ורווחים לבנים, וגרפיקה וסמלים. הנחיות הבדיקה הן רק הוראות טקסט שכלולות בהנחיה דרך Gemini API, יחד עם תמונת מצב של השקף שנבחר והערות הדובר.

כדי לשנות את התנהגות הבדיקה של התוסף, תוכלו לשנות את הוראות הטקסט. לדוגמה, תוכלו להורות למודל Gemini ליצור פלט של הביקורת עם דירוג הקטגוריה באותה שורה כמו כותרת הקטגוריה, או לשנות את שם הקטגוריה.

כדי לשנות את המיקום של סיווג הקטגוריה ואת שם הקטגוריה:

  1. פותחים את ממשק האינטרנט של Apps Script שמכיל את הפרויקט My Slides Advisor. אם יש צורך, נכנסים לחלון של הפרויקט, פותחים את המצגת של Google Slides שמכילה את הפרויקט של Apps Script ובוחרים באפשרות תוספים > Apps Script.
  2. בתפריט בצד שמאל, בוחרים בתצוגת < > Editor ואז בוחרים בשם הקובץ ai.gs.
  3. בקובץ הקוד ai.gs, מאתרים את קבוע המחרוזת SYSTEM_PROMPT ומשנים את ההוראות לפי הטקסט הבא: 
    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. באותו קבוע של מחרוזת SYSTEM_PROMPT, משנים את הטקסט של הקטגוריה Simplicity ל-Message:
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. שומרים את השינויים בקובץ הקוד ai.gs.
  6. תוכלו לנווט במצגת של Google Slides שמקושרת לפרויקט Apps Script, לטעון מחדש את דף האינטרנט ולהפעיל מחדש את השינויים בתוסף.

אם עדיין לא הגדרתם פריסת בדיקה לתוסף הייעוץ של Slides, בצעו את ההוראות שמופיעות במאמר בדיקת הפרויקט של התוסף.

אפשר להסיר, להחליף או לשכתב את ההוראות לקטגוריית הביקורת בקבוע של המחרוזת SYSTEM_PROMPT, בהתאם לדרישות לגבי הבדיקה. אם תרצו לנסות גישות שונות של הנחיות לבדיקה או לשכתב את כל בקשת הבדיקה, תוכלו להשתמש באפליקציית האינטרנט של Google AI Studio. האפליקציה הזו מאפשרת ליצור אב טיפוס להנחיות של Gemini, לבדוק ולשמור אותן בממשק נוח, ומשתמשת באותו ממשק Gemini API שבו נעשה שימוש בפרויקט Slides Advisor. למידע נוסף על השימוש ב-AI Studio, תוכלו לעיין במדריך למתחילים של AI Studio.

שינוי ההגדרה של התנהגות המודל

ל-Gemini API יש כמה הגדרות לשינוי הפעולה הכללית של המודל בתגובה לבקשת בקשה. באופן ספציפי, הגדרת הטמפרטורה של המודל מאפשרת לקבוע את מידת השונות שמותרת במודל בתגובה, כאשר 0 היא הנמוכה ביותר ו-1 היא הגבוהה ביותר. הגדרת הערך כ-0.1 מניבה תשובות עקביות מאוד, אבל ההתנהגות הזו יכולה להיראות חוזרת על עצמה ופחות מועילה למשתמשים שמקבלים משוב על ביקורות. כדאי לשקול להגדיר ערך גבוה יותר לטמפרטורה, ולזכור שככל שהטמפרטורה גבוהה יותר, כך התוצאות לא עקביות יותר. כתוצאה מכך, יכול להיות שיישום ההוראות יהיה שונה, ואפילו התעלמות מחלק מההוראות לגמרי.

כדי להעלות את הטמפרטורה של תגובות לביקורות:

  1. פותחים את ממשק האינטרנט של Apps Script שמכיל את הפרויקט My Slides Advisor.
  2. בתפריט בצד שמאל, בוחרים בתצוגת < > Editor ואז בוחרים בשם הקובץ ai.gs.

  3. בקובץ הקוד ai.gs, מאתרים את הפונקציה analyzeSlides() ומשנים את הקבוע generationConfig על ידי הגדרת הערך temperature ל-0.3:

    function analyzeSlides(slide) {

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

  4. שומרים את השינויים בקובץ הקוד ai.gs.

  5. תוכלו לנווט במצגת של Google Slides שמקושרת לפרויקט Apps Script, לטעון מחדש את דף האינטרנט ולהפעיל מחדש את השינויים בתוסף.

למידע נוסף על ההגדרות של התנהגות המודלים, עיינו במסמכי התיעוד של Gemini API עבור GenerationConfig.

מקורות מידע נוספים

במאגר הקודים תוכלו לקרוא מידע נוסף על הפרויקט של Slides Advisor. אם אתם צריכים עזרה בפיתוח האפליקציה או רוצים לשתף פעולה עם מפתחים אחרים, תוכלו להיעזר בשרת Google Developers Community Discord. לפרויקטים נוספים של Build with Google AI תוכלו למצוא בפלייליסט של הסרטונים.