fast-mailer: איך הוצאת המודל משלב השליחה קיצרה מייל לשניות

סיפור בנייה · כלים לסוכנים

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

תשובה מהירה

למה זה מהיר

הסוכן כותב את המייל ומעביר אותו הלאה. סקריפט רגיל בונה את ההודעה ושולח אותה ישירות ל-Gmail API. בלי דפדפן, בלי הפעלה של שרת כלים נוסף, ובלי קריאה למודל בין "שלח" ל"נשלח".

הבעיה: סוכן עושה עבודה של סקריפט

הרבה מערכות סוכנים שולחות מייל כמו שאדם היה עושה: לפתוח את Gmail בדפדפן, ללחוץ "כתיבה", להקליד, ללחוץ "שליחה". כל צעד הוא סבב דרך המודל, שמסתכל על הדף ומחליט מה לעשות הלאה. קובץ המיומנות במאגר עצמו מדרג את מסלול הדפדפן אחרון ומתאר אותו כ-"minutes - last resort only" (דקות, מוצא אחרון בלבד). המחבר לא פרסם איך בדיוק הסוכן של החבר שלח מיילים קודם, כך שהדפדפן הוא החשוד הסביר, לא סיבה מאומתת.

מה יש במאגר

חלק	מה הוא עושה
send.py	רק הספרייה הסטנדרטית של Python. בונה הודעת MIME, מרענן את אסימון OAuth בזיכרון, שולח לנקודת השליחה של Gmail ומדפיס JSON עם מזהה ההודעה והזמן שנדרש.
תיקיית triggers/	שימו קובץ .txt או .json לכל מייל, ואז הריצו python send.py watch --once. קבצים שנשלחו עוברים ל-triggers/sent/, כישלונות מקבלים סיומת .failed.
cli/gmaild.mjs	שירות רקע אופציונלי ב-Node 18+ על 127.0.0.1 ששומר חיבור TLS חם ל-Gmail ומרענן את האסימון כל 5 דקות.
cli/auth-server.js	התחברות חד-פעמית דרך Google ששומרת אסימון רענון ב-secrets/.
skills/fast-mailer/SKILL.md, AGENTS.md	הוראות שאומרות ל-Claude Code, Cursor, ZCode וכלים דומים איזו פקודה להריץ, ועוד תוסף ל-ZCode.

מאיפה מגיעות 14 השניות

לפני: הסוכן מפעיל ממשק מייל, תור מודל לכל לחיצה←אחרי: הסוכן כותב to, subject, body←פקודת טרמינל אחת←הסקריפט שולח ל-Gmail API←JSON: message_id + ms

קריאת השליחה קצרה. הלב של send.py הוא בקשת HTTPS POST אחת של הודעה מקודדת ב-base64 אל gmail.googleapis.com/gmail/v1/users/me/messages/send, הנקודה ש-Google מתעדת בדיוק לשם כך. ה-README מעריך אותה ב-0.6-1 שנייה מהתחלה קרה ובכ-0.5 שנייה עם שירות הרקע.

אז לאן הולכות ~13 השניות האחרות? זו הקריאה שלי ולא מדידה: הסוכן עדיין צריך לקרוא את הבקשה, לכתוב את הפקודה, לחכות לתוצאה ולענות. זה סבב מודל אחד במקום עשרות. קובץ ה-skill אפילו מורה לענות "רק message_id + ms. בלי סיפור", וזה מקצר גם את הצעד האחרון.

ההאצה לא באה משליחה מהירה יותר, אלא מפחות סבבי מודל בין הבקשה לסיום.

מה בדקתי בקוד

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

• רק שני שרתים מותרים: oauth2.googleapis.com ו-gmail.googleapis.com. כל כתובת אחרת נדחית.
• שמות קבצים ב-triggers חייבים להתאים לתבנית קפדנית. ../x.txt, שמות עם רווחים וקבצים מוסתרים נדחו.
• לפני כל בקשה שם השרת מתורגם לכתובת ונחסם אם הוא מצביע על כתובת פרטית או מקומית. הפניות מוגבלות לשתיים.
• השולח ב-Python אף פעם לא כותב לקובץ האסימון. שירות הרקע שומר אסימונים מרועננים עם הרשאות קובץ 0600.

פער אחד: שדות הנושא והנמען לא נבדקים לשבירות שורה. בבדיקה הלא מקוונת שלי, נושא Hello + שורה חדשה + Bcc: attacker@example.net יצר כותרת Bcc נוספת אמיתית. אם הסוכן שולח רק מה שאתם הקלדתם, זה לא משנה. אם הוא יכול להכניס לשורת הנושא טקסט מדף אינטרנט או ממייל נכנס, זה משנה. תיקון קצר:

# add at the top of send_email() in send.py
for field in [to, subject, sender or ""] + list(cc or []):
    if "\r" in field or "\n" in field:
        raise ValueError("line break in a header field")

