ב-11 במרץ 2025 השקנו את אבני הבניין של פלטפורמת הסוכנים החדשה שלנו. לפרטים, אפשר לעיין בתיעוד ה-API שלנו עבור Responses API, הכלים חיפוש באינטרנט, חיפוש בקבצים ושימוש במחשב, וכן Agents SDK עם מעקב אחר הרצות. בעקבות המשוב שלכם על גרסת הבטא של Assistants API, שילבנו שיפורים מרכזיים ב-Responses API. לאחר שכל היכולות יהיו זמינות גם ב-Responses API, נכריז בהמשך השנה על תוכנית להוצאה משימוש של Assistants API, עם יעד לסיום פעילותו במחצית הראשונה של 2026.
מהו Assistants API?
Assistants API מאפשר למפתחים לבנות בקלות עוזרי בינה מלאכותית רבי-עוצמה בתוך האפליקציות שלהם. ה-API הזה מייתר את הצורך לנהל את היסטוריית השיחה ומוסיף גישה לכלים שמתארחים אצל OpenAI, כמו האינטרפרטר וחיפוש בקבצים. ה-API תומך גם ביכולת משופרת של קריאה לפונקציות עבור כלי צד שלישי.
האם עדיין אפשר להשתמש בגרסת הבטא v1 של Assistants API?
לא. החל מ-18 בדצמבר 2024, אין עוד למשתמשים גישה לגרסת v1 של Assistants API בטא. כרגע אנחנו תומכים רק ב-v2. כדי להמיר את קריאות ה-API שלך מ-v1 ל-v2, אפשר להיעזר במדריך המעבר הזה.
איך מקבלים גישה אליו?
Assistants API זמין לכל מי שיש לו חשבון OpenAI API, אך הוא מיועד להוצאה משימוש ויוסר באוגוסט 2026. בפרויקטים חדשים יש להשתמש ב-Responses API במקומו. אם כבר נעשה אצלך שימוש ב-Assistants API, כדאי לתכנן את המעבר ל-Responses API. כל עוד ה-API זמין, אפשר להמשיך לגשת לעוזרים קיימים ב-Playground של העוזרים.
מהו עוזר?
עוזר הוא בינה מלאכותית שנבנתה למטרה מסוימת, משתמשת במודלים של OpenAI ויכולה לגשת לקבצים, לשמור שרשורים לאורך זמן ולקרוא לכלים.
מהו שרשור?
שרשור הוא שיחה בין עוזר למשתמש. שרשורים מפשטים את פיתוח האפליקציות: הם שומרים את היסטוריית ההודעות ומקצרים אותה כשהשיחה חורגת מאורך ההקשר של המודל.
מהו כלי החיפוש בקבצים?
הכלי file_search מיישם מראש כמה שיטות מומלצות לאחזור מידע, כדי לעזור לך לחלץ מהקבצים את הנתונים המתאימים להעשרת תשובות המודל. למידע נוסף, אפשר לעיין בתיעוד למפתחים שלנו.
כברירת מחדל, הכלי file_search משתמש בהגדרות הבאות:
גודל מקטע: 800 טוקנים
חפיפה בין מקטעים: 400 טוקנים
מודל ההטמעה הווקטורית: text-embedding-3-large ב-256 ממדים
מספר המקטעים המרבי שנוספים להקשר: 20
מהן המגבלות על העלאת קבצים?
המגבלות על העלאת קבצים הן:
512 MB לקובץ
5 מיליון טוקנים לקובץ
10,000 קבצים למאגר וקטורי
מאגר וקטורי אחד לכל עוזר
מאגר וקטורי אחד לכל שרשור
מגבלת האחסון הכוללת לכל פרויקט בארגון היא 100 GB.
מהן המגבלות של כלי החיפוש בקבצים?
יש כמה מגבלות ידועות שאנחנו פועלים להסרתן באמצעות הוספת תמיכה בחודשים הקרובים:
כרגע אי אפשר לשנות את הגדרות החלוקה למקטעים, ההטמעה הווקטורית או האחזור.
אין תמיכה בפענוח תמונות בתוך מסמכים.
אין תמיכה באחזור מקבצים בפורמטים מובנים (כמו קובצי .csv או .jsonl). אפשר לעיין בסוגי הקבצים הנתמכים.
מהן מגבלות קצב הבקשות ב-Assistants API?
מגבלות קצב הבקשות ב-Assistants API אינן תלויות ברמת השימוש ובמודל. במקום זאת, יש מגבלות ברירת מחדל לפי סוג הבקשה, עם כמה חריגים:
GET: 1,000 בקשות בדקה
POST: 300 בקשות בדקה
DELETE: 300 בקשות בדקה
מה התמחור של האינטרפרטר ב-API?
מחיר השימוש באינטרפרטר הוא $0.03 להפעלה. אם העוזר שלך קורא לאינטרפרטר במקביל בשני שרשורים שונים, נוצרות שתי הפעלות של האינטרפרטר (2 * $0.03). כל הפעלה נשארת פעילה למשך שעה כברירת מחדל. כלומר, החיוב הזה נגבה פעם אחת בלבד אם המשתמש שלך ממשיך לתת הוראות לאינטרפרטר באותו שרשור במשך עד שעה.
מה התמחור של חיפוש בקבצים ב-API?
מחיר החיפוש בקבצים הוא $0.10 לכל GB של אחסון במאגר וקטורי ליום (ה-GB הראשון של האחסון ניתן בחינם). גודל המאגר הווקטורי מחושב לפי נפחו לאחר פענוח הקובץ, חלוקתו למקטעים והמרתו להטמעות וקטוריות.
כל המאגרים הווקטוריים שנוצרו לפני 17 באפריל 2024 יהיו בחינם עד סוף 2024. לאחר מכן:
הם יחויבו בתעריפים העדכניים (כרגע $0.10 לכל GB ליום) אם נעשה בהם שימוש לפחות פעם אחת בהרצה שנוצרה אחרי 17 באפריל 2024.
הם יימחקו אם לא נעשה בהם שימוש באף הרצה בין 17 באפריל 2024 ל-31 בדצמבר 2024 — כדי למנוע חיוב על מאגרים וקטוריים שאולי יצרת לפני ההכרזה על שינוי התמחור, אך מעולם לא השתמשת בהם.
האם יש הגבלה על מספר העוזרים שאפשר ליצור?
אין הגבלה על מספר העוזרים שארגון יכול ליצור.
האם ה-API תומך בהזרמה?
כן, Assistants API תומך בהזרמה.
האם מצב JSON זמין ב-Assistants API?
כן, מצב JSON זמין ב-Assistants API באמצעות הפרמטר response_format באובייקטים Assistants או Run.
האם Assistants API ינהל גם בקשות לקריאה לפונקציות של צד שלישי?
לא. קריאה לפונקציות מאפשרת למודל לבחור כלים ולנסח בקשות עבורם בפורמט המתאים, אך ביצוע הקריאות לכלי צד שלישי אינו מנוהל על ידי OpenAI.
איך מטופלים הנתונים שאני שולח ל-OpenAI?
כמו בשאר הפלטפורמה שלנו, נתונים וקבצים שנשלחים ל-OpenAI API לעולם אינם משמשים לאימון המודלים שלנו, ואפשר למחוק את הנתונים שלך בכל עת. הנתונים שמועלים ל-Assistants API נשמרים ללא הגבלת זמן, עד שמשתמש מוחק אותם ידנית.
האם DALL-E זמין דרך Assistants API?
בשלב זה, DALL-E אינו זמין.
האם יש ממשק משתמש ל-Assistants API?
אפשר להתנסות ב-Playground של Assistants API. יש לוודא שנבחרה תצוגת עוזרים בסרגל הצד השמאלי, ושהמודל שבשימוש תואם לכלים שברצונך להפעיל.
מהי מגבלת התווים להוראות העוזר ב-Assistants API?
האורך המרבי של שדה הוראות העוזר הוא 256,000 תווים.
מופיעה לי שגיאה כמו ״אירעה שגיאה בשרת בעת עיבוד הבקשה שלך. מצטערים על כך! אפשר לנסות לשלוח את הבקשה שוב, או לפנות אלינו דרך מרכז העזרה בכתובת help.openai.com אם השגיאה נמשכת. ״ מה לעשות?
אם השגיאה הזו מופיעה, ייתכן שהפרומפט שלך לא מוגדר כראוי. אם גם ניסיונות חוזרים לשלוח את הבקשה נכשלים, הנה כמה דברים שאפשר לנסות:
לשנות את מבנה הפרומפט כך שפקודות דמויות פונקציה יוגדרו כפונקציות
להוסיף כל פקודה בפרומפט כפונקציה ל-tools
למה כלי החיפוש בקבצים שלי לא עובד היטב?
בעת שימוש בכלי החיפוש בקבצים, מומלץ להגדיר את max_prompt_tokens לערך של 20,000 לפחות. לשיחות ארוכות יותר או לשימושים חוזרים בחיפוש בקבצים, כדאי להגדיל את המגבלה ל-50,000. לקבלת התוצאות האיכותיות ביותר, עדיף להסיר לגמרי את מגבלות max_prompt_tokens. מידע נוסף זמין כאן.
איך אפשר לשלוח משוב?
נשמח לקבל ממך משוב בפורום המפתחים שלנו, דרך מרכז העזרה בכתובת help.openai.com, או בטוויטר @OpenAIDevs.