Case Study · כלי חי בפרודקשן · 2026

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

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

הארכיטקטורה, ההחלטות והבקרה - שלי. את הקוד כתבתי עם Claude, בהנחיות ובבדיקות שלי.

2
סוכני AI בשיחה אחת
10
קריטריוני איכות גלויים
0
הרשמה ומפתחות בצד המשתמש
2-3
אפיונים ביום למשתמש - עלות חסומה
אילת שחק שול · Operations & Systems Leader
פרק 1 - המטרה

הבעיה: רעיונות אוטומציה מגיעים עמומים

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

הבעיה התפעולית

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

מטרות הפרויקט
1
אפיון מובנה בדקות: מתיאור חופשי למסמך עם מטרה מכומתת, טריגר, מפת נתונים, מקרי קצה והמלצת כלים
2
בקרת איכות אמיתית - וגלויה: סוכן שני בודק כל מסמך מול 10 קריטריונים, והבדיקה מוצגת למשתמש קריטריון-קריטריון
3
תשתית מינימלית ומאובטחת: דף סטטי + Edge Function אחת שמחזיקה את המפתח והפרומפטים בצד השרת - בלי בסיס נתונים ובלי מערכת ניהול
4
אפס חיכוך: בלי הרשמה ובלי מפתחות - כותבים רעיון ומתחילים; מצב דוגמה למי שרוצה רק להציץ
5
תוצר מקצועי להורדה: המסמך יורד כ-PDF מעוצב - מוכן לשליחה לספק או לצוות

פרק 2 - איך זה עובד

שני סוכנים, לולאת בקרה אחת

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

משתמש רעיון בשפה חופשית סוכן מאפיין 6-4 שאלות הבהרה טיוטת אפיון לא מוצגת עדיין 🛡️ Gatekeeper 10 קריטריונים + כל השיחה ✓ אושר כרטיס אפיון + ייצוא PDF נדרש תיקון - חוזר למאפיין (עד 2 סבבים) כל הבדיקה גלויה: המשתמש רואה checklist חי של 10 הקריטריונים מסתמן ✓/✗ קריטריון אחרי קריטריון, כולל נימוק לכל כשל וסטטוס סבבי התיקון הדפדפן מדבר רק עם פרוקסי צד-שרת (Edge Function) - המפתח והפרומפטים לא נחשפים למשתמש
1
תיאור חופשי

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

2
4-6 שאלות הבהרה - שאלה אחת בכל פעם

הסוכן המאפיין חייב לשאול גם שאלת עומק אחת לפחות: מה קורה עם הנתונים אחרי האיסוף? התשובות מוזרמות למסך בזמן אמת (streaming).

3
טיוטת אפיון - נכתבת אבל לא מאושרת

המסמך כולל: מטרה עסקית מכומתת, טריגר ותוצאה, מפת נתונים, 3 מקרי קצה ספציפיים, והמלצת כלים מודולרית (MVP + הרחבות + סקלביליות).

4
Gatekeeper בודק - מול העיניים

הסוכן השני מקבל את כל שיחת האפיון + המסמך, ומחזיר פסק דין מובנה (JSON) על 10 קריטריונים. המשתמש רואה checklist חי שמסתמן קריטריון-קריטריון.

5
תיקון אוטומטי או אישור

כשל מחזיר את המסמך למאפיין עם הנימוק המדויק (עד 2 סבבים). רק מסמך שעבר מוצג ככרטיס מעוצב - עם תג "נבדק על ידי Gatekeeper" והורדה כ-PDF.

פרק 3 - בקרת האיכות בפועל

הרגע שבו הסוכן השני תפס את הראשון

מריצת אמת, לא מדמו: ה-Gatekeeper זיהה פרט שהמודל המציא - ועצר את המסמך

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

🛡️ Gatekeeper - בקרת איכות (9 קריטריונים)
נמצא ליקוי אחד - המסמך הוחזר לתיקון (סבב 1 מתוך 2)

