"הבריף" הופך רעיון אוטומציה עמום למסמך אפיון מובנה בדקות - וסוכן Gatekeeper בודק כל מסמך מול 10 קריטריוני איכות, מול העיניים של המשתמש, לפני שהוא מוצג.
הארכיטקטורה, ההחלטות והבקרה - שלי. את הקוד כתבתי עם Claude, בהנחיות ובבדיקות שלי.
"אני רוצה משהו שיזכיר לי לחדש חוזים" - זה לא אפיון. זו נקודת התחלה שדורשת עבודה
כל מי שעובד עם אוטומציות מכיר את הפער: בין הרעיון ("שיזכיר לי דברים") לבין מה שאפשר לבנות ממנו יש שלב אפיון - שאלות על טריגרים, נתונים, מקרי קצה ועלויות. בארגון זה נפתר בישיבת אפיון. לעצמאים ולצוותים קטנים - לרוב מדלגים עליו, והאוטומציה נשברת חודש אחרי שנבנתה. "הבריף" נותן טעימה מהתהליך הזה: שיחה קצרה שמפיקה מיני-אפיון (mini-BRD) מובנה, עם בקרת איכות שעוצרת מסמכים חלשים לפני שהם מגיעים למשתמש.
המשתמש מדבר עם סוכן אחד - אבל מאחורי הקלעים עובדים שניים
"אני רוצה משהו שיזכיר לי לפני שחוזה עם ספק עומד להסתיים" - בלי טפסים, בלי שדות חובה.
הסוכן המאפיין חייב לשאול גם שאלת עומק אחת לפחות: מה קורה עם הנתונים אחרי האיסוף? התשובות מוזרמות למסך בזמן אמת (streaming).
המסמך כולל: מטרה עסקית מכומתת, טריגר ותוצאה, מפת נתונים, 3 מקרי קצה ספציפיים, והמלצת כלים מודולרית (MVP + הרחבות + סקלביליות).
הסוכן השני מקבל את כל שיחת האפיון + המסמך, ומחזיר פסק דין מובנה (JSON) על 10 קריטריונים. המשתמש רואה checklist חי שמסתמן קריטריון-קריטריון.
כשל מחזיר את המסמך למאפיין עם הנימוק המדויק (עד 2 סבבים). רק מסמך שעבר מוצג ככרטיס מעוצב - עם תג "נבדק על ידי Gatekeeper" והורדה כ-PDF.
מריצת אמת, לא מדמו: ה-Gatekeeper זיהה פרט שהמודל המציא - ועצר את המסמך
בריצה אמיתית של אפיון (מערכת לרישום ימי חופש), הסוכן המאפיין הכניס למסמך קביעה שהמשתמש מעולם לא אמר: שיום חופש חייב להיות מסומן "מראש או בדיעבד באותו יום, לא רטרואקטיבית". פרט הגיוני לגמרי - אבל מומצא. בדיוק סוג ההזיה שמחליק בקריאה מהירה ומתגלה רק כשהאוטומציה כבר בנויה לא נכון.
שחזור של מסך הבדיקה מריצת האמת, שרצה בגרסת 9 הקריטריונים (כיום 10 - נוסף קריטריון עלות שוטפת) · המסמך תוקן אוטומטית ואושר בסבב הבא
למה זה חשוב: בקרת איכות שרק מאשרת היא תיאטרון. ה-✗ האדום עם הנימוק הוא מה שנותן משמעות לכל ה-✓ הירוקים - והשקיפות נשמרת גם אחרי התיקון: המסמך הסופי מסומן "אושר אחרי סבב תיקון אחד". כמו ב-CI Pipeline או ב-Code Review - אף אחד לא מסתיר את הבדיקה האדומה, כי היא מה שמקנה אמון בירוקה.
האבחון המקורי מצא Gatekeeper שבודק רק מבנה. הגרסה הנוכחית בודקת תוכן
הנקודה הארכיטקטונית: ה-Gatekeeper מקבל את כל שיחת האפיון, לא רק את המסמך. בלי ההקשר הזה אי אפשר לבדוק עקביות - וזה בדיוק מה שמבדיל בקרה אמיתית מחותמת גומי.
ארכיטקטורה נמדדת גם במה שלא נבנה. ארבע החלטות שקבעו את המבנה
| אלטרנטיבה שנשקלה | למה נפסלה | מה נבחר במקום |
|---|---|---|
| שרת + בסיס נתונים | תשתית ותחזוקה שכלי הדגמה לא מצדיק | דף סטטי + Edge Function אחת (פרוקסי מוקשח) - בלי DB |
| מפתח בצד הלקוח (BYOK) | כך עלה שלב 1 לאוויר - אבל החיכוך גבוה (רוב המבקרים לא יביאו מפתח) והמפתח גלוי בדפדפן | שלב 2: מפתח אחד בצד השרת + מכסה יומית לכל IP + תקרת הוצאה בחשבון |
| פרומפטים בצד הלקוח | כל מי שפותח Network tab מעתיק את הפרומפטים ומשתמש בפרוקסי כ-API חופשי | הפרומפטים בשרת; הלקוח שולח agent + messages בלבד, עם ולידציה |
| אפיון אמיתי בלבד, בלי דמו | מי שרק רוצה להציץ לא יתחיל שיחה - הכלי מת עבורו | מצב דוגמה מלא: שיחה, בדיקת Gatekeeper מונפשת וכרטיס אפיון - בלי קריאת API אחת |
| Gatekeeper שבודק פורמט | מודל שבודק אם הוא ציית לעצמו כמעט תמיד מאשר - בקרה של חותמת גומי | קריטריוני תוכן + גישה לשיחה המלאה + פלט JSON שמוצג למשתמש |
העיקרון המנחה: כל שקל של תשתית צריך להצדיק את עצמו. שלב 1 עלה לאוויר באפס תשתית (BYOK), ובגרסה המקורית של העמוד הזה נכתב: "אם יהיה ביקוש אמיתי - שלב 2 הוא proxy צד-שרת עם הגבלת שימוש". שלב 2 בוצע בדיוק כפי שתוכנן: פרוקסי מוקשח, מכסת שימוש, הפרומפטים והמפתח בצד השרת - ומדידה (GoatCounter, בלי עוגיות). החלטה ארכיטקטונית עם תנאי סף שמומשה כשהגיע הזמן.
שישה אתגרים מהבנייה - כל אחד לימד משהו על עבודה עם סוכני AI
המשתמש לא משלם ולא נרשם. העלות אצלי - חסומה משני כיוונים: מכסה יומית ותקרת הוצאה
| רכיב | תפקיד | תוכנית | עלות |
|---|---|---|---|
| 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 חוסמות את התרחיש הגרוע ביותר.
הכלי החי - אפשר לנסות את מצב הדוגמה ישר מכאן
לכלי החי - בלי הרשמה ובלי הגדרות
כלי חי בפרודקשן, שגם מדגים וגם עובד
הערך של סוכן AI לא נמדד רק במה שהוא מייצר - אלא במה שעוצר אותו כשהוא טועה. בקרת איכות גלויה היא מה שהופך פלט של מודל מ"נשמע טוב" ל"אפשר לסמוך על זה": סוכן אחד כותב, סוכן שני בודק מול 10 קריטריונים, והמשתמש רואה את הבדיקה קורית. כשה-Gatekeeper תפס פרט מומצא בריצת אמת - זו לא הייתה תקלה. זו הייתה המערכת עובדת.