TovCode · טוב טק

משימת הכניסה

משימה אחת בבית, בקצב שלך, שאמורה לקחת שעה עד שעתיים. בונים כלי קטן שמדבר עם Gemini, מביאים אותו למצב שהוא באמת עובד ולא רק נראה עובד, ומעלים אותו לאינטרנט.

זמן משוער: שעה עד שעתיים ידע מוקדם: לא נדרש עזרה מ-AI: מותרת ורצויה עלות: אפס ההגשה: קישור חי שעובד

מה בונים

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

הכל יושב בקובץ אחד בשם index.html. אין שרת, אין התקנות, אין בניית פרויקט. לוחצים פעמיים על הקובץ והוא נפתח בדפדפן כמו כל אתר.

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

איך זה נראה בסוף

הדמיה של המוצר המוגמר

index.html
מפתח API
AIza••••••••••••••••••••••••
השאלה שלי
כמה זמן לוקח לאפות פוקצ'ה?
שאל
התשובה בערך שלוש שעות בסך הכל, מתוכן כשעתיים וחצי של תפיחה ללא מגע יד, ו-25 דקות בתנור.

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

מה קורה כשמשתמשים בו

1

בפעם הראשונה מדביקים את המפתח בשדה העליון. מהפעם השנייה הוא כבר שם, הדף זוכר אותו.

2

כותבים שאלה חופשית בשדה השני ולוחצים על הכפתור.

3

במשך שתיים עד חמש שניות רואים סימן שהמערכת עובדת, כי התשובה נוסעת לשרת של גוגל וחוזרת.

4

התשובה נכתבת מתחת. שואלים שאלה חדשה, ומקבלים תשובה חדשה במקומה.

5

אם משהו השתבש, מפתח שגוי או אין אינטרנט, מופיע משפט בעברית שמסביר מה קרה.

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

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

חמש הדרישות

לכל דרישה יש בדיקה שאתה מריץ בעצמך. אל תסמן דרישה כהושלמה כי ה-AI אמר לך שהיא הושלמה, אלא רק אחרי שבדקת.

א

שאלה נכנסת, תשובה יוצאת

שדה טקסט, כפתור, והתשובה של Gemini מופיעה על המסך.

בדיקה: תשאל שתי שאלות שונות זו אחר זו. התשובה השנייה אמורה להיות שונה מהראשונה, ולא להתווסף מתחתיה בטעות.
ב

את המפתח מדביקים לדף, לא לתוך הקובץ

ה-AI כמעט תמיד ייתן לך קוד עם שורה בסגנון const API_KEY = "כאן_המפתח_שלך", ויגיד לך להדביק את המפתח שם. אנחנו רוצים אחרת: הקובץ נשאר בלי מפתח בכלל, ובדף יש שדה שאליו מדביקים אותו, והדפדפן זוכר אותו לפעם הבאה.

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

בדיקה: פתח את הקובץ בעורך טקסט וחפש בו AIza. אם המפתח מופיע שם, הדרישה לא מולאה.
ג

רואים שמשהו קורה בזמן ההמתנה

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

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

כשמשהו נשבר, כתוב מה נשבר

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

בדיקה: תמחק תו אחד מהמפתח ותשלח שאלה. אתה אמור לראות הסבר, לא כלום.
ה

הדף חי באינטרנט, בכתובת שאפשר לשלוח

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

שים לב לקשר בין הדרישה הזו לדרישה ב': ברגע שהדף באינטרנט, כל מי שפותח אותו מקבל את הקובץ שלך. אם המפתח בתוכו, הוא עכשיו פומבי לעולם. לכן קודם ב', ואז ה'.

בדיקה: תשלח לעצמך את הכתובת, תפתח אותה בטלפון, תדביק שם את המפתח ותשאל שאלה. אם קיבלת תשובה, הדרישה מולאה.

לפני שמתחילים, שלושה דברים חשובים

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

