OpenAI Agents API בבטא: שלוש אפשרויות sandbox ולאן המפתחות, הקבצים והנתונים שלכם מגיעים
ה-Agents API של OpenAI מריץ סוכן Codex מנוהל בסשנים. מה מרכז העזרה, ספר המתכונים של Databricks ותיעוד Cloudflare אומרים על בחירות sandbox, היקפי מפתחות, חיוב ומגבלות נתונים, ומה הם משאירים פתוח.
ה-OpenAI Agents API בבטא. הוא נותן לאפליקציה שלכם למסור משימה לסוכן Codex מנוהל-OpenAI שעובד על פני כמה צעדים וממשיך באותו סשן. OpenAI מריצה את לולאת הסוכן. אתם בוחרים איפה פקודות ה-shell ועריכות הקבצים שלו רצות: בשום מקום, sandbox מתארח-OpenAI, או sandbox שאתם מארחים. הבחירה הזו מחליטה איפה הקבצים שלכם חיים, אילו מפתחות אתם יוצרים, וכמה ניקוי אתם צריכים לעשות בעצמכם.
קראתי שלושה עמודים ראשוניים: שאלות נפוצות על בטא של Agents API של OpenAI, ספר המתכונים של Databricks ל-sandbox, והמדריך של Cloudflare להרצת Codex עם Agents API. לא הרצתי שום דבר מזה, אין לי גישת בטא לבדוק, ולא קראתי את עמודי הסקירה והארכיטקטורה של Agents API של OpenAI. כל מה שלמטה הוא מה שהעמודים האלה אומרים.
מה זה
לפי השאלות הנפוצות, האפליקציה שלכם מספקת את המשימה, הכלים והקונפיגורציה, ו-OpenAI מנהלת את הסשן והתיאום בין המודל לכלים. תלוי בכלים ובסביבה, סוכן יכול להריץ קוד, לערוך קבצים, להשתמש בחיבורי MCP ולייצר קבצים לאפליקציה שלכם. אפשר לשלוח עוד הוראות או משימה חדשה לאותו סשן.
בקשות צריכות את header ה-OpenAI-Beta: agents=v1. השאלות הנפוצות אומרות שה-SDKs של OpenAI מוסיפים אותו אוטומטית.
שלוש אפשרויות הסביבה
השאלות הנפוצות מפרטות אותן:
- בלי סביבה. הסוכן עונה על שאלות או קורא לכלים חיצוניים, בלי shell מובנה או קבצי workspace.
- Sandbox מתארח-OpenAI. לסקריפטים ועבודת קבצים, עם OpenAI שמנהלת את ה-sandbox.
- Sandbox מתארח-עצמית. לתשתית, תוכנה או רשת פרטית משלכם. השאלות הנפוצות אומרות שהאפליקציה שלכם מנהלת את מחזור החיים של הסביבה.
שני עמודי השותפים מראים איך האפשרות המתארחת-עצמית נראית בפועל.
מתארח-עצמית, כפי שהשותפים מתארים
בספר המתכונים של Databricks, סשן הסוכן נוצר עם סביבה מתארחת-עצמית. האפליקציה שלכם מקצה את ה-sandbox, אז משיקה codex exec-server בתוכו. התהליך ההוא מתחבר יוצא ל-OpenAI ומחכה לקריאות כלים. הסוכן אז מריץ כלי shell וקבצים בתוך ה-sandbox. ספר המתכונים אומר ששום דבר לא צריך לקבל חיבור נכנס, אז האפליקציה יכולה לרוץ על לפטופ, עבודת Databricks או מחברת.
המדריך של Cloudflare משתמש בצורה אחרת. OpenAI שולחת webhooks חתומים ל-Worker בחשבון שלכם כשסשן מתחיל, צריך סביבה, הולך ל-idle או נכשל. ה-Worker מאמת כל webhook ומעביר אותו ל-Durable Object, שמפעיל קונטיינר שמריץ codex exec-server. קבצים נשארים ב-/workspace בחשבון Cloudflare שלכם. התבנית של המדריך עושה snapshot לקונטיינר כשהסשן הולך ל-idle ושומר קונטיינר idle ל-30 שניות כברירת מחדל.
שני העמודים מתארים אותה חלוקה: OpenAI מריצה את לולאת הסוכן, אתם מריצים את המקום שבו פקודות מתבצעות.
מפתחות: שלושה סוגים, והם חייבים להתאים
זה החלק שיכשל אנשים, והעמודים ספציפיים.
- השאלות הנפוצות אומרות ליצור מפתח API של אפליקציה ולהעניק
api.agents.readו-api.agents.writeלסשנים, בתוספתapi.responses.writeלבקשות מודל. - השאלות הנפוצות גם אומרות לשמור את מפתח ה-API שלכם מחוץ ל-sandbox של הסוכן.
- ל-sandboxes מתארחים-עצמית, Databricks ו-Cloudflare שניהם משתמשים במפתח executor נפרד, מועבר ל-Codex ב-sandbox כ-
CODEX_API_KEY. Cloudflare אומרת שהוא צריךapi.model.readו-api.agents.environments.connect. Databricks אומרת שהוא חייב לשייך לאותו ארגון, פרויקט ומשתמש או חשבון שירות כמו הסשן. Cloudflare אומרת אותו דבר על שני המפתחות.
Databricks נותנת את מצב הכשל: executor שמשתמש במפתח כללי נדחה עם 403 missing required scope api.agents.environments.connect.
הייתי מתייחס לזה כחוק עיצוב: ה-sandbox של הסוכן מקבל את מפתח ה-executor הצר, ומפתח האפליקציה שלכם אף פעם לא נכנס.
רשת ורשימות היתר IP
Databricks אומרת של-sandbox שלה יש egress יוצא בלתי מוגבל ו-ingress נכנס סגור, וששניהם כרגע לא ניתנים להגדרה. זו קביעה על ה-sandbox של Databricks, לא על Agents API בכלל. זה אומר שהסוכן יכול להגיע לכל host ציבורי מה-sandbox ההוא.
אם ארגון ה-OpenAI שלכם אוכף רשימת היתר IP, כתובת ה-egress IP של ה-sandbox חייבת להיות עליה, ו-OpenAI דוחה תעבורה מ-IPs לא-רשומים. Databricks מזהירה שכתובת ה-egress IP יציבה בזמן ש-sandbox רץ אבל יכולה להשתנות אחרי עצירה והפעלה מחדש. אז sandbox שעובד בשני יכול להתחיל להחזיר 401 ... IP is not authorized אחרי הפעלה מחדש.
Observability וטיפול בכשלים
השאלות הנפוצות אומרות שאפשר לסקור סשן תחת Logs בדשבורד הפלטפורמה, על ידי בחירת Agents וחיפוש מזהה הסשן. אפשר לבחון תורנויות, קריאות כלים ופעילות סוכני-משנה.
שתי שורות בשאלות הנפוצות שוות שמירה:
- אם זרם האירועים מתנתק, שלפו את הסשן הקיים והפריטים השמורים שלו לפני ניסיון חוזר, כך שאתם יודעים מה קרה לפני שאתם מגישים עוד עבודה.
- תורנות שהושלמה לא אומרת שכל כלי הצליח, וסשן idle לבדו לא מוכיח שהמשימה הסתיימה בהצלחה. סקרו את התוצאה המדווחת.
Databricks מוסיפה שתורנות גמורה כשהזרם מדווח על תורנות הסוכן הראשי כ-completed, failed או cancelled, ושצריך לקרוא תוצאות בחזרה מה-sandbox, אז לעצור את ה-executor ולמחוק את הסשן וה-sandbox.
חיוב ומגבלות נתונים
- חיוב: לפי השאלות הנפוצות, בקשות מודל משתמשות בתעריפי ה-API של המודל הנבחר, וכלים של OpenAI ו-sandboxes מתארחים-OpenAI משתמשים בתעריפי הכלי והקונטיינר החלים. השאלות הנפוצות לא מפרטות מספרים. הן מפנות לעמוד תמחור ה-API, שלא קראתי. ל-sandboxes מתארחים-עצמית, חשבון החישוב בא מהספק שלכם. המדריך של Cloudflare דורש תוכנית Workers Paid עם גישת Containers.
- נתונים: ה-Agents API שומר מצב סשן כדי שעבודה תמשיך על פני תורנויות. אפשר למחוק סשנים ו-artifacts שפורסמו, והשאלות הנפוצות אומרות לשמור קבצים שאתם צריכים לפני מחיקת סשן.
- שמירה ושהות: השאלות הנפוצות אומרות שה-Agents API כרגע תומך בשהות נתונים בארצות הברית בלבד. הוא לא תומך ב-Zero Data Retention, כולל עם sandbox מתארח-עצמית.
הנקודה האחרונה משנה אם קיוויתם ש-sandbox מתארח-עצמית ייתן לכם גם Zero Data Retention. לפי השאלות הנפוצות, הוא לא.
מה הייתי בודק
אלה הצעות שלא בדקתי, לא תוצאות.
1. היקף מפתח. צרו את מפתח ה-executor רק עם ההרשאות שמדריכי השותפים מזכירים, ואשרו שמפתח האפליקציה שלכם אף פעם לא מופיע בסביבת ה-sandbox.
2. התנהגות הפעלה מחדש. עצרו והפעילו מחדש sandbox מתארח-עצמית, ואשרו ש-egress IP ורשימת ההיתר עדיין עובדים, וש-codex exec-server מתחבר מחדש.
3. התאוששות מניתוק. הרגו את זרם האירועים באמצע תורנות, שלפו את הסשן, ובדקו מה הפריטים השמורים מראים לפני שאתם שולחים מחדש.
4. בדיקת הצלחה. אל תתייחסו לסשן idle כגמור. כתבו בדיקה שקוראת את קבצי הפלט ומשווה אותם למה שביקשתם.
5. עלות למשימה. הריצו משימה קטנה קבועה עשר פעמים והשוו את שימוש הטוקנים בלוגים של הסשן עם החשבון של ספק ה-sandbox.
מה לא הייתי מסיק
- ש-sandbox מתארח-עצמית שומר את הנתונים שלכם מידי OpenAI. השאלות הנפוצות אומרות שמצב סשן נשמר, ולולאת הסוכן רצה ב-OpenAI.
- שמגבלות ה-egress וה-ingress של Databricks חלות על כל sandbox. הן קביעה של Databricks.
- שהבטא יציבה. היא מתוייגת בטא, והדוגמאות שקראתי משתמשות בשם מודל
gpt-5.6-sol, שעשוי להשתנות. - שמשהו מזה תואם לחשבון שלכם. לא בדקתי עם מפתח API.
שאלות נפוצות
מהו ה-OpenAI Agents API?
API בבטא לבניית אפליקציות סביב סוכן Codex מנוהל-OpenAI שעובד על פני צעדים מרובים ושומר את הסשן שלו בין תורנויות.
האם אני צריך sandbox?
לא תמיד. השאלות הנפוצות מפרטות בלי סביבה, sandbox מתארח-OpenAI, ו-sandbox מתארח-עצמית. בחרו לפי אם הסוכן צריך shell או קבצים, ומי צריך להריץ אותם.
אילו מפתחות API הוא צריך?
מפתח אפליקציה עם api.agents.read, api.agents.write ו-api.responses.write, לפי השאלות הנפוצות. התקנות מתארחות-עצמית גם משתמשות במפתח executor נפרד, ש-Cloudflare אומרת שצריך api.model.read ו-api.agents.environments.connect.
איך אני רואה מה הסוכן עשה?
פתחו Logs בדשבורד הפלטפורמה, בחרו Agents, וחפשו את מזהה הסשן. אפשר לבחון תורנויות, קריאות כלים ופעילות סוכני-משנה.
איך זה מחויב?
בקשות מודל משתמשות בתעריפי ה-API של המודל הנבחר. כלים של OpenAI ו-sandboxes מתארחים-OpenAI משתמשים בתעריפי הכלי והקונטיינר שלהם. השאלות הנפוצות מפנות לעמוד תמחור ה-API למספרים עדכניים.
האם הוא תומך ב-Zero Data Retention?
לא, לפי השאלות הנפוצות, כולל כשאתם משתמשים ב-sandbox מתארח-עצמית. שהות נתונים מוגבלת כרגע לארצות הברית.
מה קורה אם הזרם נופל?
שלפו את הסשן הקיים והפריטים השמורים שלו לפני ניסיון חוזר, כך שאתם יכולים לראות מה כבר קרה.
מקורות
כל העמודים נקראו ב-26 באוקטובר 2026.
- Agents API (beta) FAQ (מרכז העזרה של OpenAI): סביבות, מפתחות, לוגים, חיוב, טיפול בנתונים.
- Running OpenAI agents using a Databricks Sandbox (OpenAI Cookbook): מחזור חיים מנוהל-אפליקציה, מפתח executor, רשת, פתרון תקלות.
- Run Codex with the OpenAI Agents API in a sandbox (תיעוד Cloudflare Sandboxes, עודכן לאחרונה 22 באוקטובר 2026): זרימת webhook, הרשאות מפתח, התנהגות idle.
לא נקראו: עמודי סקירה וארכיטקטורה של Agents API, עמוד תמחור ה-API, והמדריכים המלאים של Databricks ו-Cloudflare מעבר לסעיפים המצוטטים.
קריאה נוספת
- OpenAI Python SDK 3.42: סוכני הבטא מקבלים הגדרות Compaction, סקירה אוטומטית ו-Time Awareness, כפי שנקרא מהטיפוסים
OpenAI Python SDK v3.42.0 הוסיף הגדרות לסוכני בטא ולסשנים עבור compaction ברקע או חוסם, סקירת פעולות אוטומטית ו-time awareness ניסיוני. קראתי את ערות הגרסה, הודעות ה-commit והגדרות הטיפוסים המיוצרות כדי לפרט מה כל הגדרה אומרת.
- הערות שחרור Codex CLI 0.165.0: ספק Vertex AI, ברירת מחדל Memory v2, החלפת רמת Reasoning
מה הערות השחרור של Codex CLI 0.165.0 אומרות שהשתנה: ספק Google Cloud Vertex AI מובנה, memory v2 דולק כברירת מחדל לפרופילים חדשים, שינויי רמת reasoning באמצע שיחה, ותיקון URL marketplace. מה לבדוק לפני שדרוג.
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS