דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-11-02·7 דק׳

OpenAI Python SDK 3.42: סוכני הבטא מקבלים הגדרות Compaction, סקירה אוטומטית ו-Time Awareness, כפי שנקרא מהטיפוסים

OpenAI Python SDK v3.42.0 הוסיף הגדרות לסוכני בטא ולסשנים עבור compaction ברקע או חוסם, סקירת פעולות אוטומטית ו-time awareness ניסיוני. קראתי את ערות הגרסה, הודעות ה-commit והגדרות הטיפוסים המיוצרות כדי לפרט מה כל הגדרה אומרת.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

OpenAI Python SDK v3.42.0, שיצא ב-31 באוקטובר 2026, מוסיף שלוש הגדרות למשטח סוכני הבטא והסשנים: context compaction (ברקע או חוסם), סקירת סשן (none או auto_review), ודגל time_awareness ניסיוני. ערות הגרסה הן שורה אחת כל אחת. הגדרות הטיפוסים המיוצרות במאגר נושאות את התיעוד בפועל של השדות, אז קראתי אותן. זו קריאה של מקור ה-SDK, לא בדיקה מול ה-API.

קראתי את ערות הגרסה של v3.42.0 ו-v3.42.1, את הודעות ה-commit של שלושת הפיצ'רים, ואת קבצי הטיפוסים של Agent, AgentSession, פרמטרי היצירה והעדכון של סשן, ופרמטרי יעד האוטומציה ב-tag v3.42.1. לא קראתי ל-API ולא קראתי את ה-API reference של OpenAI עצמה. מאמר קודם באתר הזה מכסה את אפשרויות ה-sandbox, המפתחות ומגבלות הנתונים של Agents API beta, וזה מכסה רק את ההגדרות החדשות.

מה ערות הגרסה אומרות