שחזור של מסך הבדיקה מריצת האמת, שרצה בגרסת 9 הקריטריונים (כיום 10 - נוסף קריטריון עלות שוטפת) · המסמך תוקן אוטומטית ואושר בסבב הבא

למה זה חשוב: בקרת איכות שרק מאשרת היא תיאטרון. ה-✗ האדום עם הנימוק הוא מה שנותן משמעות לכל ה-✓ הירוקים - והשקיפות נשמרת גם אחרי התיקון: המסמך הסופי מסומן "אושר אחרי סבב תיקון אחד". כמו ב-CI Pipeline או ב-Code Review - אף אחד לא מסתיר את הבדיקה האדומה, כי היא מה שמקנה אמון בירוקה.


מה בודקים 10 הקריטריונים

לא פורמט - מהות

האבחון המקורי מצא Gatekeeper שבודק רק מבנה. הגרסה הנוכחית בודקת תוכן

1
מבנה מלא: 6 סעיפים + משפט סגירה מדויק
2
מטרה מכומתת: לפחות אומדן מספרי אחד (זמן/כסף/תדירות) - "ייעול תהליכים" בלי מספר נכשל
3
מקרי קצה ספציפיים: בדיוק 3, שנובעים מהתהליך שתואר - "שגיאת מערכת" גנרית נכשלת
4
נתונים אחרי האיסוף: המסמך עונה מה עושים עם המידע - דוח, התראה או תיעוד מודע
5
עקביות עם השיחה: אין קביעות שסותרות תשובות ואין פרטים מומצאים - הקריטריון שתפס את ההזיה
6
פתרון מדף + מודולריות: נשקל כלי קיים לפני בנייה, והפתרון בנוי כ-MVP + הרחבות עם תנאי סף
7
סקלביליות: מה קורה בגידול פי 5-10, ואיפה נקודת השבירה
8
מטרה מדברי המשתמש: הבעיה והמחיר שלה נלקחים מתשובות המשתמש - לא מהנחות רקע של הסוכן
9
מדד הצלחה: מדד אחד מדיד עם מסגרת זמן, מעוגן בתשובת המשתמש
10
מבנה עלות שוטפת: לכל כלי מומלץ - ללא עלות / חינמי עד מדרגה / לפי שימוש, בלי סכומים מומצאים

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

פרק 4 - החלטות ארכיטקטורה

מה נדחה - ולמה

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

אלטרנטיבה שנשקלה למה נפסלה מה נבחר במקום
שרת + בסיס נתונים תשתית ותחזוקה שכלי הדגמה לא מצדיק דף סטטי + Edge Function אחת (פרוקסי מוקשח) - בלי DB
מפתח בצד הלקוח (BYOK) כך עלה שלב 1 לאוויר - אבל החיכוך גבוה (רוב המבקרים לא יביאו מפתח) והמפתח גלוי בדפדפן שלב 2: מפתח אחד בצד השרת + מכסה יומית לכל IP + תקרת הוצאה בחשבון
פרומפטים בצד הלקוח כל מי שפותח Network tab מעתיק את הפרומפטים ומשתמש בפרוקסי כ-API חופשי הפרומפטים בשרת; הלקוח שולח agent + messages בלבד, עם ולידציה
אפיון אמיתי בלבד, בלי דמו מי שרק רוצה להציץ לא יתחיל שיחה - הכלי מת עבורו מצב דוגמה מלא: שיחה, בדיקת Gatekeeper מונפשת וכרטיס אפיון - בלי קריאת API אחת
Gatekeeper שבודק פורמט מודל שבודק אם הוא ציית לעצמו כמעט תמיד מאשר - בקרה של חותמת גומי קריטריוני תוכן + גישה לשיחה המלאה + פלט JSON שמוצג למשתמש

העיקרון המנחה: כל שקל של תשתית צריך להצדיק את עצמו. שלב 1 עלה לאוויר באפס תשתית (BYOK), ובגרסה המקורית של העמוד הזה נכתב: "אם יהיה ביקוש אמיתי - שלב 2 הוא proxy צד-שרת עם הגבלת שימוש". שלב 2 בוצע בדיוק כפי שתוכנן: פרוקסי מוקשח, מכסת שימוש, הפרומפטים והמפתח בצד השרת - ומדידה (GoatCounter, בלי עוגיות). החלטה ארכיטקטונית עם תנאי סף שמומשה כשהגיע הזמן.


