RomanNum3ral
/
AI-For-Beginners
mirror of https://github.com/microsoft/AI-For-Beginners.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AI-For-Beginners/translations/he/troubleshoot.md

9.6 KiB
Raw Blame History

מדריך פתרון תקלות ל-AI-For-Beginners

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

תוכן עניינים

בעיות כלליות

1. המאגר לא משוכפל כראוי

רקע: שכפול מאפשר לכם להעתיק את המאגר למחשב שלכם.

תסמינים:

  • שגיאה: fatal: repository not found
  • שגיאה: Permission denied (publickey)

סיבות אפשריות:

  • כתובת URL שגויה של המאגר
  • הרשאות לא מספקות
  • מפתחות SSH לא מוגדרים

פתרונות:

  1. בדקו את כתובת ה-URL של המאגר.
    השתמשו בכתובת HTTPS: 
    git clone https://github.com/microsoft/AI-For-Beginners.git
  2. עברו ל-HTTPS אם SSH נכשל.
    אם אתם רואים Permission denied (publickey), השתמשו בקישור HTTPS במקום SSH.
  3. הגדירו מפתחות SSH (אופציונלי).
    אם אתם רוצים להשתמש ב-SSH, עקבו אחרי המדריך של GitHub ל-SSH.

בעיות התקנה

2. בעיות בסביבת Python

רקע: המאגר תלוי ב-Python ובספריות שונות.

תסמינים:

  • שגיאה: ModuleNotFoundError: No module named '<package>'
  • שגיאות ייבוא בעת הרצת סקריפטים או מחברות

סיבות אפשריות:

  • תלות שלא הותקנה
  • גרסת Python שגויה

פתרונות:

  1. הגדירו סביבת עבודה וירטואלית. 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. התקינו את התלויות. 
    pip install -r requirements.txt
  3. בדקו את גרסת Python.
    השתמשו ב-Python 3.7 או חדש יותר. 
    python --version

3. Jupyter לא מותקן

רקע: מחברות הן משאב לימודי מרכזי.

תסמינים:

  • שגיאה: jupyter: command not found
  • מחברות לא נפתחות

סיבות אפשריות:

  • Jupyter לא מותקן

פתרונות:

  1. התקינו את Jupyter Notebook. 
    pip install notebook
    או, אם אתם משתמשים ב-Anaconda: 
    conda install notebook
  2. הפעילו את Jupyter Notebook. 
    jupyter notebook

4. קונפליקטים בגרסאות תלות

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

תסמינים:

  • שגיאות או אזהרות על גרסאות לא תואמות

סיבות אפשריות:

  • חבילות Python ישנות או מתנגשות

פתרונות:

  1. התקינו בסביבה נקייה.
    מחקו venv/conda env ישן וצרו חדש.
  2. השתמשו בגרסאות מדויקות.
    תמיד הריצו: 
    pip install -r requirements.txt
    אם זה נכשל, התקינו ידנית חבילות חסרות כפי שמתואר ב-README.

בעיות הגדרה

5. משתני סביבה לא מוגדרים

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

תסמינים:

  • שגיאה: KeyError או אזהרות על קונפיגורציה חסרה

סיבות אפשריות:

  • משתני סביבה נדרשים לא הוגדרו

פתרונות:

  1. בדקו קבצים כמו .env.example או דומים.
  2. צרו קובץ .env ומלאו את הערכים הנדרשים.
  3. טענו מחדש את הטרמינל או ה-IDE לאחר הגדרת משתני הסביבה.

הרצת מחברות

6. מחברת לא נפתחת או לא רצה

רקע: מחברות Jupyter דורשות הגדרה נכונה.

תסמינים:

  • מחברת לא נפתחת
  • דפדפן לא נפתח אוטומטית

סיבות אפשריות:

  • Jupyter לא מותקן
  • בעיות בהגדרות הדפדפן

פתרונות:

  1. התקינו את Jupyter (ראו בעיות התקנה לעיל).
  2. פתחו מחברות ידנית.
    • העתיקו את כתובת ה-URL מהטרמינל (לדוגמה, http://localhost:8888/?token=...) והדביקו אותה בדפדפן שלכם.

7. קריסת או הקפאת Kernel

רקע: Kernel של מחברת יכול לקרוס עקב מגבלות משאבים או שגיאות בקוד.

תסמינים:

  • Kernel מת או מופעל מחדש שוב ושוב
  • שגיאות זיכרון

סיבות אפשריות:

  • מערכי נתונים גדולים
  • קוד או חבילות לא תואמים

פתרונות:

  1. הפעילו מחדש את ה-Kernel.
    השתמשו בכפתור "Restart Kernel" ב-Jupyter.
  2. בדקו את שימוש הזיכרון.
    סגרו יישומים לא בשימוש.
  3. הריצו מחברות בפלטפורמות ענן.
    השתמשו ב-Google Colab או Azure Notebooks.

בעיות ביצועים

8. מחברות רצות לאט

רקע: חלק ממשימות AI דורשות זיכרון ו-CPU משמעותיים.

תסמינים:

  • ביצוע איטי
  • מאוורר המחשב הנייד פועל בעוצמה

סיבות אפשריות:

  • מערכי נתונים או מודלים גדולים
  • משאבי מערכת מוגבלים

פתרונות:

  1. השתמשו בפלטפורמת ענן.
    • העלו את המחברת ל-Colab או Azure Notebooks.
  2. הקטינו את גודל מערך הנתונים.
    • השתמשו בנתוני דוגמה לתרגול.
  3. סגרו תוכניות מיותרות.
    • שחררו זיכרון RAM במערכת.

בעיות באתר הספר הלימודי

9. פרק לא נטען

רקע: הספר הלימודי המקוון מציג שיעורים ופרקים.

תסמינים:

  • פרק (לדוגמה, Transformers/BERT) חסר או לא נפתח

בעיה ידועה:

  • בעיה #303: “18 Transformers. BERT. can't be opened on the textbook website.” נגרם משגיאה בשם קובץ (READMEtransformers.md במקום README.md).

פתרונות:

  1. בדקו שגיאות בשם קובץ.
    אם אתם תורמים, ודאו שקבצי הפרקים נקראים README.md.
  2. דווחו על קבצים חסרים.
    פתחו בעיית GitHub עם שם הפרק ופרטי השגיאה.

בעיות תרומה

10. PR לא התקבל או בניות נכשלות

רקע: תרומות חייבות לעבור בדיקות ולעמוד בהנחיות.

תסמינים:

  • בקשת משיכה נדחתה
  • שגיאות בצנרת CI/CD

סיבות אפשריות:

  • בדיקות נכשלות
  • אי עמידה בסטנדרטים של קוד

פתרונות:

  1. קראו את הנחיות התרומה.
  2. הריצו בדיקות מקומית לפני דחיפה.
  3. בדקו כללי linting או דרישות עיצוב.

שאלות נפוצות

איפה אני יכול למצוא עזרה למודולים ספציפיים?

  • לכל מודול בדרך כלל יש README משלו. התחילו שם לקבלת טיפים להגדרה ושימוש.

איך אני מדווח על באג או מבקש תכונה?

האם אני יכול לבקש עזרה אם הבעיה שלי לא מופיעה כאן?

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

קבלת עזרה

  • בדקו בעיות: בעיות GitHub
  • שאלו שאלות: השתמשו בדיונים ב-GitHub או פתחו בעיה.
  • קהילה: ראו קישורי המאגר לאפשרויות צ'אט/פורום.

עודכן לאחרונה: 2025-09-20

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