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

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

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

לצפייה בסרטון סקירה כללית של הפרויקט והסבר על הארכתו, כולל תובנות מהאנשים שיצרו את הקובץ, כדאי לקרוא את המאמר בודק של AI Slides – Build with Google ב-AI. אחרת, תוכלו להתחיל להרחיב את הפרויקט בהתאם להוראות.

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

הגדרת פרויקט

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

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

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

כדי ליצור פרויקט Apps Script חדש:

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

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

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

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

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

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

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

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

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

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

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

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

הקוד של פרויקט Slides Advisor מתארח במאגר קוד. שלך תצטרכו להעתיק את הקוד הזה לפרויקט 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 ענן מספק פרטיות נתונים ספציפית המדיניות וגם במגוון שירותי תוכנה שימושיים כמו Slides Advisor. מקשרים את קוד התוסף ל-Gemini API באמצעות יצירת פרויקט ענן עם גישה ל-AI API, יצירת חשבון שירות עבור יצירת מפתח לחשבון השירות, והתקנת המפתח הזה בפרויקט של התוסף.

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

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

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

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

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

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

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

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

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

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

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

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

  1. במסוף Google Cloud, נכנסים אל הדף ממשקי API ושירותים עבור את הפרויקט ב-Cloud.
  2. בצד ימין של הדף, בוחרים באפשרות Credentials.
  3. בקטע Service Accounts, מאתרים את חשבון השירות שנוצר, בוחרים את כתובת האימייל של החשבון או את סמל העיפרון כדי לערוך אותו.
  4. בחלון העריכה של חשבון השירות, בחלק העליון של הדף, בוחרים כותרת הכרטיסייה KEYS.
  5. בקטע Keys, בוחרים באפשרות Add Key > (הוספת מפתח). יצירת מפתח חדש.
  6. בתיבת הדו-שיח Create private key for... בוחרים באפשרות JSON ואז יצירה. בשלב הזה נוצר קובץ מפתח בשם projectid-hashcode.json ויוריד אותו באופן אוטומטי למחשב שלך.
  7. פותחים את קובץ JSON projectid-hashcode.json שהורדתם ומעתיקים את התוכן שלו.
  8. פותחים את ממשק האינטרנט של Apps Script שמכיל את היועץ של My Slides בפרויקט ובתפריט הימני, בוחרים בתצוגה Settings (הגדרות).
  9. בקטע Script Properties, בוחרים את Edit script המאפיינים ואז על הלחצן הוספת מאפיין סקריפט.
  10. בשדה נכס החדש, מזינים SERVICE_ACCOUNT_KEY. ערך – מעתיקים את תוכן הקובץ שהורדתם. קובץ projectid-hashcode.json.
  11. לוחצים על הלחצן Save script properties (שמירת מאפייני הסקריפט) כדי לשמור את הנכס החדש.

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

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

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

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

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

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

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

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

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

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

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

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

  1. פותחים את ממשק האינטרנט של Apps Script שמכיל את היועץ של My Slides פרויקט. אם יש צורך, מנווטים לחלון הפרויקט באמצעות לחיצה על מצגת ב-Slides שמכילה את פרויקט Apps Script ובחירת תוספים > Apps Script.
  2. בתפריט הימני, בוחרים בסמל < > תצוגת עריכה ובוחרים באפשרות 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 Advisor, פועלים לפי ההוראות בודקים את פרויקט התוסף.

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

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

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

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

  1. פותחים את ממשק האינטרנט של Apps Script שמכיל את היועץ של My Slides פרויקט.
  2. בתפריט הימני, בוחרים בסמל < > תצוגת עריכה ובוחרים באפשרות 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, אפשר לעיין מאגר קוד. אם אתם צריכים עזרה בפיתוח האפליקציה או שאתם רוצים לשתף פעולה עם מפתחים אחרים, כדאי לבדוק שרת Google Developers Community Discord. בפרויקטים נוספים של Build with Google AI, אפשר לעיין פלייליסט של סרטונים.