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

OpenAI Agents SDK 0.24.0-alpha.6: גלגל תצוגה מקדימה מבוסס-Codex, מדיניות כלים ו-NetworkPolicy, כפי שנקרא בתיעוד

ה-Agents SDK של OpenAI ל-Python שחרר גלגל תצוגה מקדימה ב-3 בנובמבר שמריץ את ה-runtime המובנה של Codex תחת API של Python, מחוץ ל-PyPI. קראתי את הערות הגרסה, התיעוד ב-commit המוצמד ואת ה-pyproject כדי לראות מה השתנה, מה הבקרות על כלים ורשת מכסות, ואיפה התיעוד והגרסה לא מסכימים.

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

אם אתם משתמשים בחבילת openai-agents של Python, התצוגה המקדימה ששוחררה ב-3 בנובמבר היא דבר שונה מהחבילה ב-PyPI. גרסת v0.24.0-alpha.6 של openai/openai-agents-python מותקנת מגלגלי שחרור ב-GitHub, אורזת runtime מקומי מקומפל, וה-README שלה עצמה אומר שה-SDK משתמש ב-Codex כדי להריץ תורות מודל. קוד ה-Python שלכם עדיין מגדיר הוראות, כלים וקונטקסט.

קראתי את דף הגרסה, יומן השינויים, ה-pyproject ומדריכי ה-SDK ב-commit של הגרסה. לא התקנתי את הגלגל ולא קראתי את קוד ה-Rust. כל מה שכתוב למטה הוא מה שהמסמכים האלה אומרים, לא משהו שהרצתי.

מה שוגר

דף הגרסה של v0.24.0-alpha.6 (מסומן בדף כ-3 בנובמבר, 16:44) אומר להשתמש ב-CPython סטנדרטי 3.10 עד 3.14 ולהתקין גלגל עם pip. הוא מפרט שלושה גלגלים: Linux x86_64 (glibc 2.39 או חדש יותר, 145.1 MB), macOS 11 או חדש יותר על Apple Silicon (114.0 MB) ו-Windows x64 (109.3 MB). הוא אומר שאין גלגלים ל-Mac על Intel, ARM Linux, ARM Windows, Alpine או musl, PyPy או Python free-threaded. קובץ SHA256SUMS מכסה את שלושת הגלגלים, והדף אומר שהתצוגה המקדימה מופצת דרך GitHub Releases, לא PyPI.

ה-commit של הגרסה הוא 2808233, "Correct child policy timeout checks for alpha.6", נכתב על ידי markstuart-oai, מתוארך 3 בנובמבר 08:40 UTC ומסומן כמאומת.

ה-pyproject ב-commit הזה קובע את הגרסה ל-0.24.0-alpha.6, מפנה את ה-readme של החבילה ל-packages/codex/README.md, ומפרט ארבע תלויות runtime: jsonschema, referencing, pydantic ו-typing-extensions. הבנייה משתמשת ב-hatchling עם maturin, וחבילת המקור כוללת תיקיית packages/codex עם קבצי Cargo, קובץ CODEX_REVISION, טלאים ותיקיית rust. כתובת ה-homepage מפנה לענף בשם feat/codex-harness.

יומן השינויים של התצוגה המקדימה אומר ש-alpha.5 וקודמות הופצו דרך תוכנית תצוגה מקדימה קודמת ושתגי הגרסה שלהן לא מתארחים במאגר הזה. אז alpha.6 היא התצוגה המקדימה הראשונה עם הערות גרסה ציבוריות במאגר הזה, והשינויים שהיא מפרטת הם יחסית לגרסה שרוב הקוראים מעולם לא ראו.

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

