עזרא הוא סוכן AI אישי ל-WhatsApp: עוזר דיגיטלי בעברית שמנהל יומן, מייל, תזכורות ותפעול פרויקטים, הכל דרך שיחת וואטסאפ רגילה. הוא משמש גם כמרכז ההתראות של שאר הבוטים והמערכות, כך שכל מה שחשוב מגיע למקום אחד: הצ'אט. זו מערכת אישית של משתמש יחיד, ללא גישה ציבורית, והעמוד הזה מתעד אותה כ-Case Study הנדסי.
למי זה מיועד
עזרא נבנה למשתמש אחד, עם רשימה לבנה (Whitelist) של אנשי קשר מורשים. זו לא מוצר SaaS אלא דוגמה חיה לשאלה: איך נראה עוזר אישי אמיתי כשבונים אותו בדיוק בשבילך, בשפה שלך, עם הכלים שלך. מי שמחפשים סוכן AI אישי ל-WhatsApp ימצאו כאן את הארכיטקטורה המלאה של אחד כזה שרץ בפרודקשן.
איך זה עובד
שולחים הודעת וואטסאפ רגילה, ועזרא עונה בעברית, קצר ולעניין. מאחורי הקלעים יש לו רישום כלים (Tool Registry) מפורש:
- Google Calendar: קריאה וניהול של מספר יומנים
- Gmail: קריאת מיילים ושליחה
- תזכורות: קביעת תזכורות שמגיעות בחזרה לוואטסאפ
- קבוצות WhatsApp: טיפול בהודעות שמועברות אליו מקבוצות
- Google Analytics: נתוני אתרים במצב קריאה בלבד
- תדריך יומי, משימות, הודעות קוליות ועובדות זיכרון ככלים נוספים
נושאים רגישים כמו סיסמאות ומספרי חשבונות מוגדרים מפורשות מחוץ לתחום, והבוט מסרב להם בנימוס.
מה מיוחד כאן
הגישה ההנדסית מכוונת נגד קסם של פריימוורקים: FastAPI, קריאות ישירות ל-SDK של המודל, SQLite ורישום כלים מפורש. כל שורה קריאה, אין שכבות עלומות. האישיות, הטון, הרשימה הלבנה והתחומים מוגדרים בקובץ spec.json אחד, כך שהתנהגות הבוט היא קונפיגורציה ולא קוד מפוזר. בנוסף, הפרומפט בנוי בשני חלקים, קבוע ודינמי, כדי לנצל Prompt Caching ולחסוך בעלויות על כל הודעה.
הטכנולוגיה מאחורי הקלעים
- שרת: Python + FastAPI שמקבל Webhooks
- חיבור ל-WhatsApp: Green API
- מוח: Claude של Anthropic עם לולאת Tool Use מפורשת
- זיכרון: SQLite לשיחות, תזכורות ועובדות
- חיבורי Google: Calendar, Gmail ו-Analytics דרך OAuth
- פריסה: Render עם קובץ render.yaml
גישה
עזרא הוא מערכת פרטית של משתמש יחיד ואין אליו גישה ציבורית. הארכיטקטורה שלו, לעומת זאת, היא בדיוק התבנית שאסף מלמד ובונה איתה סוכני WhatsApp נוספים.