אתגרים ופתרונות

מה לא היה פשוט?

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

דוגמת ה-few-shot בפרומפט לימדה פורמט שה-parser של התצוגה שבר - רשימה ממוספרת בתוך סעיף פוצלה לסעיפים מזויפים
פיצול רק בכותרות ברצף עולה (1→2→3) + בדיקת הדוגמה עצמה מול ה-parser. לקח: few-shot שמלמד פורמט חייב להיבדק מול הקוד שמרנדר אותו
תשובה שנחתכה במגבלת טוקנים נכשלה בשקט - המסמך איבד את הכרטיס, הבדיקה והייצוא בלי שום שגיאה
בדיקת stop_reason על כל קריאה + הודעה ברורה למשתמש. לקח: פלט חתוך הוא כשל שצריך להיות רועש, לא שקט
המודל טען "בדקתי אם קיים כלי מדף" - בלי גישה לאינטרנט. טענת בדיקה שלא בוצעה, בנכס שאמור לשדר אמינות
ניסוח מחייב בפרומפט: "למיטב היכרותי עם השוק... מומלץ לוודא בחיפוש קצר". לקח: אסור לתת למודל לטעון טענות שהוא לא יכול לגבות
המתנה ארוכה מול מסך קפוא - הפקת BRD + בדיקה + סבבי תיקון = עד 5 קריאות API עוקבות
Streaming על כל התשובות + checklist מונפש בזמן הבדיקה - ההמתנה הפכה לחלק מהחוויה
במעבר לפרוקסי (שלב 2): המסמך נחתך פעמיים באותה נקודה - גם אחרי הכפלת תקרת הטוקנים
אורך זהה בשתי ריצות = חיתוך לפי זמן, לא טוקנים: מגבלת ריצה של פונקציית שרת רגילה (~26 שניות). המעבר ל-Edge Function פתר. לקח: לאבחן לפי הראיות, לא לפי החשוד המיידי
מודלים אוהבים מקפים ארוכים - וסטיית סגנון אחת במשפט הסגירה שוברת את זיהוי המסמך
נרמול אוטומטי של פלט המודל (regex) + הנחיית סגנון בפרומפט - הגנה בשתי שכבות
פרק 5 - עלויות

כמה זה עולה?

המשתמש לא משלם ולא נרשם. העלות אצלי - חסומה משני כיוונים: מכסה יומית ותקרת הוצאה

רכיב תפקיד תוכנית עלות
Netlify אחסון הדף + Edge Function (הפרוקסי) Free ₪0
Claude API שני הסוכנים - אפיון + בקרה מפתח אחד בצד השרת סנטים בודדים לאפיון מלא*
הגבלת שימוש 30 קריאות AI ליום לכל כתובת IP (2-3 אפיונים) בקוד הפרוקסי ₪0
מדידה (GoatCounter) ביקורים ואירועים - בלי עוגיות, בלי באנר Free ₪0
מצב דוגמה חוויה מלאה בלי לשרוף מכסה סטטי - אפס קריאות API ₪0
עלות תפעול חודשית קריאות ה-API בלבד - חסומה בתקרת הוצאה

* אפיון מלא: 8-14 קריאות ל-claude-sonnet-4-6 (שיחה + בקרה + תיקונים). המכסה היומית לכל IP ותקרת ההוצאה בחשבון Anthropic חוסמות את התרחיש הגרוע ביותר.


פרק 6 - התוצאה בפועל

ככה זה נראה

הכלי החי - אפשר לנסות את מצב הדוגמה ישר מכאן

the-brief-agent.netlify.app

לכלי החי - בלי הרשמה ובלי הגדרות


פרק 7 - תוצאות

מה השגתי?

כלי חי בפרודקשן, שגם מדגים וגם עובד

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

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

לכלי החי LinkedIn