מסעיף "Added" של ההערות:

  • Turn לכוד עם get_result(), events() פסיבי, טיפול ידני בבקשות, היגוי וביטול. פרומפטים יכולים להיכנס לתור עם if_busy="queue" או להוויג את ה-Turn הפעיל עם if_busy="steer".
  • LocalStorage לפתיחה מחדש של שיחות מפרופיל מקומי, ועוד לכידת SessionState ניידת, forks ממצב idle, סיכומי דחיסה שמסופקים על ידי המתקשר, ובדיקות לתמיכת פיצ'רים ומוכנות checkpoint.
  • NativeOutput לסכמות strict מקומיות ו-PromptedOutput ל-JSON שמאומת ב-Python, עם max_retries חסום אופציונלי.
  • מדיניות כלים שבודקת ארגומנטים ותוצאות, החלפת ארגומנטים מקומית של MCP וטרנספורמציות תוצאה, ואינטראקציות טפסים ו-URL בניהול האפליקציה.
  • NetworkPolicy לפקודות מקומיות על executors נתמכים של Linux ו-macOS, ו-Environment ל-executors מרוחקים.
  • ייצוא OpenTelemetry מקומי, ו-agents.testing.ScriptedResponses לבדיקת מושבים אמיתיים מול תגובות מתוסרטות בלי מודל חי.

סעיף "API changes" הוא רשימת הגירה. כינויי Runner הוסרו לטובת Agent.run() ו-Agent.run_sync(). Turn.wait() ו-Session.wait() הופכים ל-Turn.get_result(). Session.interrupt() הופך ל-Turn.cancel() או Session.cancel_all(). Subagent.submit() הופך ל-Subagent.start(). ManualTool מתמזג לתוך FunctionTool. הצהרות Agent הופכות בלתי-ניתנות לשינוי. ההערות גם אומרות שבחירת כלים ועדכוני מושב לא יכולים להרחיב את ההרשאות שנלכדו כשה-Session נפתח.

איך התיעוד מתאר את הבקרות

מדריך הכלים אומר שכלים של Python מריצים קוד אפליקציה עם הרשאות האפליקציה. לכלי פונקציית Python, before מקבל את הארגומנטים המאומתים ומחזיר Allow, Deny או ReplaceArguments. after מקבל ומחזיר את פלט הכלי, והמדריך אומר שהוא לא יכול לבטל את אפקטי הכלי. אותו מדריך אומר שגם דדליין של callback לא יכול לבטל אפקטים קודמים.

לכלים של MCP, ברירת המחדל approval_mode="auto" שומרת את כללי האישור המקומיים של Codex, שיכולים לדרוש אינטראקציה כשכלי חסר הערות או יכול לבצע שינויים. הגדרת approval_mode="approve" מאשרת קריאות לכלים נבחרים, והמדריך אומר שאילוצים מקומיים וסקירה קפדנית עדיין חלים. הוא גם אומר שאישור לא מארגז את אתחול השרת. שרת MCP של stdio רץ על המארח כברירת מחדל, עם הרשאות המארח, אז המדריך אומר לכם לספק פקודה מהימנה.

טבלת הבקרות במדריך שימושית כמפה. לכלי executor של סביבה, approval רואה את הארגומנטים המקוריים ורק הרשאה מאפשרת טרנספורמציות ארגומנטים. לשרת MCP, before רואה את הקלט המקורי ו-approval רואה את הקלט האפקטיבי אחרי before. לכלי שיתוף פעולה מקומי, approval יכול לאשר או לדחות אבל לא להחליף ארגומנטים.

התראות כלים דלות בכוונה. רשומות ToolStarted ו-ToolFinished נושאות זהות קריאה ורצף, בלי ארגומנטים או תוצאות. המדריך אומר שרשומת התחלה של MCP יכולה להגיע לפני אישור וביצוע, ושסטטוס השלמה לא מוכיח שאפקטים קודמים שוחזרו.

NetworkPolicy, ומה היא לא מכסה

סעיף הרשת של המדריך מתאר את Environment.network. המגבלות שלה ספציפיות:

  • היא חלה על פקודות מקומיות. היא לא שולטת בחיבור המודל, בפונקציות Python או בלקוחות MCP.
  • ב-macOS, NetworkPolicy() ריקה לא מעניקה יעדים ולא sockets של Unix.
  • Linux לא יכול לאכוף דחיית Unix socket, אז מדיניות מפורשת נדחית לפני שהפקודות מתחילות אלא אם allow_all_unix_sockets=True.
  • Windows דוחה כל מדיניות רשת מפורשת בגרסה הזו.
  • כללי דומיין מכסים מארח על פני כל הפורטים. ה-proxy בודק שמות מארח ולא יכול לבדוק תעבורה מוצפנת. דחייה גוברת על הרשאה.
  • allow_all_unix_sockets=True מעניק כל socket נגיש, והמדריך אומר להשתמש בזה רק על executor פרטי ל-job. ב-macOS, binding מקומי יכול גם לאפשר תעבורה ישירה לכל IP נגיש על פורט 53, כולל תעבורה שאינה DNS, אז מגבלות מחמירות יותר צריכות בידוד מחוץ ל-executor.
  • כל מדיניות מפורשת מבטלת הסלמת ארגז חול, וקריאה עם sandbox_permissions="require_escalated" נכשלת לפני שהיא מתחילה.

המדריך גם אומר שהאפליקציה חייבת לבודד workspaces ודיירים ולבחור executor שאוכף את מגבלות מערכת ההפעלה שהיא צריכה. ל-Environment אין אפשרות sandbox_mode.

Checkpoints ואמון

SessionState נייד היא הדרך להעביר שיחה ל-worker אחר. מדריך המושבים אומר לשמור אותה באחסון אפליקציה מהימן ואומר שהיסטוריית checkpoint מכילה הוראות ויכולה להכיל נתוני אפליקציה פרטיים. שחזור צריך כלים, קונטקסט ותצורת provider עדכניים, והיסטוריה שמורה לא מעניקה credentials או הרשאות. אם אתם משחזרים עם state.instructions, המדריך אומר שאתם סומכים על ההוראות השמורות בלי לאשר שהמדיניות הנוכחית עדיין מתירה אותן. הוא מציע לספק הוראות משלכם, ובמקרה כזה השחזור דורש התאמה מדויקת.

להגדרות רשת, שחזור דורש את אותה מדיניות מנורמלת מקוד האפליקציה הנוכחי. ה-checkpoint שומר רק digest להשוואה, שלא מעניק גישה.

מדריך הבחירה מוסיף מגבלות ללכידה. פלט strict מקומי, בקשה ממתינה ב-thread בן, או כל תא קוד שבוצע חוסמים השהיה ידנית. קריאת כלים פרוגרמטית, שמצברת תוצאות עם JavaScript שנוצר ב-V8, לא יכולה להריץ Python שרירותי, ומצב ה-runtime של ה-JavaScript לא נשמר ב-checkpoints מסוג idle.

איפה התיעוד והגרסה לא מסכימים

שלושה אי-התאמות ששווה להכיר לפני שמתכננים סביב זה.

  • מדריך ההתקנה ב-commit של הגרסה אומר שגלגלי התצוגה המקדימה הציבוריים הראשונים עדיין לא זמינים, בעוד הגרסה פרסמה אותם. המדריך נקרא כנכתב לפני הגרסה.
  • מדריך הכלים מתייג את NetworkPolicy כלא-משוחרר, ויומן השינויים ב-commit הזה מכתר את alpha.6 ב-"(Unreleased)", בעוד הערות הגרסה מפרטות את NetworkPolicy כנוסף. קראתי את התיעוד ב-commit, לא סט שפורסם מחדש מאוחר יותר.
  • ה-README של ענף ברירת המחדל ש-GitHub מציג בדף המאגר עדיין מתאר את ה-SDK הקודם, עם Runner, SandboxAgent ו-pip install openai-agents. מדריכי התצוגה המקדימה חיים בתיעוד של ה-commit ו, לפי ה-pyproject, בענף feat/codex-harness. מדריך ההתקנה אומר שחבילת PyPI היא ה-SDK הקודם ולא מספקת את API התצוגה המקדימה.