v3.42.0 מפרטת, בין שינויים אחרים (פקודות SIP DTMF, שכבות סימון לעריכת תמונות, ניהול מפתחות חיצוניים של ארגון, שחזור WebSocket ועוד כמה):

  • "add agent context compaction settings" (#4209)
  • "add agent session review and tool settings" (#4217)
  • "add experimental agent time awareness" (#4211)

v3.42.1 (1 בנובמבר) מפרטת רק תיקוני באגים ו-refactor סביב התנהגות Responses WebSocket ופרופילי אימות של Realtime.

Compaction

הודעת ה-commit של #4209 אומרת שהיא "adds context compaction settings to beta agents, sessions, and scheduled agent runs". מגדירים compaction ברקע או חוסם עם פרמטר async_ (שם ה-wire הוא async), ואפשר לקרוא את ההגדרות האפקטיביות מסוכנים, סשנים וקונפיגורציות סוכן מתוזמנות.

מהטיפוסים:

  • ההגדרה האפקטיבית היא אובייקט compaction עם async בוליאני: "Whether context is compacted in the background. Defaults to true."
  • ביצירה או עדכון, השמטה או null מביאים לברירת מחדל true, והגדרה ל-false בוחרת compaction חוסם.
  • "A supplied object replaces the settings; null or an empty object enables background compaction." השמטת האובייקט כולו שומרת את ההגדרות הנוכחיות.

מה שהטיפוסים לא אומרים הוא מה compaction עושה להקשר, איך סיכום נבנה או כמה זה עולה. לא מצאתי את זה בקבצים שקראתי.

סקירת סשן

הודעת ה-commit של #4217 אומרת שהיא "adds session review options and tool replacement". תיעוד הטיפוסים מגדיר review כליטרל של none או auto_review:

  • none: שמירה על התנהגות ההרצה הקיימת בלי סקירת פעולות אוטומטית.
  • auto_review: סקירה אוטומטית של פעולות זכאיות, ודחיית fallback לאישור ידני.
  • ביצירת סשן, השמטה פירושה none.
  • בעדכון סשן, זו ברירת סקירת הפעולות לסיבובי שורש חדשים. סיבובים קיימים ותתי-הסוכנים שלהם שומרים את מצב הסקירה שלהם.
  • על אובייקט הסשן, review מושמט כשהוא none וסקירה אוטומטית לא מופעלת.

הניסוח "deny manual approval fallbacks" הוא החלק שצריך לקרוא בעיון. ככתוב, פעולה שהסקירה האוטומטית לא מאשרת לא מנותבת לאדם לאישור ידני. הייתי מאשר את זה בבדיקה לפני הסתמכות, כי תיעוד הטיפוסים לא אומר מה קורה לפעולה שנדחתה. אילו פעולות נחשבות "eligible" גם לא מוגדר בקבצים שקראתי.

החלפת כלים בסשן

אותו commit מוסיף החלפת כלי סשן דרך agent.tools בעדכון סשן. תיעוד הטיפוסים אומר שזה "replaces the session tools": פונקציות ושרתי MCP משתנים בקריאת המודל הבאה, כלים מובנים משתנים עד הסיבוב הבא, והשמטת השדה שומרת את הכלים הנוכחיים בעוד null או מערך ריק מנקים אותם. מכיוון שרשימה מסופקת מחליפה את כל הסט, עדכון שמפרט כלי אחד משאיר את הסשן רק עם הכלי הזה.

Time awareness

הודעת ה-commit של #4211 אומרת שהיא מוסיפה הגדרות time-awareness אופציונליות לסוכנים וסשנים. השדה הוא experimental.time_awareness, בוליאני. תיעוד צד הקריאה אומר "Whether the model receives periodic current-time reminders", ותיעוד צד הכתיבה אומר "Omit to keep the current setting". ה-commit גם מתעד שעדכונים ניסיוניים "merge by key and preserve omitted settings". המילה experimental בשם השדה, אז הייתי מצפה שזה ישתנה. הטיפוסים לא אומרים באיזו תדירות התזכורות מגיעות.

מה הייתי בודק

אלה הצעות שלא בדקתי.

1. ליצור סשן עם review מוגדר ל-auto_review ולהפעיל פעולה שצריכה אישור, ואז לראות מה הסשן מדווח על פעולה שנדחתה.

2. להעביר compaction לחוסם על סשן בדיקה ארוך ולהשוות latency עם מצב הרקע כברירת מחדל.

3. לעדכן כלי סשן עם רשימה של פריט אחד ולאשר שהאחרים נעלמו.

4. לקבוע את גרסת ה-SDK, מכיוון שאלה בטא, טיפוסים מיוצרים, ו-time_awareness ניסיוני.

5. לקרוא את ה-API reference של OpenAI לאותם שדות, כי קראתי רק את ה-SDK.

מה לא הייתי מסיק

  • ש-auto_review הוא ערובת בטיחות. תיעוד הטיפוסים מתאר מצב, לא את הכיסוי או הדיוק שלו.
  • ש-compaction הוא ללא אובדן. הקבצים לא מתארים אותו.
  • שההגדרות האלה יציבות. המשטח תחת beta והגדרה אחת מתויגת ניסיונית.
  • שה-SDK וה-API מתנהגים זהה. לא קראתי ל-API.

שאלות נפוצות

מה Python SDK 3.42.0 הוסיף לסוכנים?

הגדרות context compaction, סקירת סשן והגדרות כלים, ו-time awareness ניסיוני, לפי ערות הגרסה.

מה ברירת המחדל ל-compaction?

Compaction ברקע. תיעוד הטיפוסים אומר ש-async מוגדר כברירת מחדל ל-true כשמושמט או null.

מה auto_review עושה?

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

אפשר לשנות review באמצע סשן?

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

מה time_awareness עושה?

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

מה קורה כשמעדכנים כלי סשן?

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

הרצת משהו מזה?

לא. קראתי ערות גרסה, commits והגדרות טיפוסים.

מקורות

כולם נקראו ב-2 בנובמבר 2026.

לא נקרא: ה-API reference והתיעוד של OpenAI לשדות האלה, מפרט ה-OpenAPI, ושאר שינויי v3.42.0 של ה-SDK מעבר לכותרות שלהם.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

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

עקבו ב-RSS