המדריך המלא ל-שער API מרכזי לכל רשת
שער אחד, 100+ endpoints, כל הרשת מאחור
Delegator הוא מה שנקרא בעגה המקצועית 'שער API' (API Gateway) — מעין מרכזייה דיגיטלית שיושבת בכניסה לרשת סוכני ה-AI שלי וממיינת את כל התנועה שעוברת דרכה. חשבו על מרכזייה של בניין משרדים גדול: במקום שכל עובד יזכור את המספר של הבנק, של חברת הדואר, של ספק החשמל ושל עשרות הלקוחות — יש מרכזנית אחת שיודעת את הכל; העובד רק מבקש 'תעבירי אותי לבנק' והיא מחברת. בדיוק כך Delegator מתפקד עבור הסוכנים שלי: כש-Kami רוצה לשלוח אימייל, כש-Box צריך ליצור אירוע ביומן, כש-Adopter רוצה לשמור משהו בזיכרון — אף אחד מהם לא צריך לדעת את מפתחות ה-API של Resend (מייל — 100 ביום בחינם, מעבר לזה pay-per-use), Google, Twilio (SMS — תשלום לפי הודעה) או Perplexity (Pro API למחקר). הם פשוט שולחים בקשה ל-Delegator, והוא דואג לכל השאר. הטכנולוגיה עצמה פשוטה מאוד — שרת HTTP שכתבתי ב-Python עם מעל 100 נקודות קצה (endpoints) שמטפלות בכל מה שצריך. אצלי Delegator מחבר 10 סוכנים שונים מאחורי שער אחד — אצלכם הוא יכול להחליף שירותי אוטומציה כמו Zapier (חינם עד 100 tasks בחודש, Starter כ-29 דולר לחודש, Professional כ-73 דולר, Team כ-103 דולר למשתמש ב-2026) או Make, ולשמש כתשתית API מרכזית לכל ארכיטקטורה עם מספר מערכות AI — בלי לפזר סיסמאות וקונפיגורציה בחמישה מקומות שונים.
מה המדריך מכסה
מה זה Delegator? שער הכניסה היחיד לכל הרשת
HTTP router בפייתון שמחליף Zapier, Make ו-5 קבצי credentials
Delegator הוא מה שנקרא בעגה המקצועית 'API gateway' — שער כניסה מרכזי שיושב מול כל מערכת שיש לה הרבה שירותים ברקע. זו תוכנה קטנה שכתובה בפייתון רגיל (בלי framework מפונפן כמו FastAPI או Express), רצה בתור שירות רקע על השרת שלי, ומקשיבה לבקשות שמגיעות אליה דרך הרשת (HTTP). כל סוכן ברשת שלי — Kami, Kaylee, Box, Hermes, Adopter וכל השאר — כשהוא רוצה לשלוח מייל, להוציא הודעת SMS, לבדוק את הלו"ז או לקרוא ל-LLM — הוא לא פונה ישירות לספק השירות. הוא פונה ל-Delegator, וה-Delegator הוא זה שיודע באיזה מפתח API להשתמש ואיך לדבר עם כל שירות.
מעל 100 endpoints — מה יש בתוך השער
לא רק צינור — גם לוגיקה עסקית אמיתית
endpoint היא כתובת ספציפית בשרת שעונה למשימה מסוימת. למשל POST /email/send לשליחת מייל, או GET /calendar/check לבדיקת לו"ז. Delegator מחזיק מעל 100 כאלה, מחולקים לפי תחומי אחריות. זה לא רק middleware (שכבת תיווך שמעבירה בקשות לשירות אחר) — יש כאן גם לוגיקה עסקית אמיתית, למשל שער שבודק אם מותר לפרסם עכשיו, או router שמחליט איזה LLM להפעיל לפי עלות.
דפוס Gateway — אחריות מרוכזת במקום מפוזרת
כשכולם עוברים דרך אותו שער, אפשר לנהל אותם מאותו מקום
Gateway pattern הוא עיקרון אדריכלות תוכנה שבו במקום שכל רכיב ברשת ידבר ישירות עם שירותים חיצוניים, כולם מנותבים דרך שער מרכזי אחד. הרווח: כל מה שרוצים לבדוק או לאכוף על כל הרשת — אפשר להוסיף פעם אחת ב-Gateway, והשינוי חל על כולם באופן אוטומטי. רוצים להוסיף log לכל בקשה? שורה אחת. רוצים להגביל כמה בקשות בדקה כל סוכן יכול לשלוח (מה שנקרא rate limit)? שורה אחת.
שער הלוח העברי — חובה בישראל
חסימה אוטומטית של פרסום בשבת, חג, יום הזיכרון
זו שכבת הגנה ייחודית שהוספתי ל-Delegator אחרי כמה מקרים מביכים. הרעיון: לפני שכל endpoint של פרסום מבצע את הפעולה, הוא בודק את הלוח העברי-ישראלי דרך שירות בשם Hebcal. אם עכשיו שבת, חג, יום הזיכרון לחללי מערכות ישראל או יום הזיכרון לשואה — הוא פשוט מסרב לפרסם תוכן שיווקי, ומחזיר הודעה מנומסת עם זמן החזרה לפעילות. זה פועל בתור middleware על כל endpoint פרסום ברשת.
מעקב עלויות — מי מהסוכנים אוכל כמה
Dashboard שמראה בזמן אמת איזה סוכן הוציא כמה על LLM
קריאות ל-LLM (מודלי שפה כמו Claude, Gemini, GPT) הן ההוצאה הכי גדולה ברשת סוכנים אוטונומית, ובלי מעקב זה יכול להתפוצץ לחשבון דמיוני בסוף החודש. הוספתי ל-Delegator מנגנון שמתעד כל קריאת LLM שעוברת דרכו: באיזה tier (שכבה) השתמש, באיזה model, מי הסוכן שביקש, כמה tokens נכנסו, כמה יצאו, וכמה זמן זה לקח. אפשר אחר כך לחתוך את הנתונים ולראות למשל ש-'Kami צרך 40% מתקציב ה-LLM החודשי'.
ניתוב LLM — תמיד חינמי קודם
endpoint אחד, 4 שכבות fallback אוטומטיות, 0 דולר ברוב הזמן
במקום שכל סוכן יחליט בעצמו לאיזה מודל LLM לקרוא (ומתי ליפול בחזרה למודל אחר אם יש כשל), Delegator חושף endpoint אחד בשם `/llm/route`. הסוכן שולח את הפרומפט עם system prompt ומגבלת tokens, ו-Delegator מחליט בעצמו: מנסה קודם את המודל הזול ביותר (חינמי), ואם הוא נכשל עובר לבא בתור, וכך הלאה עד שמשהו עובד. התשובה כוללת גם באיזה tier ובאיזה model בפועל ענו, כדי שהסוכן ידע.
טיפים מתקדמים מ-6 חודשי production
הניואנסים שהופכים API gateway פשוט למשהו יציב ואמין
זה לא מדריך תיאורטי — כל הדברים כאן נבנו מכישלונות שעברתי בדרך. אלה הלקחים מתחזוקה שוטפת של Delegator במשך חצי שנה.