אינדקס הנושאים ב-commit קובע סטטוס "unreleased", עם release ו-published_release כ-null ו-source_ref שמצביע על feat/codex-harness. זה עוד סימן שהתיעוד נכתב לפני הגרסה.

מה אני הייתי בודק

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

  • לנעוץ לפי שם קובץ הגלגל ולהשוות אותו מול SHA256SUMS מאותה גרסה לפני התקנה. התצוגה המקדימה לא ב-PyPI, אז בקרות האינדקס הרגילות שלכם לא חלות.
  • להתייחס לרשימת ההגירה כפורט אמיתי. לחפש בקוד אחרי Runner, Turn.wait, Session.interrupt, Subagent.submit ו-ManualTool.
  • לכתוב בדיקה לכל מדיניות before עם ScriptedResponses, כולל נתיבי ה-Deny ו-ReplaceArguments, כיוון שהמדריך אומר ש-after לא יכול לבטל אפקטים.
  • אם אתם מתכננים להשתמש ב-NetworkPolicy, להריץ פקודה שמנסה מארח נדחה ו-Unix socket על מערכת ההפעלה של ה-executor האמיתי שלכם, ולאשר שהכשלונות קורים איפה שהמדריך אומר.
  • לשמור checkpoints מחוץ לאחסון משותף, ולהחליט מאיפה השחזור לוקח את ההוראות שלו.

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

  • שזה מחליף את חבילת openai-agents ב-PyPI. התיעוד אומר ששני ה-APIs שונים ושהתצוגה המקדימה נשארת מחוץ ל-PyPI עד זמינות כללית.
  • ש-NetworkPolicy נותנת לכם job לא מקוון. המדריך אומר שה-SDK לא יכול להסיק גבול לא מקוון וה-backend חייב לאמת אותו.
  • שמדיניות כלים היא ארגז חול. המדריך אומר שכלים של Python רצים עם הרשאות האפליקציה.
  • ש-alpha.6 יציבה. הגרסה היא אלפא ודף הגרסה קורא לה תצוגה מקדימה.
  • שהיסטוריית התצוגה המקדימה המוקדמת תואמת את ההערות האלה. תגי alpha.5 ומטה לא במאגר הזה.

שאלות נפוצות

מה חדש בגרסה הזו?

גלגל תצוגה מקדימה שאורז runtime מקומי מבוסס Codex, API חדש של Session ו-Turn, מדיניות כלים, NetworkPolicy, executors מרוחקים, ייצוא OpenTelemetry מקומי וערכת בדיקות מתוסרטת.

זה ב-PyPI?

לא. דף הגרסה ומדריך ההתקנה אומרים שהתצוגה המקדימה מופצת דרך GitHub Releases ונשארת מחוץ ל-PyPI עד זמינות כללית.

לאילו פלטפורמות יש גלגלים?

Linux x86_64 עם glibc 2.39 או חדש יותר, macOS 11 או חדש יותר על Apple Silicon, ו-Windows x64. אין ל-Mac על Intel, ARM Linux, ARM Windows, Alpine או musl, PyPy או Python free-threaded.

האם זה שובר קוד קיים?

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

האם מדיניות כלים יכולה לבטל קריאת כלי?

לא. המדריך אומר ש-after לא יכול לבטל את אפקטי הכלי, ושסטטוס השלמה לא מוכיח שאפקטים קודמים שוחזרו.

האם NetworkPolicy מגבילה פונקציות Python או שרתי MCP?

לא. המדריך אומר שהיא מכסה פקודות מקומיות בלבד, לא את חיבור המודל, פונקציות Python או לקוחות MCP.

הרצתם את התצוגה המקדימה?

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

מקורות

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

לא נקרא: קוד ה-Rust, הפניות ה-API, המתכונים, מדריכי providers, תצורה, בדיקות ופתרון בעיות, ענף feat/codex-harness עצמו, והגלגלים.

קריאה נוספת

יומן הבנייה

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

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

עקבו ב-RSS