נסו: מדדו את המסלול שלכם

כדי לראות לאן הולך הזמן של הסוכן שלכם, מדדו את הסקריפט לבד והשוו לתור המלא של הסוכן. הסקריפט מחזיר שדה ms משלו; העטיפה הזו מוסיפה זמן אמיתי סביבו:

start=$(date +%s.%N)
python send.py you@example.com "timing test" "hello" | tee /tmp/send.json
end=$(date +%s.%N)
echo "script wall time: $(echo "$end - $start" | bc) s"
# the gap between this and the agent's full reply time is model time

ניתוח (Jack Gross)

הלקח הכללי: להרחיק את המודל מהנתיב החם

התבנית פשוטה וכדאי להעתיק אותה מעבר לדואר. כשלמשימה יש צורה קבועה (אל, נושא, גוף), תנו למודל למלא את השדות ולקוד רגיל לעשות את השאר. כל צעד שהמודל צריך לפקח עליו ולאשר עולה שניות ומוסיף סיכוי לטעות. מ-1-4 דקות ל-14 שניות זה קיצוץ של בערך 4x עד 17x, וכמעט כולו נובע מהסרת סבבי מודל ולא מרשת מהירה יותר.

תיקיית triggers היא הרעיון המעניין יותר. היא מפרידה בין "להחליט מה לשלוח" לבין "לשלוח". סוכן, משימת cron או אדם יכולים לתור מיילים כקבצים, וסריקה אחת שולחת את כולם. כך גם קל לעבור על תיבת היוצא לפני שמשהו יוצא.

מגבלות שכדאי לזכור

• חדש לגמרי. פורסם ביום כתיבת הכתבה, גרסה 1.0.0, בלי בדיקות במאגר ובלי משתמשים חיצוניים עדיין. נתון 14 השניות הוא דיווח של אדם אחד על הגדרה אחת.
• הרשאות רחבות. ההתחברות מבקשת gmail.modify ו-gmail.readonly. התיעוד של Google מציין שההרשאה הצרה יותר gmail.send מספיקה לשליחה. אסימון שנגנב מהגדרה כזו מאפשר לקרוא ולשנות את הדואר שלכם, לא רק לשלוח.
• בדיקת כותרות. הוסיפו את בדיקת שבירות השורה שלמעלה לפני שמעבירים טקסט לא מהימן.
• המגבלות של Gmail עדיין חלות. Google מגבילה שליחה ליום (למשל 2,000 הודעות למשתמש ב-Google Workspace, 500 לחשבונות ניסיון) ו-500 נמענים להודעה דרך ה-API. בסקריפט אין הגבלת קצב ואין ניסיון חוזר מעבר לרענון אסימון אחד, כך ששליחות המוניות ייתקלו במגבלות האלה.
• למהירות יש מחיר. בלי שלב הדפדפן אין מסך שבו אדם מציץ בטיוטה. אם הסוכן שלכם צריך לשאול לפני שליחה, הבדיקה הזו צריכה עכשיו לחיות בהוראות שלו.
• הגדרה. צריך פרויקט Google Cloud ולקוח OAuth משלכם, ועוזר ההתחברות תופס כברירת מחדל את פורט 80.
• רק Gmail. אין Outlook או SMTP כללי, ואין קבצים מצורפים בקוד הנוכחי.

פסק דין

fast-mailer הוא תיקון קטן וקריא לבעיה אמיתית ושכיחה, ומודל האבטחה שלו קפדני יותר מרוב הכלים של היום הראשון. התייחסו אליו כנקודת פתיחה טובה: צמצמו את ההיקף ל-gmail.send, הוסיפו בדיקת כותרות ושמרו אישור אנושי איפה שחשוב. הלקח חורג הרבה מעבר לדואר: פחות סבבי מודל מנצחים מודל מהיר יותר.

שאלות נפוצות

האם fast-mailer משתמש במודל AI כדי לשלוח מייל?

לא. הסוכן כותב את התוכן, ואז סקריפט שולח אותו דרך Gmail API בלי קריאה למודל באמצע.

האם 14 שניות הן זמן השליחה של מייל אחד?

זה זמן התור המלא של הסוכן לפי המחבר. קריאת השליחה עצמה אורכת כ-0.6-1 שנייה לפי ה-README.

עם אילו סוכנים זה עובד?

עם כל סוכן שיודע להריץ פקודות טרמינל. המאגר כולל הוראות ל-Claude Code, Cursor ו-ZCode.

מקורות: fast-mailer ב-GitHub (קוד, README, SKILL.md, היסטוריית קומיטים, נקראו ב-24 בספטמבר 2026) · Gmail API: users.messages.send · מגבלות שליחה של Gmail ב-Google Workspace. הזמנים 1-4 דקות ו-14 שניות הם לפי מחבר המאגר.