רוויט ובינה מלאכותית: לבנות כלים משלכם בעברית

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

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

---

1. איפה רוויט עומד ב-2026: שני מסלולים שונים לגמרי

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

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

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

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

2. pyRevit: למה דווקא הוא השער

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

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

המבנה נראה בערך כך, וזה נראה מפחיד יותר ממה שהוא:

MyTools.extension\MyTab.tab\Demo.panel\TagAllRooms.pushbutton\script.py

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

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

3. לבנות כפתור מתיאור בעברית

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

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

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

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

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

4. מה יש בתוך הכפתור, ולמה זה משנה

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

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

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

5. מהתצוגה הריקה עד הגיליון

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

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

6. מה שלא עבד: הגשר החי שירד מהמצגת

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

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

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

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

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

7. השלב שהשבתתי בכוונה

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

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

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

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

8. המלכודות

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

ה-hooks שמאטים לכם את רוויט כבר עכשיו

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

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

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

עברית שיוצאת ג'יבריש

pyRevit על רוויט 2025 רץ על IronPython 2.7.12, שהיא גרסה ישנה של פייתון. בגרסה הזאת מחרוזת רגילה היא רצף בייטים ולא טקסט, ולכן מילה עברית שנכתבה בקוד באופן הרגיל תוצג ברוויט כאוסף סימנים חסרי משמעות.

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

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

הכפתור קיים רק אצלכם

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

עדכון גרסה הוא אירוע

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

9. סקצ'אפ ושאר התוכנות, בקצרה

רוויט הוא לא היחיד, ושווה לדעת איפה עומדות השאר.

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

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

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

10. איך זה הופך לכלי של המשרד

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

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

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

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

---

שאלות ותשובות