ה-Assistants API כבה היום: מדריך הגירה מלא ל-Responses API

היום, 26 באוגוסט 2026, OpenAI כיבתה סופית את ה-Assistants API. כל קריאה ל-/v1/assistants, /v1/threads או /v1/runs מחזירה מהיום שגיאה קשה, ללא תקופת חסד וללא אפשרות הארכה. אם בניתם צ'אטבוט, מערכת תמיכה או כלי פנימי על ה-API הזה והוא הפסיק לעבוד הבוקר, המדריך הזה בשבילכם: איך עוברים ל-Responses API בצורה מסודרת, מה אפשר עוד להציל ומה כבר אבוד.

01מה בדיוק קרה, ומה נשמר בכל זאת

ההוצאה משימוש הוכרזה מראש, לאחר ש-OpenAI השלימה הלימת פיצ'רים מלאה ב-Responses API. חשוב להבין את החלוקה: Vector stores וקבצים שהעליתם נשמרים וזמינים גם אחרי הכיבוי, אבל הגדרות ה-Assistants עצמן והיסטוריות ה-Threads לא עוברות אוטומטית. OpenAI לא סיפקה כלי הגירה אוטומטי, כך שהאחריות לשחזור השיחות והקונפיגורציה נופלת עליכם.

02צעד 1: מיפוי האובייקטים מהעולם הישן לחדש

השלב הראשון בכל הגירה הוא להבין איך המושגים מתורגמים. ההתאמה בין שני ה-APIs ישירה למדי, וברוב המקרים מדובר בהחלפת שכבת התשתית ולא בכתיבה מחדש של הלוגיקה העסקית:

• Assistants הופכים ל-Prompts: הגדרות המודל, ההנחיות והכלים עוברים לאובייקט Prompt לשימוש חוזר
• Threads הופכים ל-Conversations: ניהול היסטוריית שיחה עובר ל-Conversations API
• Runs הופכים ל-Responses: כל הרצה של המודל היא קריאת Responses API
• Run Steps הופכים ל-Items: הצעדים הפנימיים של כל ריצה מיוצגים כרשימת Items

בפועל, המשמעות היא שבמקום ליצור assistant פעם אחת ואז לפתוח threads ולהריץ runs, אתם שולחים קריאת Responses אחת שמקבלת את ההנחיות, הכלים וההקשר, ומקשרים אותה ל-Conversation שמנהל את ההיסטוריה. הזרימה פשוטה יותר, עם פחות אובייקטים לנהל ופחות polling.

03צעד 2: המרת הקוד בפועל

כך נראית קריאה בסיסית במבנה החדש. שימו לב שההיסטוריה מנוהלת דרך conversation, ואת ה-Vector stores הקיימים שלכם אפשר לחבר ישירות ככלי file_search, בדיוק כמו קודם:

from openai import OpenAI
client = OpenAI()

# יצירת שיחה חדשה (מחליף Thread)
conv = client.conversations.create()

# הרצה (מחליף Run) עם Vector store קיים
resp = client.responses.create(
    model="gpt-5",
    conversation=conv.id,
    instructions="אתה נציג תמיכה של החברה.",
    tools=[{
        "type": "file_search",
        "vector_store_ids": ["vs_your_existing_store"]
    }],
    input="מה מדיניות ההחזרות שלכם?"
)
print(resp.output_text)

ההנחיות הקבועות של ה-assistant הישן שלכם עוברות לשדה instructions או לאובייקט Prompt משותף, כך שצוות שלם יכול לעבוד מול הגדרה אחת מנוהלת. אם היו לכם function tools מותאמים אישית, הגדרתם עוברת כמעט אחד-לאחד לשדה tools של הקריאה.

04צעד 3: שחזור היסטוריות שיחה

זה החלק הכואב. מכיוון שה-Threads לא הועברו אוטומטית, מי שלא ייצא אותם מראש איבד את היסטוריות השיחה שנוהלו אצל OpenAI. אם שמרתם עותק של ההודעות בבסיס נתונים משלכם, מה שנחשב ממילא לפרקטיקה מומלצת, אפשר לשחזר: יוצרים Conversation חדש לכל ת'רד ישן ומזינים לתוכו את ההודעות ההיסטוריות כ-items לפני ההודעה החדשה הראשונה. למי שאין גיבוי, ההמלצה היא להתחיל שיחות נקיות ולתקשר את זה למשתמשים בשקיפות.

05למה זה חשוב במיוחד לצוותים בישראל, ומה מרוויחים בצד השני

סטארטאפים ישראלים רבים אימצו את ה-Assistants API בשלב מוקדם, בעיקר לצ'אטבוטים של שירות לקוחות וכלים פנימיים, בדיוק בגלל שהוא חסך ניהול state. עבורם הכיבוי הוא תקלת פרודקשן חיה שקרתה הבוקר. החדשות הטובות: המעבר אינו רק תיקון כפוי. ה-Responses API מציע ביצועים טובים יותר ופותח גישה ליכולות שלא היו קיימות בעולם הישן, כולל deep research, חיבור לכלים חיצוניים דרך MCP ו-computer use. מי שמסיים את ההגירה מקבל תשתית מודרנית יותר, לא רק שחזור של מה שהיה.

06רשימת פעולות לסיום היום

1. ודאו שכל הקריאות ל-/v1/assistants, /v1/threads ו-/v1/runs הוסרו מהקוד או עטופות ב-fallback
2. אתרו את מזהי ה-Vector stores הקיימים וחברו אותם לקריאות file_search החדשות
3. העבירו את הנחיות ה-assistants לאובייקטי Prompt או לשדה instructions
4. שחזרו היסטוריות שיחה מגיבויים פנימיים לתוך Conversations, אם קיימים
5. הוסיפו שמירה עצמאית של הודעות בבסיס נתונים שלכם כדי לא להיות תלויים בספק בפעם הבאה
6. הריצו בדיקות end-to-end על תרחישי הליבה לפני החזרת התעבורה המלאה

הכיבוי של היום מצטרף למגמה רחבה יותר אצל OpenAI של איחוד סביב מסלול אחד: רק לפני יומיים, ב-24 באוגוסט, הוצאה משימוש גם הפקודה codex mcp-server לטובת Codex app server. המסר למפתחים ברור: מי שעוקב אחרי הודעות deprecation ומתכנן הגירה מראש חוסך לעצמו בוקר כמו זה של היום.