ממשקי משתמשים (Web)
מה זה?
”ממשקי משתמשים“ הם אוסף מסכים ותהליכים אינטראקטיביים ב‑WebApp שמאפשרים לבצע פעולות מורכבות בנוחות: טפסים ממוקדים, אשפים רב‑שלביים, ותצוגות מצב. הפיצ’ר מיועד גם לשימוש ישיר ע“י משתמשי קצה וגם להפעלה מונחית ע“י סוכני AI.
היכן זה נמצא?
בבוט: תפריט ראשי > ”ממשקי משתמשים (web 🌐)“ – פתיחת דפי ה‑WebApp הרלוונטיים בדפדפן.
ב‑WebApp: פריטי תפריט ייעודיים יוצגו בהתאם להרשאות ולזמינות פיצ’רים.
מסכים בולטים
Code Execution Playground:
/tools/code(פתוח לכל משתמש מחובר; הרצת קוד Premium/Admin בלבד +FEATURE_CODE_EXECUTION=true). לפרטים מלאים (אבטחה, API, מגבלות, ותפעול) ראו הרצת קוד (Code Execution Playground).
זרימת עבודה דרך הבוט
הבוט פועל כ‑Launcher ל‑WebApp ומספק קישורים ישירים למסכים. הזרימה הטיפוסית לסוכן AI:
פתיחה מהירה: בתפריט הראשי לחצו ”ממשקי משתמשים (web 🌐)“.
מעבר למסך היעד: בחרו תהליך/טופס נדרש.
מילוי שדות חובה ושליחה.
מעקב אחר חיווי מצב (התקדמות/הצלחה/כשל) והנחיות המשך.
שדות חובה ולוגיקת ולידציה
שדות חובה מסומנים בכוכבית (*) ומאומתים בצד הלקוח לפני שליחה.
ערכים לא חוקיים יציגו הודעת שגיאה צמודה לשדה. שליחה נחסמת עד לתיקון.
הודעות שגיאה אינן מכילות מידע רגיש; ערכים רגישים מושחרים בלוגים.
חיווי מצב תהליך
In‑Progress: מחווני טעינה/התקדמות.
Success: חיווי ”בוצע“ וקישור להמשך פעולה (לדוגמה: צפייה בפריט/חזרה לרשימה).
Failure: הודעת כשל עם קוד שגיאה קצר וטיפים לפתרון.
ממשק אדמין
הרשאות: גישה מותנית ב‑ADMIN_USER_IDS או מדיניות הרשאות ארגונית.
ניהול: צפייה/אישור/דחייה של בקשות, עדכון תצורה נקודתית.
תצפיות: מומלץ להצליב עם דפי Observability (אובזרווביליות (Observability), Rate Limiting, מדדים (Metrics)) בעת תחקור תקלות.
דוגמאות שימוש לסוכני AI
פתיחת זרימה: ”פתח/י את »ממשקי משתמשים (web 🌐)« ובחר/י בתהליך הרלוונטי“.
מילוי טופס: ”מלא/י את כל השדות המסומנים ב‑
*; עצור/י על שגיאה, הצג/י טקסט שגיאה קצר והצע/י ערך תקין“.מעקב הצלחה: ”וודא/י שהתקבל חיווי Success; אם לא – הבטח/י פעולה מתקנת בהתאם לטיפים על המסך“.
אבטחה ופרטיות
אין לרשום סודות/PII בטפסים שאינם מיועדים לכך; שימוש במנהל הסודות בלבד.
לוגים ודשבורדים אינם מציגים ערכים גולמיים רגישים; יש השחרה אוטומטית.
הערות תאימות
זמינות מסכים עשויה להשתנות בין סביבות; ייתכנו דפים ניסיוניים בהדרגה.
קישורי הבוט יפתחו בדפדפן ברירת המחדל של המשתמש.