השלבים

  1. 1

    להוציא מפתח API של Gemini

    נכנסים ל-aistudio.google.com/apikey, מתחברים עם חשבון Google רגיל, ולוחצים על יצירת מפתח חדש. זה חינם ולא דורש כרטיס אשראי. המפתח הוא מחרוזת ארוכה שמתחילה ב-AIza.

    תקוע כאן מעל עשרים דקות? זה לא חלק מהמבחן. תשלח מייל ותקבל מאיתנו מפתח זמני, ותמשיך משלב 2.

  2. 2

    לבקש מ-AI, ולהגיע לדף שנפתח

    פותחים ChatGPT או Claude או Gemini, ומנסחים את הבקשה בעצמך. אין כאן טקסט מוכן להעתקה, וזה במכוון: היכולת להסביר למכונה מה אתה רוצה היא המיומנות הראשונה שהתוכנית בנויה עליה.

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

    מדביקים את הקוד שחוזר לקובץ טקסט, שומרים בשם index.html, ופותחים בדפדפן בלחיצה כפולה. אם ה-AI לא הסביר איך עושים את זה, תשאל אותו שוב. שאלה כזו לגיטימית לגמרי.

    לא חייבים לקבל הכל בבקשה אחת. אפשר לבקש קודם גרסה מינימלית שרק מחזירה תשובה, ורק אחר כך להתקדם לשאר הדרישות.

  3. 3

    לעבור על הדרישות א' עד ד' אחת אחת

    זה הלב של המשימה. לכל דרישה: מריצים את הבדיקה שכתובה לידה, ואם היא נכשלת, חוזרים ל-AI ומתארים בדיוק מה ראית. לא "זה לא עובד", אלא "לחצתי שלוש פעמים וקיבלתי שלוש תשובות מעורבבות, תתקן".

    סביר שתעשה כאן חמישה עד חמישה עשר סבבים. זה נורמלי ומצופה. דרישה ה', ההעלאה לאינטרנט, מחכה לשלב 5 ורק אחרי שארבע אלה עובדות.

  4. 4

    לבחור שלוש שורות ולהסביר אותן במילים שלך

    מתוך הקוד שיצא, בוחרים שלוש שורות ומסבירים בכתב מה כל אחת עושה. מותר לשאול את ה-AI מה השורה עושה, ואז לכתוב את זה במילים שלך. אסור להעתיק את ההסבר שלו כמו שהוא.

    זה החלק שמבדיל בין מי שקיבל קוד לבין מי שיודע מה יש לו ביד. זה לא מבחן ידע, הסבר בשפה יומיומית מספיק לגמרי.

  5. 5

    להעלות את הדף לאינטרנט

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

    לפני שמעלים, ודא שדרישה ב' באמת מולאה: חפש AIza בקובץ. אתה עומד להפוך אותו לפומבי.

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

  6. 6

    צילום מסך, וביטול המפתח

    מצלמים את המסך של האתר החי, כשרואים בו שאלה ותשובה. אחר כך חוזרים ל-aistudio.google.com/apikey ומוחקים את המפתח שיצרת. סגירת מפתח בסיום היא חלק מהמקצוע, ולכן חלק מהמשימה.

    האתר יישאר באוויר גם אחרי שהמפתח נמחק, פשוט לא תחזור ממנו תשובה. זה בסדר וזה מה שאנחנו מצפים לראות.

  7. 7

    לענות על ארבע שאלות

    בכתב, בשפה חופשית, כמה משפטים לכל שאלה. אין תשובה נכונה, ואנחנו קוראים את זה בעיניים.

    1. איזו מחמש הדרישות הייתה הקשה ביותר, ומה בדיוק קרה שם?
    2. תאר מקרה אחד שבו ה-AI אמר לך שתיקן משהו, ובדקת וגילית שלא. איך גילית?
    3. מה הייתה הודעת השגיאה הראשונה שקיבלת, ומה עשית איתה?
    4. אם היו נותנים לך עוד שעה, מה היית מוסיף לכלי?
  8. 8

    לשלוח

    שולחים במייל ל-raz@tovtech.org שישה דברים:

    1. הכתובת של האתר החי. זה הפריט הראשון שנפתח אצלנו, ובלעדיו אין הגשה.
    2. קובץ ה-HTML
    3. צילום המסך
    4. הבקשה הראשונה שכתבת ל-AI, העתק והדבק כמו שהיא
    5. הסבר שלוש השורות
    6. התשובות לארבע השאלות

אם נתקעת

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

403 / API key not valid

המפתח לא הודבק נכון, או שהודבק עם רווח או מרכאות מיותרות.

404 / model not found

שם המודל בקוד לא קיים. תשאל את ה-AI מה שם המודל העדכני של Gemini ותבקש שיעדכן.

הכפתור לא מגיב

פותחים בדפדפן את כלי הפיתוח (F12), לשונית Console, ומעתיקים משם את הטקסט האדום.

התשובה חוזרת ריקה

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

המפתח נשכח בכל רענון

הדף לא באמת שומר אותו. תאר ל-AI מה קרה ותבקש שישמור בדפדפן.

הדף עלה, אבל נפתח ריק

ברוב המקרים הקובץ לא נקרא index.html, או שהועלה בתוך תיקייה נוספת. תבדוק את השם ואת המיקום.

באתר החי המפתח לא שם

זה תקין ולא תקלה. הדפדפן שומר את המפתח לכל כתובת בנפרד, והאתר החי הוא כתובת חדשה. פשוט תדביק אותו שם פעם אחת.

תקוע מעל שעה על אותה דרישה ולא זז? תשלח מייל עם צילום מסך של מה שאתה רואה ומה ניסית. גם זו הגשה תקפה, ואנחנו נענה.

איך זה נבדק

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

עובר

חמש הדרישות עובדות בפועל, הקישור החי נפתח ומחזיר תשובה, והסבר שלוש השורות מראה שאתה מבין מה יש לך ביד.

לשיחה

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

לא עובר

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

שים לב למה שלא נמצא ברשימה: מהירות, איכות הקוד, יופי של הדף, וכמה שאלות שאלת את ה-AI. שום דבר מזה לא נספר.

למה דווקא המשימה הזאת